Մեր առօրյա կյանքում մենք պետք է գործ ունենանք Microsoft Word (DOC/DOCX) փաստաթղթերի հետ ինչպես անձնական, այնպես էլ պաշտոնական նպատակներով: Նմանապես, մենք կարող ենք պահանջ ունենալ այս փաստաթղթերը համօգտագործել ինտերնետով, և այդ փաստաթղթերը բացելու/դիտելու համար ստացողին անհրաժեշտ են որոշակի հավելվածներ, օրինակ՝ MS Word, OpenOffice և այլն: Ավելին, որոշ սահմանափակող միջավայրեր կարող են չունենալ որևէ լրացուցիչ տեղադրման թույլտվություն: հավելվածներ, ուստի նման սցենարներում Word-ի HTML-ի փոխակերպումը կարող է կենսունակ լուծում լինել: Այս մոտեցմամբ մենք կարող ենք հեշտությամբ բացել Word փաստաթուղթը վեբ բրաուզերում (առանց որևէ լրացուցիչ ծրագրաշարի տեղադրման): Այսպիսով, այս հոդվածը պատրաստվում է բացատրել այն քայլերը, թե ինչպես փոխարկել Word-ը HTML-ի, օգտագործելով Java Cloud SDK:
- Word-ի HTML փոխակերպում REST API
- Փոխարկել Word-ը HTML-ի Java-ում
- DOCX-ից դեպի HTML՝ օգտագործելով cURL հրամանները
Word-ի HTML փոխակերպում REST API
Aspose.Words Cloud-ը REST-ի վրա հիմնված լուծում է, որն առաջարկում է MS Word փաստաթղթերը ծրագրային ձևով ստեղծելու, խմբագրելու և փոխակերպելու [աջակցվող ձևաչափերի] տարբեր 6: Այժմ, ըստ այս հոդվածի շրջանակի, մենք պատրաստվում ենք օգտագործել Aspose.Words Cloud SDK for Java, որը մեզ հնարավորություն է տալիս օգտագործել Word փաստաթղթի փոխակերպման բոլոր հնարավորությունները Java հավելվածում: Այսպիսով, այս SDK-ն օգտագործելու համար մենք պետք է ավելացնենք դրա հղումը մեր Java նախագծում՝ ներառելով հետևյալ տեղեկատվությունը pom.xml-ում (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>
Հաջորդ կարևոր քայլը ձեր հաճախորդի հավատարմագրերը ստանալն է Cloud Dashboard-ից: Եթե դուք արդեն գրանցված չեք, նախ պետք է գրանցեք անվճար հաշիվ վավեր էլ. հասցեի միջոցով, այնուհետև ստանաք ձեր հավատարմագրերը:
Փոխարկել Word-ը HTML-ի Java-ում
Մենք պատրաստվում ենք քննարկել քայլերը և դրանց առնչվող մանրամասները, թե ինչպես փոխարկել Word-ը HTML՝ օգտագործելով Java կոդի հատվածը:
- Ստեղծեք WordsApi օբյեկտ, որտեղ մենք փոխանցում ենք անհատականացված հավատարմագրերը որպես փաստարկներ
- Այժմ բեռնեք մուտքագրված Word փաստաթղթի բովանդակությունը՝ օգտագործելով readAllBytes(…) մեթոդը և ստացեք վերադարձված արժեքը բայթ[] զանգվածում։
- Հաջորդ քայլը ConvertDocumentRequest դասի օբյեկտի ստեղծումն է, որն ընդունում է մուտքագրված Word ֆայլը, HTML ձևաչափը և արդյունքում ֆայլի անունը որպես արգումենտ:
- Վերջապես, կանչեք convertDocument(…) մեթոդը՝ Word-ի HTML փոխակերպումը կատարելու համար: Հաջող փոխակերպումից հետո ստացված HTML փաստաթուղթը պահվում է ամպային պահեստում
// Կոդի լրացուցիչ հատվածների համար խնդրում ենք https://github.com/aspose-words-cloud/aspose-words-cloud-java
try
{
String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
// եթե baseUrl-ը զրոյական է, WordsApi-ն օգտագործում է լռելյայն https://api.aspose.cloud
WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
// բեռնել word փաստաթուղթը տեղական համակարգից
File file1 = new File("test_multi_pages.docx");
// կարդալ մուտքագրված word փաստաթղթի բովանդակությունը
byte[] documentStream = Files.readAllBytes(file1.toPath());
// արդյունքում ստացված ֆայլի ձևաչափը
String format = "html";
// ստեղծել Փաստաթղթի փոխակերպման հարցում, որտեղ մենք տրամադրում ենք արդյունքի ֆայլի անունը
ConvertDocumentRequest convertRequest = new ConvertDocumentRequest(documentStream,format, "output.html",null, null, null);
// կատարել բառից html փոխակերպում
wordsApi.convertDocument(convertRequest);
}catch(Exception ex)
{
System.out.println(ex);
}
Վերոհիշյալ օրինակում օգտագործված Word փաստաթղթի նմուշը կարելի է ներբեռնել testmultipages.docx-ից:
DOCX-ից դեպի HTML՝ օգտագործելով cURL հրամանները
REST API-ներն ապահովում են ցանկացած հարթակի վրա cURL հրամանների միջոցով մուտքի հեշտություն: Այսպիսով, այս բաժնում մենք պատրաստվում ենք քննարկել մանրամասները, թե ինչպես փոխարկել DOCX-ը HTML-ի՝ օգտագործելով cURL հրամանները: Այսպիսով, առաջին քայլը JWT մուտքի նշանի ստեղծումն է (հիմնված հաճախորդի հավատարմագրերի վրա)՝ օգտագործելով հետևյալ հրամանը:
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"
Այժմ մենք պետք է կատարենք հետևյալ հրամանը՝ Word-ի HTML փոխակերպումը կատարելու համար, որտեղ ակնկալվում է, որ մուտքագրված Word փաստաթուղթը հասանելի կլինի ամպային պահեստում, և փոխարկումից հետո մենք պատրաստվում ենք պահպանել ստացված HTML փաստաթուղթը տեղական սկավառակում:
curl -v -X GET "https://api.aspose.cloud/v4.0/words/test_multi_pages.docx?format=html" \
-H "accept: application/octet-stream" \
-H "Authorization: Bearer <JWT Token>" \
-o "newOutput.html"
Մենք կարող ենք նաև պահպանել ստացված ֆայլը անմիջապես ամպային պահեստում, և այդ պատճառով մենք պարզապես պետք է արժեք տրամադրենք outPath պարամետրի համար (ինչպես ցույց է տրված ստորև):
curl -v -X GET "https://api.aspose.cloud/v4.0/words/test_multi_pages.docx?format=html&outPath=output.html" \
-H "accept: application/octet-stream" \
-H "Authorization: Bearer <JWT Token>"
Եզրակացություն
Այժմ, երբ մենք հասել ենք այս հոդվածի ավարտին, մենք իմացանք մանրամասները, թե ինչպես ծրագրավորել Word-ը HTML-ի վերածել Java-ի միջոցով: Մենք նաև տեսել ենք cURL հրամանների միջոցով DOCX-ը HTML-ի փոխակերպելու տարբերակները։ Արագ փորձարկման նպատակով դուք կարող եք նաև փորձել մուտք գործել API SwaggerUI-ի միջոցով վեբ բրաուզերի միջոցով և միևնույն ժամանակ կարող եք դիտարկել Product Documentation-ը, որը տեղեկատվության զարմանալի աղբյուր է:
Եթե Ձեզ անհրաժեշտ է ներբեռնել և փոփոխել Cloud SDK-ի սկզբնական կոդը, այն անվճար հասանելի է GitHub-ում (հրատարակված է MIT լիցենզիայի ներքո): Ի վերջո, եթե API-ն օգտագործելիս որևէ խնդրի բախվեք կամ որևէ առնչվող հարցում ունեք, կարող եք մտածել մեզ մոտենալու արագ լուծման համար անվճար ապրանքի աջակցման ֆորումի միջոցով:
Առնչվող հոդվածներ
Խնդրում ենք այցելել հետևյալ հղումները՝ ավելին իմանալու համար.