Hüperteksti märgistuskeel (HTML) on veebilehtede loomise standardne märgistuskeel. See võimaldab luua ja struktureerida jaotisi, lõike ja linke, kasutades HTML-i elemente/silte. Ja juhul, kui HTML-failis kasutatakse mõnda kohandatud fonti või viidatakse mõnele dünaamilisele objektile, mis nõuab aktiivset ühendust lähtemasina/serveriga, on tõenäoline, et dokumendi täpsus on ohus. Teisest küljest on XML-paberi spetsifikatsioonis (XPS) leheelemendid määratletud konkreetsest operatsioonisüsteemist, printerist või vaatamisrakendusest sõltumatult. Nii et intelligentne lähenemine on teisendada HTML XPS-vormingusse.
HTML-i teisendamise API
Aspose.HTML Cloud SDK for Java on kerge REST-arhitektuuril põhinev API, mis võimaldab luua, töödelda ja teisendada HTML-faile PDF, DOCX, TIFF, JPEG jne. See toetab ka HTML-i teisendamist XPS-iks. Seega peame esmalt lisama Maven build-tüüpi projekti faili pom.xml järgmised üksikasjad, et lisada SDK meie Java projekti.
<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-html-cloud</artifactId>
<version>20.7.0</version>
<scope>compile</scope>
</dependency>
</dependencies>
Pärast installimist on järgmine samm meie pilveteenuste tasuta tellimus Aspose.Cloud dashboard kaudu, kasutades GitHubi või Google’i kontot. Või lihtsalt looge uus konto ja hankige oma kliendi mandaadi üksikasjad.
Teisendage HTML Java-s XPS-iks
HTML-i XPS-i konverteri väljatöötamiseks järgige alltoodud juhiseid.
- Kõigepealt peame täpsustama üksikasjad meetodite Configuration.setAPPSID ja Configuration.setAPIKEY suhtes
- Teiseks määrame setBasePath(..), setAuthPath(..) üksikasjad ja määrame setUserAgent(…) kui WebKit
- Kolmandaks määrame enda abiks setDebug(..) tõeseks
- Nüüd looge ConversionApi klassi objekt
- Määrake tulemuseks oleva faili veerise üksikasjad ja nimi
- Lõpuks kutsuge välja meetod GetConvertDocumentToXps(…), mis nõuab argumentidena HTML-i nime, mõõtmete ja veerise üksikasjade sisestamist
// rohkemate näidete saamiseks külastage aadressi https://github.com/aspose-html-cloud/aspose-html-cloud-java
try
{
// Hankige ClientID ja ClientSecret saidilt https://dashboard.aspose.cloud/
String clientId = "bbf94a2c-6d7e-4020-b4d2-b9809741374e";
String clientSecret = "1c9379bb7d701c26cc87e741a29987bb";
// Api kutsumise üksikasjad
com.aspose.html.Configuration.setAPP_SID(clientId);
com.aspose.html.Configuration.setAPI_KEY(clientSecret);
com.aspose.html.Configuration.setBasePath("https://api.aspose.cloud/v3.0");
com.aspose.html.Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
com.aspose.html.Configuration.setUserAgent("WebKit");
com.aspose.html.Configuration.setDebug(true);
// Looge Aspose.HTML Cloud API objekt
com.aspose.html.api.ConversionApi htmlApi = new ApiClient().createService(ConversionApi.class);
// html-dokument pilvesalvestusest
String name = "list.html";
// tulemuseks olev pildivorming
String outFormat = "PNG";
Integer width = 800; // Resulting image width.
Integer height = 1000; // Resulting image height.
Integer leftMargin = 10; // Left resulting image margin.
Integer rightMargin = 10; // Right resulting image margin.
Integer topMargin = 10; // Top resulting image margin.
Integer bottomMargin = 10; // Bottom resulting image margin.
Integer resolution = 300; // Resolution of resulting image.
String folder = null; // The folder in the storage. Should exist.
String storage = "Internal"; // Name of the storage. null
// Käivitage API HTML-i teisendamiseks XPS-iks
retrofit2.Call<okhttp3.ResponseBody> call = htmlApi.GetConvertDocumentToXps(name, width, height, leftMargin, rightMargin, topMargin, bottomMargin, folder, storage);
System.out.println("HTML to XPS conversion sucessfull !");
}catch(Exception ex)
{
System.out.println(ex);
}
Ülaltoodud kood tagastab tulemuse vastusevoos, nii et väljundi salvestamiseks kohalikule draivile võiksime kaaluda järgmise kohandatud meetodi kasutamist.
/*
* Meetod, mis võtab argumentidena ResponseBody ja sellest tuleneva failinime
*/
public static void checkAndSave(retrofit2.Call<okhttp3.ResponseBody> call, String fileName) throws IOException
{
// Saatke päring sünkroonselt ja tagastage sellele vastus.
retrofit2.Response<okhttp3.ResponseBody> res = call.execute();
// Eduka vastuse deserialiseeritud vastuse keha
okhttp3.ResponseBody answer = res.body();
//Salvesta testkataloogi
boolean result = saveToDisc(answer, fileName);
// kinnitage, et tulemuse väärtus on tõene (valikuline samm)
Assert.assertTrue(result);
}
/*
*
* Helistage sellele meetodile, et salvestada vastuse sisu failina kohalikule draivile
*
*/
public static boolean saveToDisc(okhttp3.ResponseBody body, String fileName)
{
// luua failiobjekt, mis näitab tulemuseks oleva faili asukohta
File savedFile = new File("c:\\Downloads\\"+fileName);
try (InputStream inputStream = body.byteStream();
OutputStream outputStream = new FileOutputStream(savedFile))
{
byte[] fileReader = new byte[4096];
long fileSizeDownloaded = 0;
while (true) {
int read = inputStream.read(fileReader);
if (read == -1) break;
// salvestage failivoog kohalikule kettale
outputStream.write(fileReader, 0, read);
fileSizeDownloaded += read;
}
// tühjendage väljundvoo eksemplar
outputStream.flush();
// tagastada tõene failina, salvestamine õnnestus
return true;
} catch (Exception e) {
e.printStackTrace();
return false;
}
} // saveToDisc ends here
Ülaltoodud näites kasutatud näidisfaile saab alla laadida saidilt list.html ja resultantFile.xps.
HTML XPS-i kasutades cURL-i käske
REST API-dele pääseb juurde ka cURL-i käskude kaudu, nii et selles jaotises uurime samme, kuidas HTML-i XPS-i teisendada, kasutades käsku cURL. Eeltingimusena peame esmalt genereerima teie individuaalsete kliendimandaatide põhjal JSON-i veebimärgi (JWT). JWT-märgi genereerimiseks täitke järgmine käsk.
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=bbf94a2c-6d7e-4020-b4d2-b9809741374e&client_secret=1c9379bb7d701c26cc87e741a29987bb" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
Nüüd, kui meil on JWT-märk, täitke terminalis järgmine käsk HTML-i teisendamiseks XPS-iks.
curl -v -X GET "https://api.aspose.cloud/html/list.html/convert/xps" \
-H "accept: multipart/form-data" \
-H "authorization: Bearer <JWT Token>" \
-o final.xps
Järeldus
Selles artiklis on selgitatud üksikasju HTML-i teisendamiseks XPS-iks REST API abil. Oleme õppinud HTML-i teisendamiseks XPS-iks nii Java koodilõike kui ka cURL-i käske kasutades. Lisaks pange tähele, et toode dokumentatsioon on suurepärane allikas API pakutavate hämmastavate võimaluste õppimiseks. Lisaks, kui teil tekib API kasutamisel probleeme, võtke julgelt ühendust tasuta tootetoe foorumiga.
seotud artiklid
Soovitame külastada ka järgmisi ajaveebi, et saada lisateavet selle kohta: