Microsoft Word word wyd gebruik om Word-dokumente (DOC/DOCX) in verskeie formate te skep, te redigeer en te transformeer. Net so is Markdown ’n liggewig opmaaktaal wat jy kan gebruik om formateringselemente by gewone teksdokumente te voeg. Dit is ’n gewone teksdokument wat leesbaar sal wees sonder dat etikette alles opkikker, maar daar moet steeds maniere wees om tekswysigers soos lyste, vetdruk, kursief, ens. by te voeg. So as ons ’n Word-dokument het en ons moet ’n ekwivalente lêer skep in Markdown-sintaksis, word dit moeilik om dit met die hand te skep. Maar ’n programmatiese oplossing kan probleem oplos. Hierdie artikel gaan al die besonderhede verduidelik oor hoe om woord-na-afmerk-omskakelaar met behulp van Java Cloud SDK te ontwikkel.
Woord na Markdown Conversion API
Ons REST-gebaseerde API genaamd Aspose.Words Cloud is ’n wonderlike oplossing om MS Word-dokumentskepping, -manipulasie en -omskakelingsbewerkings na ’n verskeidenheid ondersteunde formate te implementeer. Om nou dieselfde dokumentomskakeling en verwerkingsvermoëns in Java-toepassing te implementeer, moet ons Aspose.Words Cloud SDK vir Java gebruik wat ’n omhulsel rondom REST API is. So in die eerste stap van SDK-gebruik, moet ons die verwysing daarvan in ons Java-projek byvoeg deur die volgende inligting in pom.xml (maven bou tipe projek) in te sluit.
<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>
Sodra die SDK-verwysing in die projek bygevoeg is, is die volgende belangrike stap om jou kliëntbewyse van Cloud Dashboard te verkry. Anders moet jy eers ’n gratis rekening registreer terwyl jy ’n geldige e-posadres gebruik.
Woord na MD in Java
Hierdie afdeling verduidelik die stappe en verwante besonderhede oor hoe ons Word na MD-formaat kan omskakel met behulp van Java-kodebrokkie. Ons gaan twee opsies gebruik om die invoer Word-dokument te laai, dws vorm Wolkberging of plaaslike skyf, en dit dan na Markdown-formaat omskep.
Laai Word-dokument vanaf plaaslike skyf
- Eerstens, skep ’n instansie van WordsApi en gee persoonlike geloofsbriewe as argumente
- Tweedens, lees die inhoud van die invoer Word-dokument deur Files.readAllBytes(…) metode en kry teruggestuurde waarde in ’n greep[] skikking
- Derdens, skep ’n objek van ConvertDocumentRequest wat insette Word-lêer, MD-formaat en gevolglike Markdown-lêer se naam as argumente neem
- Bel nou metode convertDocument(…) vir Word na MD-omskakeling. Die gevolglike Markdown word teruggestuur as reaksiestroom, om in byte[]-instansie gestoor te word
- Ten slotte, om die resulterende Markdown op plaaslike skyf te stoor, skep ’n objek van FileOutputStream en gebruik sy skryf(…) metode
// Vir meer kodebrokkies, https://github.com/aspose-words-cloud/aspose-words-cloud-java
try
{
String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
// as baseUrl nul is, gebruik WordsApi verstek https://api.aspose.cloud
WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
// laai word-dokument vanaf plaaslike stelsel
File file1 = new File("sample_EmbeddedOLE.docx");
// lees die inhoud van die invoerwoorddokument
byte[] documentStream = Files.readAllBytes(file1.toPath());
// gevolglike lêerformaat
String format = "md";
// skep dokumentomskakelingversoek waar ons die gevolglike lêernaam verskaf
ConvertDocumentRequest convertRequest = new ConvertDocumentRequest(documentStream,format, null,null, null, null);
// voer woord-na-markdown-omskakeling uit en stoor uitvoer in byte Array
byte[] resultantFile = wordsApi.convertDocument(convertRequest);
// Stoor die gevolglike afmerkdokumentasie op plaaslike skyf
FileOutputStream fos = new FileOutputStream("/Users/nayyer/Documents/" + "resultant.md");
fos.write(resultantFile);
fos.close();
}catch(Exception ex)
{
System.out.println(ex);
}
Jy kan oorweeg om die invoer Word-dokument af te laai vanaf sampleEmbeddedOLE.docx.
Laai Word-dokument vanaf Wolkberging
- Net so moet ons eers ’n instansie van WordsApi skep terwyl ons persoonlike geloofsbriewe as argumente deurgee
- Tweedens, skep ’n objek van GetDocumentWithFormatRequest wat insette Word-lêernaam, MD-formaat en gevolglike Markdown-lêer se naam as argumente neem
- Laastens, noem die metode getDocumentWithFormat(..) wat die Word to Markdown-omskakelingsoperasie aktiveer. Die resulterende MD-lêer word in wolkberging gestoor
// Vir meer kodebrokkies, https://github.com/aspose-words-cloud/aspose-words-cloud-java
try
{
String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
// as baseUrl nul is, gebruik WordsApi verstek https://api.aspose.cloud
WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
String format = "md";
// skep nou 'n nuwe voorwerp van GetDocumentWithFormatRequest
GetDocumentWithFormatRequest convertRequest = new GetDocumentWithFormatRequest("sample_EmbeddedOLE.docx",format,null, null, null,null,null,"Converted.md",null);
// noem nou die metode om die omskakelingsoperasie te begin
// die resulterende lêer word in wolkberging gestoor
wordsApi.getDocumentWithFormat(convertRequest);
}catch(Exception ex)
{
System.out.println(ex);
}
DOC na Markdown met behulp van cURL-opdragte
Die REST API’s bied ook die buigsaamheid om vanaf enige platform met behulp van cURL-opdragte toeganklik te word. So in hierdie afdeling gaan ons die besonderhede bespreek oor hoe om Word-dokumentvorm Wolkberging te laai, DOCX na Markdown-omskakeling uit te voer en die resulterende MD-lêer op plaaslike skyf te stoor. Nou moet ons eers die JWT-toegangstoken genereer (gebaseer op kliëntgeloofsbriewe) deur die volgende opdrag te gebruik en dan DOCX na Markdown-omskakeling uit te voer.
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"
Sodra die JWT gegenereer is, voer asseblief die volgende opdrag uit om Word-dokument vanaf Wolkberging te laai en Word na Markdown-omskakeling uit te voer. Die resulterende MD-lêer word dan op plaaslike skyf gestoor
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"
Afsluiting
Ons het tot die einde van hierdie artikel gekom waar ons die besonderhede geleer het oor hoe ons Word programmaties na Markdown kan omskakel met Java. Net so het ons ook die stappe ondersoek vir die omskakeling van DOCX na Markdown via cURL-opdragte.
Nog ’n opsie om die vermoëns van API te verken, is deur SwaggerUI binne ’n webblaaier. Ons beveel ook aan dat u die Produkdokumentasie verken, wat ’n wonderlike bron van inligting is om meer oor ander opwindende kenmerke te leer. As jy die bronkode van Cloud SDK moet aflaai en wysig, is dit beskikbaar op GitHub (gepubliseer onder MIT-lisensie). Laastens, as jy enige probleme ondervind tydens die gebruik van die API, kan jy dit oorweeg om ons te nader vir ’n vinnige oplossing via gratis produkondersteuningsforum.
verwante artikels
Besoek asseblief die volgende skakels om meer te wete te kom oor: