Microsoft Wordi kasutatakse laialdaselt Wordi dokumentide (DOC/DOCX) loomiseks, redigeerimiseks ja teisendamiseks erinevatesse vormingutesse. Samamoodi on Markdown kerge märgistuskeel, mida saate kasutada lihtteksti dokumentidele vorminduselementide lisamiseks. See on lihtteksti dokument, mida saab lugeda ilma siltideta, kuid siiski peaks olema võimalusi lisada tekstimuutusi, nagu loendid, paksus kirjas, kaldkirjas jne. Nii et kui meil on Wordi dokument ja me peame looma samaväärse faili Markdowni süntaksis on selle käsitsi loomine keeruline. Programmiline lahendus võib aga probleemi lahendada. See artikkel selgitab kõiki üksikasju selle kohta, kuidas Java Cloud SDK abil sõna-allahindluse konverterit arendada.
Word to Markdown Conversion API
Meie REST-põhine API nimega Aspose.Words Cloud on suurepärane lahendus MS Wordi dokumentide loomiseks, töötlemiseks ja teisendamiseks erinevatesse toetatud vormingutesse. Nüüd peame Java-rakenduses samade dokumentide teisendamise ja töötlemise võimaluste rakendamiseks kasutama Aspose.Words Cloud SDK for Java, mis on REST API ümber. Seega peame SDK kasutamise esimeses etapis lisama selle viite meie Java projekti, lisades faili pom.xml (maven build type project) järgmise teabe.
<repositories>
<repository>
<id>aspose-cloud</id>
<name>artifact.aspose-cloud-releases</name>
<url>http://artifact.aspose.cloud/repo</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-words-cloud</artifactId>
<version>22.12.0</version>
</dependency>
</dependencies>
Kui SDK viide on projekti lisatud, on järgmine oluline samm hankida oma kliendi mandaadid saidilt Cloud Dashboard. Muul juhul peate esmalt registreerima tasuta konto, kasutades kehtivat e-posti aadressi.
Wordist MD-ks Javas
See jaotis selgitab samme ja nendega seotud üksikasju selle kohta, kuidas saame Java koodilõigu abil Wordi MD-vormingusse teisendada. Kasutame Wordi sisenddokumendi laadimiseks kahte võimalust, st pilvmälu või kohaliku draivi vormindamiseks ja seejärel teisendame selle Markdowni vormingusse.
Laadige Wordi dokument kohalikult draivilt
- Kõigepealt looge WordsApi eksemplar ja edastage argumentidena isikupärastatud mandaadid
- Teiseks lugege Wordi sisenddokumendi sisu, kasutades meetodit Files.readAllBytes(…) ja hankige tagastatud väärtus bait[] massiivina
- Kolmandaks looge ConvertDocumentRequesti objekt, mis võtab argumentidena sisendfaili Wordi faili, MD-vormingu ja tulemuseks oleva Markdown-faili nime
- Nüüd kutsuge Wordi MD-ks teisendamiseks meetod convertDocument(…). Saadud Markdown tagastatakse vastusevoona, mis salvestatakse byte[] eksemplari
- Lõpuks, et salvestada saadud Markdown kohalikku draivi, looge FileOutputStreami objekt ja kasutage selle kirjutamismeetodit (…)
// Rohkem koodilõike leiate aadressilt https://github.com/aspose-words-cloud/aspose-words-cloud-java
try
{
String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
// kui baseUrl on null, kasutab WordsApi vaikeväärtust https://api.aspose.cloud
WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
// laadige Wordi dokument kohalikust süsteemist
File file1 = new File("sample_EmbeddedOLE.docx");
// lugege sisendsõna dokumendi sisu
byte[] documentStream = Files.readAllBytes(file1.toPath());
// tulemuseks olev failivorming
String format = "md";
// luua dokumendi teisendustaotlus, kus anname tulemuseks oleva faili nime
ConvertDocumentRequest convertRequest = new ConvertDocumentRequest(documentStream,format, null,null, null, null);
// teisendada sõna allahindluseks ja salvestada väljund baidimassiivi
byte[] resultantFile = wordsApi.convertDocument(convertRequest);
// Salvestage saadud allahindluse dokumentatsioon kohalikule kettale
FileOutputStream fos = new FileOutputStream("/Users/nayyer/Documents/" + "resultant.md");
fos.write(resultantFile);
fos.close();
}catch(Exception ex)
{
System.out.println(ex);
}
Võite kaaluda Wordi sisenddokumendi allalaadimist saidilt sampleEmbeddedOLE.docx.
Laadige Wordi dokument pilvmälust
- Samamoodi peame esmalt looma WordsApi eksemplari, edastades samal ajal isikupärastatud mandaadid argumentidena
- Teiseks looge GetDocumentWithFormatRequesti objekt, mis võtab argumentidena Wordi faili nime, MD-vormingu ja sellest tuleneva Markdowni faili nime
- Lõpuks kutsuge välja meetod getDocumentWithFormat(..), mis käivitab Wordi Markdowni teisendustoimingu. Saadud MD-fail salvestatakse pilvmällu
// Rohkem koodilõike leiate aadressilt https://github.com/aspose-words-cloud/aspose-words-cloud-java
try
{
String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
// kui baseUrl on null, kasutab WordsApi vaikeväärtust https://api.aspose.cloud
WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
String format = "md";
// looge nüüd GetDocumentWithFormatRequesti uus objekt
GetDocumentWithFormatRequest convertRequest = new GetDocumentWithFormatRequest("sample_EmbeddedOLE.docx",format,null, null, null,null,null,"Converted.md",null);
// kutsuge nüüd välja teisendustoimingu algatamise meetod
// saadud fail salvestatakse pilvesalvestusse
wordsApi.getDocumentWithFormat(convertRequest);
}catch(Exception ex)
{
System.out.println(ex);
}
DOC märgistusse, kasutades cURL-i käske
REST API-d pakuvad ka paindlikkust juurdepääsuks mis tahes platvormilt cURL-käskude abil. Nii et selles jaotises käsitleme üksikasju selle kohta, kuidas laadida Wordi dokumenti pilvmälust, teha DOCX-i teisendamine Markdowniks ja salvestada saadud MD-fail kohalikule draivile. Nüüd peame esmalt genereerima JWT juurdepääsuluba (põhineb kliendi mandaatidel), kasutades järgmist käsku ja seejärel teostama DOCX-i Markdowni teisenduse.
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=bb959721-5780-4be6-be35-ff5c3a6aa4a2&client_secret=4d84d5f6584160cbd91dba1fe145db14" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
Kui JWT on loodud, täitke järgmine käsk, et laadida Wordi dokument pilvmälust ja teostada Wordi teisendamine Markdowniks. Saadud MD-fail salvestatakse seejärel kohalikule draivile
curl -v -X GET "https://api.aspose.cloud/v4.0/words/sample_EmbeddedOLE.docx?format=md" \
-H "accept: application/octet-stream" \
-H "Authorization: Bearer <JWT Token>" \
-o "newOutput.md"
Järeldus
Oleme jõudnud selle artikli lõpuni, kus oleme õppinud üksikasju selle kohta, kuidas saame Wordi programmiliselt Java abil Markdowniks teisendada. Samuti oleme uurinud samme DOCX-i teisendamiseks Markdowniks cURL-i käskude kaudu.
Teine võimalus API võimaluste uurimiseks on veebibrauseris SwaggerUI. Soovitame uurida ka tootedokumentatsiooni, mis on suurepärane teabeallikas muude põnevate funktsioonide kohta. Kui teil on vaja Cloud SDK lähtekoodi alla laadida ja seda muuta, on see saadaval saidil GitHub (avaldatud MIT-litsentsi alusel). Lõpuks, kui teil tekib API kasutamisel probleeme, võite meie poole pöörduda kiire lahenduse leidmiseks tasuta tootetoe foorumi kaudu.
seotud artiklid
Lisateabe saamiseks külastage järgmisi linke: