Microsoft Word se široko uporablja za ustvarjanje, urejanje in preoblikovanje Wordovih dokumentov (DOC/DOCX) v različne formate. Podobno je Markdown lahek označevalni jezik, ki ga lahko uporabite za dodajanje elementov oblikovanja dokumentom z navadnim besedilom. To je dokument z navadnim besedilom, ki ga je mogoče brati brez oznak, ki motijo vse, vendar bi morali še vedno obstajati načini za dodajanje modifikatorjev besedila, kot so seznami, krepko, ležeče itd. Torej, če imamo Wordov dokument in moramo ustvariti enakovredno datoteko v sintaksi Markdown ga je težko ustvariti ročno. Vendar lahko programska rešitev reši problem. Ta članek bo razložil vse podrobnosti o tem, kako razviti pretvornik besed v markdown z uporabo Java Cloud SDK.
API za pretvorbo Word v Markdown
Naš API, ki temelji na REST z imenom Aspose.Words Cloud, je neverjetna rešitev za izvajanje operacij ustvarjanja dokumentov MS Word, manipulacije in pretvorbe v različne podprte formate. Za implementacijo enakih zmožnosti pretvorbe in obdelave dokumentov v aplikaciji Java moramo uporabiti Aspose.Words Cloud SDK for Java, ki je ovoj okrog API-ja REST. V prvem koraku uporabe SDK-ja moramo torej dodati njegovo referenco v naš projekt Java, tako da vključimo naslednje informacije v pom.xml (projekt vrste gradnje maven).
<repositories>
<repository>
<id>aspose-cloud</id>
<name>artifact.aspose-cloud-releases</name>
<url>https://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>
Ko je referenca SDK dodana v projekt, je naslednji pomemben korak pridobitev poverilnic odjemalca iz Cloud Dashboard. V nasprotnem primeru morate najprej registrirati brezplačen račun, medtem ko uporabljate veljaven e-poštni naslov.
Beseda zdravniku v Javi
V tem razdelku so razloženi koraki in povezane podrobnosti o tem, kako lahko pretvorimo Word v format MD z uporabo odrezka kode Java. Uporabili bomo dve možnosti za nalaganje vhodnega Wordovega dokumenta, tj. iz shrambe v oblaku ali lokalnega diska, nato pa ga pretvorili v format Markdown.
Naloži Wordov dokument z lokalnega pogona
- Najprej ustvarite primerek WordsApi in kot argumente posredujte prilagojene poverilnice
- Drugič, preberite vsebino vhodnega Wordovega dokumenta z uporabo metode Files.readAllBytes(…) in pridobite vrnjeno vrednost v nizu byte[]
- Tretjič, ustvarite objekt ConvertDocumentRequest, ki kot argumente sprejme vhodno Wordovo datoteko, format MD in posledično ime datoteke Markdown
- Zdaj pokličite metodo convertDocument(…) za pretvorbo Worda v MD. Nastali Markdown se vrne kot odzivni tok, ki se shrani v primerek byte[].
- Končno, če želite shraniti rezultat Markdown na lokalni pogon, ustvarite objekt FileOutputStream in uporabite njegovo metodo write(…)
// Za več izrezkov kode prosim https://github.com/aspose-words-cloud/aspose-words-cloud-java
try
{
String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
// če je baseUrl enak nič, WordsApi uporablja privzeto https://api.aspose.cloud
WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
// naloži wordov dokument iz lokalnega sistema
File file1 = new File("sample_EmbeddedOLE.docx");
// branje vsebine vhodnega wordovega dokumenta
byte[] documentStream = Files.readAllBytes(file1.toPath());
// nastala oblika datoteke
String format = "md";
// ustvarite zahtevo za pretvorbo dokumenta, kjer zagotovimo ime datoteke
ConvertDocumentRequest convertRequest = new ConvertDocumentRequest(documentStream,format, null,null, null, null);
// izvedite pretvorbo besede v markdown in shranite izhod v nizu bajtov
byte[] resultantFile = wordsApi.convertDocument(convertRequest);
// Shranite nastalo dokumentacijo o znižanju na lokalni disk
FileOutputStream fos = new FileOutputStream("/Users/nayyer/Documents/" + "resultant.md");
fos.write(resultantFile);
fos.close();
}catch(Exception ex)
{
System.out.println(ex);
}
Razmislite o prenosu vhodnega Wordovega dokumenta iz sampleEmbeddedOLE.docx.
Naloži Wordov dokument iz shrambe v oblaku
- Podobno moramo najprej ustvariti primerek WordsApi, medtem ko kot argumente posredujemo prilagojene poverilnice
- Drugič, ustvarite objekt GetDocumentWithFormatRequest, ki sprejme vhodno ime Wordove datoteke, format MD in posledično ime datoteke Markdown kot argumente
- Na koncu pokličite metodo getDocumentWithFormat(..), ki sproži operacijo pretvorbe Word v Markdown. Nastala datoteka MD se shrani v shrambo v oblaku
// Za več izrezkov kode prosim https://github.com/aspose-words-cloud/aspose-words-cloud-java
try
{
String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
// če je baseUrl enak nič, WordsApi uporablja privzeto https://api.aspose.cloud
WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
String format = "md";
// zdaj ustvarite nov objekt GetDocumentWithFormatRequest
GetDocumentWithFormatRequest convertRequest = new GetDocumentWithFormatRequest("sample_EmbeddedOLE.docx",format,null, null, null,null,null,"Converted.md",null);
// zdaj pokličite metodo za začetek operacije pretvorbe
// nastala datoteka se shrani v shrambo v oblaku
wordsApi.getDocumentWithFormat(convertRequest);
}catch(Exception ex)
{
System.out.println(ex);
}
DOC v Markdown z ukazi cURL
API-ji REST prav tako zagotavljajo prilagodljivost za dostop s katere koli platforme s pomočjo ukazov cURL. Zato bomo v tem razdelku razpravljali o podrobnostih o tem, kako naložiti Wordov dokument iz shrambe v oblaku, izvesti pretvorbo DOCX v Markdown in shraniti nastalo datoteko MD na lokalni pogon. Zdaj moramo najprej ustvariti žeton dostopa JWT (na podlagi poverilnic odjemalca) z naslednjim ukazom in nato izvesti pretvorbo DOCX v Markdown.
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"
Ko je JWT ustvarjen, izvedite naslednji ukaz za nalaganje Wordovega dokumenta iz shrambe v oblaku in izvedbo pretvorbe Worda v Markdown. Nastala datoteka MD se nato shrani na lokalni disk
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"
Zaključek
Prišli smo do konca tega članka, kjer smo izvedeli podrobnosti o tem, kako lahko programsko pretvorimo Word v Markdown z uporabo Jave. Podobno smo raziskali tudi korake za pretvorbo DOCX v Markdown prek ukazov cURL.
Druga možnost za raziskovanje zmogljivosti API-ja je prek SwaggerUI v spletnem brskalniku. Priporočamo tudi, da raziščete Dokumentacijo izdelka, ki je odličen vir informacij, če želite izvedeti več o drugih vznemirljivih funkcijah. Če morate prenesti in spremeniti izvorno kodo Cloud SDK, je na voljo na GitHub (objavljeno pod licenco MIT). Nazadnje, če med uporabo API-ja naletite na težave, se obrnite na nas za hitro rešitev prek brezplačnega foruma za podporo izdelkom.
povezani članki
Obiščite naslednje povezave, če želite izvedeti več o: