Muunna Word Markdowniksi Javassa
Microsoft Wordia käytetään laajasti Word-asiakirjojen (DOC/DOCX) luomiseen, muokkaamiseen ja muuntamiseen eri muotoihin. Vastaavasti Markdown on kevyt merkintäkieli, jota voit käyttää muotoiluelementtien lisäämiseen pelkkää tekstiä koskeviin asiakirjoihin. Se on pelkkä tekstidokumentti, jonka tulee olla luettavissa ilman tageja, jotka sekoittavat kaiken, mutta silti pitäisi olla tapoja lisätä tekstin muokkaajia, kuten luetteloita, lihavointia, kursiivia jne. Joten jos meillä on Word-asiakirja ja meidän on luotava vastaava tiedosto Markdown-syntaksissa sen luominen manuaalisesti on vaikeaa. Ohjelmallinen ratkaisu voi kuitenkin ratkaista ongelman. Tässä artikkelissa selitetään kaikki yksityiskohdat Word to markdown -muuntimen kehittämisestä Java Cloud SDK:n avulla.
Word to Markdown Conversion API
REST-pohjainen sovellusliittymämme nimeltä Aspose.Words Cloud on hämmästyttävä ratkaisu toteuttaa MS Word -asiakirjojen luonti-, käsittely- ja muunnostoimintoja useisiin tuettuihin muotoihin. Nyt, jotta voimme toteuttaa samat asiakirjan muunnos- ja käsittelyominaisuudet Java-sovelluksessa, meidän on käytettävä Aspose.Words Cloud SDK for Java -sovellusta, joka on REST API:n kääre. Joten SDK:n käytön ensimmäisessä vaiheessa meidän on lisättävä sen viite Java-projektiimme sisällyttämällä seuraavat tiedot pom.xml-tiedostoon (maven build type project).
<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>
Kun SDK-viite on lisätty projektiin, seuraava tärkeä vaihe on hankkia asiakastunnistetiedot Cloud Dashboardista. Muussa tapauksessa sinun on ensin rekisteröitävä ilmainen tili käyttämällä voimassa olevaa sähköpostiosoitetta.
Wordista MD:hen Javassa
Tässä osiossa selitetään vaiheet ja niihin liittyvät yksityiskohdat, kuinka voimme muuntaa Wordin MD-muotoon Java-koodinpätkän avulla. Aiomme käyttää kahta vaihtoehtoa syötettävän Word-asiakirjan lataamiseen eli muodostamaan pilvitallennustilaa tai paikallista asemaa ja muuttamaan sen sitten Markdown-muotoon.
Lataa Word-asiakirja paikalliselta asemalta
- Luo ensin WordsApi-esiintymä ja välitä personoidut tunnistetiedot argumenteiksi
- Toiseksi lue syötetyn Word-asiakirjan sisältö Files.readAllBytes(…) -menetelmällä ja saat palautetun arvon tavu[]-taulukossa
- Kolmanneksi, luo ConvertDocumentRequest-objekti, joka ottaa argumentteina syötetyn Word-tiedoston, MD-muodon ja tuloksena olevan Markdown-tiedoston nimen
- Kutsu nyt menetelmä convertDocument(…) Wordin MD-muunnokselle. Tuloksena oleva Markdown palautetaan vastausvirtana, joka tallennetaan tavu[]-instanssiin
- Lopuksi, tallentaaksesi tuloksena olevan Markdownin paikalliselle asemalle, luo FileOutputStream-objekti ja käytä sen kirjoitusmenetelmää (…)
// Lisää koodinpätkiä saat osoitteesta https://github.com/aspose-words-cloud/aspose-words-cloud-java
try
{
String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
// jos baseUrl on tyhjä, WordsApi käyttää oletusosoitetta https://api.aspose.cloud
WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
// lataa Word-asiakirja paikallisesta järjestelmästä
File file1 = new File("sample_EmbeddedOLE.docx");
// lukea syöttö Word-asiakirjan sisältöä
byte[] documentStream = Files.readAllBytes(file1.toPath());
// tuloksena oleva tiedostomuoto
String format = "md";
// Luo asiakirjan muunnospyyntö, jossa annamme tuloksena olevan tiedostonimen
ConvertDocumentRequest convertRequest = new ConvertDocumentRequest(documentStream,format, null,null, null, null);
// suorita muunnos sanasta markdowniksi ja tallenna tulos tavutaulukkoon
byte[] resultantFile = wordsApi.convertDocument(convertRequest);
// Tallenna tuloksena saatu merkintädokumentaatio paikalliselle asemalle
FileOutputStream fos = new FileOutputStream("/Users/nayyer/Documents/" + "resultant.md");
fos.write(resultantFile);
fos.close();
}catch(Exception ex)
{
System.out.println(ex);
}
Kuva: - Word to Markdown -muunnosesikatselu
Voit ladata syötetyn Word-asiakirjan osoitteesta sampleEmbeddedOLE.docx.
Lataa Word-asiakirja Cloud Storagesta
- Samoin meidän on ensin luotava WordsApi-esiintymä ja välitettävä henkilökohtaisia valtuustietoja argumentteina
- Toiseksi luo GetDocumentWithFormatRequest-objekti, joka ottaa argumentteina syötetyn Word-tiedoston nimen, MD-muodon ja tuloksena olevan Markdown-tiedoston nimen.
- Kutsu lopuksi menetelmä getDocumentWithFormat(..), joka käynnistää Wordin Markdown-muunnostoiminnon. Tuloksena oleva MD-tiedosto tallennetaan pilvitallennustilaan
// Lisää koodinpätkiä saat osoitteesta https://github.com/aspose-words-cloud/aspose-words-cloud-java
try
{
String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
// jos baseUrl on tyhjä, WordsApi käyttää oletusosoitetta https://api.aspose.cloud
WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
String format = "md";
// luo nyt uusi GetDocumentWithFormatRequest-objekti
GetDocumentWithFormatRequest convertRequest = new GetDocumentWithFormatRequest("sample_EmbeddedOLE.docx",format,null, null, null,null,null,"Converted.md",null);
// kutsu nyt menetelmää muunnostoiminnon aloittamiseksi
// tuloksena oleva tiedosto tallennetaan pilvitallennustilaan
wordsApi.getDocumentWithFormat(convertRequest);
}catch(Exception ex)
{
System.out.println(ex);
}
DOC Markdowniin cURL-komentojen avulla
REST-sovellusliittymät tarjoavat myös joustavuutta, jotta niitä voidaan käyttää mistä tahansa alustasta cURL-komentojen avulla. Joten tässä osiossa aiomme keskustella yksityiskohdista Word-asiakirjan lataamisesta pilvivarastosta, DOCX-muunnoksen suorittamisesta Markdowniksi ja tuloksena olevan MD-tiedoston tallentamisesta paikalliselle asemalle. Nyt meidän on ensin luotava JWT-käyttöoikeustunnus (perustuen asiakkaan tunnistetietoihin) käyttämällä seuraavaa komentoa ja suoritettava sitten DOCX:stä Markdown-muunnos.
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"
Kun JWT on luotu, suorita seuraava komento ladataksesi Word-asiakirjan pilvitallennustilasta ja suorittaaksesi Wordin muunnos Markdowniksi. Tuloksena oleva MD-tiedosto tallennetaan sitten paikalliselle asemalle
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"
Johtopäätös
Olemme saavuttaneet tämän artikkelin loppuun, jossa olemme oppineet yksityiskohtia siitä, kuinka voimme ohjelmallisesti muuntaa Wordin Markdowniksi Javaa käyttämällä. Samoin olemme myös tutkineet vaiheita DOCX:n muuntamiseksi Markdowniksi cURL-komentojen avulla.
Toinen vaihtoehto API:n ominaisuuksien tutkimiseen on SwaggerUI verkkoselaimessa. Suosittelemme myös tutustumaan Tuotedokumentaatioon, joka on hämmästyttävä tietolähde muiden jännittävien ominaisuuksien oppimiseen. Jos sinun täytyy ladata ja muokata Cloud SDK:n lähdekoodia, se on saatavilla GitHubista (julkaistu MIT-lisenssillä). Lopuksi, jos kohtaat ongelmia API:n käytössä, voit harkita ottamista meihin nopean ratkaisun saamiseksi ilmaisen tuotetukifoorumin kautta.
Aiheeseen liittyvät artikkelit
Saat lisätietoja seuraavista linkeistä: