XHTML in PDF konvertieren – Cloud SDK und REST API

XHTML zu PDF

XHTML ist eine Auszeichnungssprache, die die Syntax von HTML mit der Strenge von XML kombiniert und so wohlgeformte und strukturierte Webdokumente ermöglicht. Die Konvertierung von XHTML in PDF bietet viele Vorteile, insbesondere die Beibehaltung von Layout, Stil und Struktur von Webinhalten in einem tragbaren und leicht verteilbaren Format. PDF-Dateien behalten die Integrität des ursprünglichen XHTML-Inhalts bei, einschließlich Textformatierung, Bildern und Hyperlinks, wodurch sie sich ideal für die Verteilung von Dokumenten über mehrere Plattformen und Geräte hinweg eignen. Darüber hinaus werden PDF-Dateien von verschiedenen Softwareanwendungen weitgehend unterstützt und können mit PDF-Lesesoftware problemlos angezeigt und gedruckt werden, sodass Benutzer universellen Zugriff auf Inhalte haben.

Aspose.HTML Cloud v4.0 bietet die einfachste API zum Konvertieren von XHTML-Dokumenten in das PDF-Format mit hoher Qualität, einfach und schnell.

Der Artikel erklärt in einer Reihe von Codebeispielen, wie man ein XHTML-Dokument mit dem Aspose.HTML Cloud SDK und der REST-API in PDF konvertiert. SDKs sind in PHP, C++, Python, C#, Ruby, Java, Android, Swift und Node.js verfügbar. Wir werden verschiedene Szenarien der XHTML-zu-PDF-Konvertierung betrachten:

Konvertieren einer lokalen XHTML-Datei in PDF und Speichern des Ergebnisses in Ihrem lokalen Dateisystem. In diesem Szenario werden wir sowohl Konvertierungen mit Standardkonvertierungsparametern als auch mit explizit angegebenen Parametern untersuchen.
Konvertieren von XHTML in PDF im Cloud-Speicher mit Standardkonvertierungsparametern.

Beispiele für die Konvertierung von XHTML in PDF

Ein weit verbreiteter Anwendungsfall für Aspose.HTML Cloud-Funktionen ist die Dateiverarbeitung und -konvertierung. Mit dem Cloud SDK können Sie ein XHTML-Dokument anhand seines Namens von einem Speicherort oder einer lokalen Datei auf Ihrem Laufwerk abrufen, es in ein bestimmtes Format konvertieren und im Speicher oder auf einem lokalen Laufwerk speichern. Die folgenden Codebeispiele veranschaulichen, wie XHTML für verschiedene Fälle mithilfe verfügbarer SDKs und der REST-API in PDF konvertiert wird.

Beispiel 1. Konvertieren Sie XHTML in PDF mit Standardkonvertierungsoptionen

Erwägen Sie die Konvertierung eines XHTML-Dokuments, das sich ursprünglich in einem lokalen Dateisystem befand, in das PDF-Format. Die resultierende Datei wird dann wieder im lokalen Dateisystem gespeichert. Die Konvertierung erfolgt mit Standardkonvertierungsoptionen.

Das folgende Beispiel zeigt die einfachste Möglichkeit, XHTML in PDF mit C# zu konvertieren. Sie können das C# SDK aus dem GitHub-Repository herunterladen.

1// Initialize SDK API
2var api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET").ConvertApi;
3
4// Convert XHTML to PDF
5var result = await api.ConvertAsync("test.xhtml", "test.pdf");

Java

Das folgende Beispiel zeigt, wie man XHTML in PDF mit Java konvertiert. Sie können das Java SDK aus dem GitHub-Repository herunterladen.

 1Configuration.setBasePath("https://api.aspose.cloud");
 2Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
 3
 4HtmlApi api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET");
 5
 6JobBuilder builder = new ConverterBuilder()
 7                .fromLocalFile("input.xhtml")
 8                .saveToLocal("output.pdf");
 9
10OperationResult result = api.convert(builder);

C++

Das folgende Beispiel zeigt, wie man mithilfe der C++-Sprache XHTML in PDF konvertiert. Lokales XHTML in PDF konvertiert und im lokalen Pfad gespeichert.

 1// Get current directory
 2std::string cur_dir(argv[0]);
 3int pos = cur_dir.find_last_of("/\\");
 4cur_dir = cur_dir.substr(0, pos + 1); // Include the last slash
 5std::wstring w_cur_dir(cur_dir.begin(), cur_dir.end());
 6
 7const utility::string_t clientId = L"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX";
 8const utility::string_t clientSecret = L"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
 9const utility::string_t basePath = L"https://api.aspose.cloud/v4.0";
10const utility::string_t authPath = L"https://api.aspose.cloud/connect/token";
11
12// Create configuration for authorization
13std::shared_ptr<ApiConfiguration> apiConfig(new ApiConfiguration(clientId, clientSecret, basePath, authPath));
14
15// Create client from configuration
16std::shared_ptr<ApiClient> apiClient(new ApiClient(apiConfig));
17
18// Create ConversionApi
19std::shared_ptr<ConversionApi> api = std::make_shared<ConversionApi>(apiClient);
20
21// File name for conversion
22utility::string_t src = w_cur_dir + L"test.xhtml";
23utility::string_t dst = w_cur_dir + L"result.pdf";
24
25//Conversion
26auto result = api->convertLocalToLocal(src, dst);
27
28// Check the result file
29auto re = result->getFile();
30std::ifstream f(re.c_str());
31if(!f.good())
32{
33    throw std::runtime_error("Conversion failed");
34}

Python

Das folgende Beispiel zeigt, wie man XHTML in PDF mithilfe der Python-Sprache konvertiert. Sie können das Python SDK aus dem GitHub-Repository herunterladen.

 1from asposehtmlcloud.configuration import Configuration
 2from asposehtmlcloud.api.html_api import HtmlApi
 3from asposehtmlcloud.api_client import ApiClient as Client
 4from asposehtmlcloud.rest import ApiException
 5
 6configuration = Configuration(apiKey="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 7                              appSid="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
 8                              basePath="https://api.aspose.cloud/v4.0",
 9                              authPath="https://api.aspose.cloud/connect/token",
10                              debug=True)
11client = Client(configuration)
12html_api = HtmlApi(client)
13
14try:
15    res = html_api.convertApi.convert_local_to_local(input_file="test.xhtml", output_file="test.pdf")
16except ApiException as ex:
17    print("Exception")
18    print("Info: " + str(ex))
19    raise ex

PHP

Das folgende Beispiel zeigt, wie man XHTML in PDF mit PHP konvertiert. Sie können das PHP SDK aus dem GitHub-Repository herunterladen.

 1<?php
 2require_once(__DIR__ . '/vendor/autoload.php');
 3
 4$conf = array(
 5	"basePath" => "https://api.aspose.cloud/v4.0",
 6	"authPath" => "https://api.aspose.cloud/connect/token",
 7	"apiKey" => "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 8	"appSID" => "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
 9	"defaultUserAgent" => "Webkit"
10);
11
12$api_html = new Client\Invoker\Api\HtmlApi($conf);
13
14$src = 'input.xhtml';
15$dst = 'output.pdf';
16
17try {
18    // Request to server Api
19    $result = $api_html->convertLocalToLocal($src, $dst);
20    print_r($result);
21} catch (Exception $e) {
22    echo 'Exception when calling HtmlApi->convertLocalToLocal: ', $e->getMessage(), PHP_EOL;
23}
24
25?>

Ruby

Das folgende Beispiel zeigt, wie man mithilfe der Ruby-Sprache XHTML in PDF konvertiert. Sie können das Ruby SDK aus dem GitHub-Repository herunterladen.

 1# load the gem
 2require 'aspose_html_cloud'
 3
 4# Get keys from aspose site.
 5# There is free quota available. 
 6# For more details, see https://purchase.aspose.cloud/pricing
 7
 8CONFIG = {
 9    "basePath":"https://api.aspose.cloud/v4.0",
10    "authPath":"https://api.aspose.cloud/connect/token",
11    "apiKey":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
12    "appSID":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
13    "debug":true
14}
15
16api_instance = AsposeHtml::HtmlApi.new CONFIG
17
18src = "test.xhtml"  # String | Full path to the input file.
19dst = "test.pdf"   # String | Full path to the result.
20
21begin
22  #Convert the document from the local file and save result to the local file.
23  result = api_instance.convert_local_to_local(src, dst)
24  p result
25rescue AsposeHtml::ApiError => e
26  puts "Exception when calling api_instance.convert_local_to_local: #{e}"
27end

Node.js

Das folgende Beispiel zeigt, wie XHTML in PDF mithilfe der Node.js-Sprache konvertiert wird. Lokales XHTML in PDF konvertiert und im lokalen Pfad gespeichert.

 1// Get keys from aspose site.
 2// There is free quota available.
 3// For more details, see https://purchase.aspose.cloud/pricing
 4	
 5var conf = {
 6    "basePath":"https://api.aspose.cloud/v4.0",
 7    "authPath":"https://api.aspose.cloud/connect/token",
 8    "apiKey":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 9    "appSID":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
10    "defaultUserAgent":"NodeJsWebkit"
11};
12
13var api = require('@asposecloud/aspose-html-cloud');
14
15// Create Conversion Api object
16var conversionApi = new api.ConversionApi(conf);
17
18var src = "/path/to/src/test.xhtml"; // {String} Source document.
19var dst = "/path/to/dst/test.pdf"; // {String} Result document.
20var opts = null;
21
22var callback = function(error, data, response) {
23  if (error) {
24    console.error(error);
25  } else {
26    console.log(data);
27  }
28};
29
30conversionApi.convertLocalToLocal(src, dst, opts, callback);

Swift

Das folgende Beispiel zeigt, wie man mithilfe der Swift-Sprache XHTML in PDF konvertiert. Sie können das Swift SDK aus dem GitHub-Repository herunterladen.

 1import Alamofire
 2import Foundation
 3import XCTest
 4import AsposeHtmlCloud
 5
 6static let fm = FileManager.default
 7let resourceDir = fm.homeDirectoryForCurrentUser.appendingPathComponent("Documents/Aspose.HTML.Cloud.SDK.Swift/Tests/AsposeHtmlCloudTests/Resources")
 8let resultDir = fm.homeDirectoryForCurrentUser.appendingPathComponent("Documents/Aspose.HTML.Cloud.SDK.Swift/Tests/AsposeHtmlCloudTests/TestResult")
 9
10func url(forResource fileName: String) -> URL {
11	return resourceDir.appendingPathComponent(fileName)
12}
13
14func fileExist(name: String) -> Bool {
15	return FileManager.default.fileExists(atPath: name)
16}
17
18ClientAPI.setConfig(
19	basePath: "https://api.aspose.cloud/v4.0",
20	authPath: "https://api.aspose.cloud/connect/token",
21	apiKey: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
22	appSID: "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
23	debugging: true
24)
25
26let fileName = "test.xhtml"
27let format = "pdf"
28let src = url(forResource: fileName).absoluteString
29
30let expectation = self.expectation(description: "testConvert to \(format)")
31let dst = resultDir.appendingPathComponent("Output.\(format)").absoluteString
32HtmlAPI.convertLocalToLocal(src: src, dst: dst, options: nil) { (data, error) in
33
34	guard error == nil else {
35		XCTFail("Error convert XHTML to \(format)). Error=\(error!.localizedDescription)")
36		return
37	}
38	let resultPath = data!.file!
39	XCTAssertTrue(fileExist(name: resultPath))
40	expectation.fulfill()
41}
42self.waitForExpectations(timeout: 100.0, handler: nil)

Java/Android

Das folgende Beispiel zeigt, wie man XHTML in PDF mit Java/Android konvertiert. Sie können das Java/Android SDK aus dem GitHub-Repository herunterladen.

 1Configuration.setBasePath("https://api.aspose.cloud");
 2Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
 3
 4HtmlApi api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET");
 5
 6JobBuilder builder = new ConverterBuilder()
 7                .fromLocalFile("input.xhtml")
 8                .saveToLocal("output.pdf");
 9
10OperationResult result = api.convert(builder);

CURL

Laden Sie eine lokale Datei mithilfe der Speicher-API in den Speicher hoch.
Rufen Sie die REST-API auf, um die Konvertierung auszuführen (im Beispiel unten).
Laden Sie das Konvertierungsergebnis mithilfe der Speicher-API aus dem Speicher herunter.

Das folgende Beispiel zeigt, wie man mithilfe der REST-API XHTML in PDF konvertiert. Befolgen Sie einige erforderliche Schritte:

1curl -X POST -v \
2	"https://api.aspose.cloud/v4.0/html/conversion/XHTML-pdf" \
3    -d "{'InputPath': '/testpage.xhtml', 'OutputFile': 'test.pdf'}" \
4    -H "Content-Type: application/json" \
5    -H "Authorization:Bearer <JWT_token>"

Die Konvertierung von XHTML in PDF erfolgt mit den Standardkonvertierungsoptionen: Die Breite und Höhe des resultierenden PDF-Dokuments entsprechen A4 und alle Ränder haben den Wert Null.

Beispiel 2. Konvertieren Sie XHTML in PDF mit explizit angegebenen Optionen

Das folgende Beispiel zeigt, wie man eine XHTML-Datei aus dem lokalen Dateisystem mit explizit angegebenen Optionen in PDF konvertiert und das Ergebnis wieder im lokalen Pfad speichert.

Das folgende SDK-Beispiel zeigt, wie man XHTML in PDF mit C# konvertiert. XHTML wird aus dem lokalen Dateisystem übernommen, in PDF konvertiert und im lokalen Dateisystem gespeichert. Sie können das C# SDK aus dem GitHub-Repository herunterladen.

 1// Initialize SDK API
 2var api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET").ConvertApi;
 3
 4// Create an options object and specify options for XHTML to PDF conversion
 5var options = new PDFConversionOptions()
 6                .SetHeight(8.3)
 7                .SetWidth(11.7)
 8                .SetLeftMargin(0.5)
 9                .SetRightMargin(0.5)
10                .SetBottomMargin(0.5)
11                .SetTopMargin(0.5);
12
13// Convert XHTML file to PDF format
14var result = await api.ConvertAsync("test.xhtml", "test.pdf", options);

Java

Das folgende Beispiel zeigt, wie man XHTML in PDF mit Java konvertiert. XHTML wird aus dem lokalen Dateisystem übernommen, in PDF konvertiert und im lokalen Pfad gespeichert. Sie können das Java SDK aus dem GitHub-Repository herunterladen.

 1Configuration.setBasePath("https://api.aspose.cloud");
 2Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
 3
 4HtmlApi api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET");
 5
 6PDFConversionOptions opt_A5 = new PDFConversionOptions()
 7                    .setWidth(5.8)        // A5 format in inches
 8                    .setHeight(8.3)
 9                    .setTopMargin(0.5)
10                    .setBottomMargin(0.5)
11                    .setLeftMargin(0.5)
12                    .setRightMargin(0.5)
13                    .setQuality(95);
14
15JobBuilder builder = new ConverterBuilder()
16                .fromLocalFile("input.xhtml")
17                .useOptions(opt_A5)
18                .saveToLocal("output.pdf");
19
20OperationResult result = api.convert(builder);

C++

Das folgende Beispiel zeigt, wie man mit C++ XHTML in PDF konvertiert. XHTML wird aus dem lokalen Dateisystem übernommen, in PDF konvertiert und auf dem lokalen Laufwerk gespeichert.

 1// Get current directory
 2std::string cur_dir(argv[0]);
 3int pos = cur_dir.find_last_of("/\\");
 4cur_dir = cur_dir.substr(0, pos + 1); // Include the last slash
 5std::wstring w_cur_dir(cur_dir.begin(), cur_dir.end());
 6
 7const utility::string_t clientId = L"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX";
 8const utility::string_t clientSecret = L"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
 9const utility::string_t basePath = L"https://api.aspose.cloud/v4.0";
10const utility::string_t authPath = L"https://api.aspose.cloud/connect/token";
11
12// Create configuration for authorization
13std::shared_ptr<ApiConfiguration> apiConfig(new ApiConfiguration(clientId, clientSecret, basePath, authPath));
14
15// Create client from configuration
16std::shared_ptr<ApiClient> apiClient(new ApiClient(apiConfig));
17
18// Create ConversionApi
19std::shared_ptr<ConversionApi> api = std::make_shared<ConversionApi>(apiClient);
20
21// File name for conversion
22utility::string_t src = w_cur_dir + L"test.xhtml";
23utility::string_t dst = w_cur_dir + L"result.pdf";
24
25std::shared_ptr<ConversionOptions> opts = std::make_shared<ConversionOptions>();
26opts->setWidth(8.3)
27    ->setHeight(11.7)
28    ->setLeftMargin(0.2)
29    ->setRightMargin(0.2)
30    ->setTopMargin(0.2)
31    ->setBottomMargin(0.2);
32
33//Conversion
34auto result = api->convertLocalToLocal(src, dst, opts);
35
36// Check the result file
37auto re = result->getFile();
38std::ifstream f(re.c_str());
39if(!f.good())
40{
41    throw std::runtime_error("Conversion failed");
42}

Python

Das folgende Beispiel zeigt, wie man XHTML in PDF mithilfe der Python-Sprache konvertiert. XHTML wird aus dem lokalen Dateisystem übernommen, in PDF konvertiert und auf dem lokalen Laufwerk gespeichert. Sie können das Python SDK aus dem GitHub-Repository herunterladen.

 1from asposehtmlcloud.configuration import Configuration
 2from asposehtmlcloud.api.html_api import HtmlApi
 3from asposehtmlcloud.api_client import ApiClient as Client
 4from asposehtmlcloud.rest import ApiException
 5
 6configuration = Configuration(apiKey="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 7                              appSid="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
 8                              basePath="https://api.aspose.cloud/v4.0",
 9                              authPath="https://api.aspose.cloud/connect/token",
10                              debug=True)
11client = Client(configuration)
12html_api = HtmlApi(client)
13
14options = {
15    'width': 8.3,
16    'height': 11.7,
17    'topmargin': 0.2,
18    'bottommargin': 0.2,
19    'leftmargin': 0.2,
20    'rightmargin': 0.2
21}
22
23try:
24    res = html_api.convertApi.convert_local_to_local(input_file="test.xhtml", output_file="test.pdf", options=options)
25except ApiException as ex:
26    print("Exception")
27    print("Info: " + str(ex))
28    raise ex

PHP

Das folgende Beispiel zeigt, wie man XHTML in PDF mit PHP konvertiert. XHTML wird aus dem lokalen Dateisystem übernommen, in PDF konvertiert und im lokalen Dateisystem gespeichert. Sie können das PHP SDK aus dem GitHub-Repository herunterladen.

 1<?php
 2require_once(__DIR__ . '/vendor/autoload.php');
 3
 4$conf = array(
 5	"basePath" => "https://api.aspose.cloud/v4.0",
 6	"authPath" => "https://api.aspose.cloud/connect/token",
 7	"apiKey" => "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 8	"appSID" => "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
 9	"defaultUserAgent" => "Webkit"
10);
11
12$api_html = new Client\Invoker\Api\HtmlApi($conf);
13
14$src = 'input.xhtml';
15$dst = 'output.pdf';
16
17$options_a4 = [
18    'width' => 8.3,
19    'height' => 11.7,
20    'left_margin' => 0.2,
21    'right_margin' => 0.2,
22    'top_margin' => 0.2,
23    'bottom_margin' => 0.2
24];
25
26
27try {
28    // Request to server Api
29    $result = $api_html->convertLocalToLocal($src, $dst, $options_a4);
30    print_r($result);
31} catch (Exception $e) {
32    echo 'Exception when calling HtmlApi->convertLocalToLocal: ', $e->getMessage(), PHP_EOL;
33}
34?>

Ruby

Das folgende Beispiel zeigt, wie man mithilfe der Ruby-Sprache XHTML in PDF konvertiert. XHTML wird aus dem lokalen Dateisystem übernommen, in PDF konvertiert und im lokalen Pfad gespeichert. Sie können das Ruby SDK aus dem GitHub-Repository herunterladen.

 1# load the gem
 2require 'aspose_html_cloud'
 3
 4# Get keys from aspose site.
 5# There is free quota available. 
 6# For more details, see https://purchase.aspose.cloud/pricing
 7
 8
 9CONFIG = {
10    "basePath":"https://api.aspose.cloud/v4.0",
11    "authPath":"https://api.aspose.cloud/connect/token",
12    "apiKey":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
13    "appSID":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
14    "debug":true
15}
16
17api_instance = AsposeHtml::HtmlApi.new CONFIG
18
19src = "test.xhtml" # String | Source file.
20dst = "test.pdf"  # String | Result file.
21
22opts = { 
23  width: 8.3,        # Float | Resulting document width in inches.
24  height: 11.7,      # Float | Resulting document height in inches.
25  left_margin: 0.2,  # Float | Left resulting document margin in inches.
26  right_margin: 0.2, # Float | Right resulting document margin in inches.
27  top_margin: 0.2,   # Float | Top resulting document margin in inches.
28  bottom_margin: 0.2 # Float | Bottom resulting document margin in inches.
29}
30
31begin
32  #Convert the HTML file from the local file and save result to the local file.
33  result = api_instance.convert_local_to_local(src, dst, opts)
34  p result
35rescue AsposeHtml::ApiError => e
36  puts "Exception when calling api_instance.convert_local_to_local: #{e}"
37end

Node.js

Das folgende Beispiel zeigt, wie XHTML in PDF mithilfe der Node.js-Sprache konvertiert wird. XHTML wird aus dem lokalen Dateisystem übernommen, in PDF konvertiert und im lokalen Dateisystem gespeichert.

 1// Get keys from aspose site.
 2// There is free quota available.
 3// For more details, see https://purchase.aspose.cloud/pricing
 4	
 5var conf = {
 6    "basePath":"https://api.aspose.cloud/v4.0",
 7    "authPath":"https://api.aspose.cloud/connect/token",
 8    "apiKey":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 9    "appSID":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
10    "defaultUserAgent":"NodeJsWebkit"
11};
12
13var api = require('@asposecloud/aspose-html-cloud');
14
15// Create Conversion Api object
16var conversionApi = new api.ConversionApi(conf);
17
18var src = "/path/to/src/test.xhtml"; // {String} Source document.
19var dst = "/path/to/dst/test.pdf"; // {String} Result document.
20var opts = {
21    'width': 8.3,
22    'height': 11.7,
23    'leftMargin': 0.2,
24    'rightMargin': 0.2,
25    'topMargin': 0.2,
26    'bottomMargin': 0.2
27};
28
29var callback = function(error, data, response) {
30  if (error) {
31    console.error(error);
32  } else {
33    console.log(data);
34  }
35};
36
37conversionApi.convertLocalToLocal(src, dst, opts, callback);

Swift

Das folgende Beispiel zeigt, wie man mithilfe der Swift-Sprache XHTML in PDF konvertiert. XHTML wird aus dem lokalen Dateisystem übernommen, in PDF konvertiert und auf dem lokalen Laufwerk gespeichert. Sie können das Swift SDK aus dem GitHub-Repository herunterladen.

 1import Alamofire
 2import Foundation
 3import XCTest
 4import AsposeHtmlCloud
 5
 6static let fm = FileManager.default
 7let resourceDir = fm.homeDirectoryForCurrentUser.appendingPathComponent("Documents/Aspose.HTML.Cloud.SDK.Swift/Tests/AsposeHtmlCloudTests/Resources")
 8let resultDir = fm.homeDirectoryForCurrentUser.appendingPathComponent("Documents/Aspose.HTML.Cloud.SDK.Swift/Tests/AsposeHtmlCloudTests/TestResult")
 9
10func url(forResource fileName: String) -> URL {
11	return resourceDir.appendingPathComponent(fileName)
12}
13
14func fileExist(name: String) -> Bool {
15	return FileManager.default.fileExists(atPath: name)
16}
17
18ClientAPI.setConfig(
19	basePath: "https://api.aspose.cloud/v4.0",
20	authPath: "https://api.aspose.cloud/connect/token",
21	apiKey: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
22	appSID: "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
23	debugging: true
24)
25
26let fileName = "test.xhtml"
27let format = "pdf"
28let src = url(forResource: fileName).absoluteString
29let options = Options(width: 8.3, height: 11.7, leftMargin: 0.2,
30        rightMargin: 0.2, topMargin: 0.2, bottomMargin: 0.2)
31
32
33let expectation = self.expectation(description: "testConvert to \(format)")
34let dst = resultDir.appendingPathComponent("Output.\(format)").absoluteString
35HtmlAPI.convertLocalToLocal(src: src, dst: dst, options: options) { (data, error) in
36
37	guard error == nil else {
38		XCTFail("Error convert XHTML to \(format)). Error=\(error!.localizedDescription)")
39		return
40	}
41	let resultPath = data!.file!
42	XCTAssertTrue(fileExist(name: resultPath))
43	expectation.fulfill()
44}
45self.waitForExpectations(timeout: 100.0, handler: nil)

Java/Android

Das folgende Beispiel zeigt, wie man XHTML in PDF mit Java/Android konvertiert. XHTML wird aus dem lokalen Dateisystem übernommen, in PDF konvertiert und auf dem lokalen Laufwerk gespeichert. Sie können das Java/Android SDK aus dem GitHub-Repository herunterladen.

 1Configuration.setBasePath("https://api.aspose.cloud");
 2Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
 3
 4HtmlApi api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET");
 5
 6PDFConversionOptions opt_A5 = new PDFConversionOptions()
 7                    .setWidth(5.8)        // A5 format in inches
 8                    .setHeight(8.3)
 9                    .setTopMargin(0.5)
10                    .setBottomMargin(0.5)
11                    .setLeftMargin(0.5)
12                    .setRightMargin(0.5)
13                    .setQuality(95);
14
15JobBuilder builder = new ConverterBuilder()
16                .fromLocalFile("input.xhtml")
17                .useOptions(opt_A5)
18                .saveToLocal("output.pdf");
19
20OperationResult result = api.convert(builder);

CURL

Das folgende Beispiel zeigt, wie man mithilfe der REST-API XHTML in PDF konvertiert. Lokales XHTML in PDF konvertiert und im lokalen Dateisystem gespeichert. Befolgen Sie einige erforderliche Schritte:

Laden Sie eine lokale Datei mithilfe der Speicher-API in den Speicher hoch.
Rufen Sie die REST-API auf, um die Konvertierung auszuführen (im Beispiel unten).
Laden Sie das Konvertierungsergebnis mithilfe der Speicher-API aus dem Speicher herunter.

1curl -X POST -v \
2	"https://api.aspose.cloud/v4.0/html/conversion/XHTML-pdf" \
3    -d "{'InputPath': '/testpage.xhtml', 'OutputFile': 'test.pdf', 'Options': {'Width':1000, 'Height': 800, 'LeftMargin': 10, 'RightMargin': 10, 'TopMargin': 10, 'BottomMargin': 10}}" \
4    -H "Content-Type: application/json" \
5    -H "Authorization: bearer <token>"

Weitere Einzelheiten zu den verfügbaren Konvertierungsparametern für XHTML-Dateien finden Sie im Abschnitt SDK-Konvertierungsoptionen.

Beispiel 3. Konvertieren Sie XHTML in PDF im Cloud-Speicher

Mit Aspose.HTML Cloud können Sie eine XHTML-Datei aus Ihrem Cloud-Speicher abrufen und das Konvertierungsergebnis wieder im Cloud-Speicher speichern. Schauen wir uns ein Beispiel für die Konvertierung innerhalb des Cloud-Speichers mit Standard-Speicheroptionen an.

Das folgende Beispiel zeigt, wie man XHTML in PDF mit C# konvertiert. Sie können das C# SDK aus dem GitHub-Repository herunterladen.

1// Initialize SDK API
2var api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET").ConvertApi;
3
4// Convert XHTML to PDF using ConvertAsync() method
5var builder = new ConverterBuilder()
6                .FromStorageFile("/test.xhtml")
7                .ToStorageFile("/test.pdf");
8                
9var result = await api.ConvertAsync(builder);

Java

Das folgende Beispiel zeigt, wie man XHTML in PDF mit Java konvertiert. Sie können das Java SDK aus dem GitHub-Repository herunterladen.

 1Configuration.setBasePath("https://api.aspose.cloud");
 2Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
 3
 4HtmlApi api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET");
 5
 6JobBuilder builder = new ConverterBuilder()
 7                .fromStorageFile("input.xhtml")
 8                .saveToStorage("output.pdf");
 9
10OperationResult result = api.convert(builder);

C++

Das folgende Beispiel zeigt, wie man mit C++ XHTML in PDF konvertiert. XHTML befindet sich im Cloud-Speicher, wird in PDF konvertiert und in der Cloud gespeichert.

 1const utility::string_t clientId = L"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX";
 2const utility::string_t clientSecret = L"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
 3const utility::string_t basePath = L"https://api.aspose.cloud/v4.0";
 4const utility::string_t authPath = L"https://api.aspose.cloud/connect/token";
 5
 6// Create configuration for authorization
 7std::shared_ptr<ApiConfiguration> apiConfig(new ApiConfiguration(clientId, clientSecret, basePath, authPath));
 8
 9// Create client from configuration
10std::shared_ptr<ApiClient> apiClient(new ApiClient(apiConfig));
11
12// Create ConversionApi
13std::shared_ptr<ConversionApi> api = std::make_shared<ConversionApi>(apiClient);
14
15// File name for conversion
16utility::string_t src = L"file/in/storage/index.xhtml";
17utility::string_t dst = L"result/in/storage/result.pdf";
18
19//Conversion
20auto result = api->convertStorageToStorage(src, dst);

Python

Das folgende Beispiel zeigt, wie man mithilfe der Python-Sprache XHTML in PDF konvertiert. Sie können das Python SDK aus dem GitHub-Repository herunterladen.

 1from asposehtmlcloud.configuration import Configuration
 2from asposehtmlcloud.api.html_api import HtmlApi
 3from asposehtmlcloud.api_client import ApiClient as Client
 4from asposehtmlcloud.rest import ApiException
 5
 6configuration = Configuration(apiKey="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 7                              appSid="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
 8                              basePath="https://api.aspose.cloud/v4.0",
 9                              authPath="https://api.aspose.cloud/connect/token",
10                              debug=True)
11client = Client(configuration)
12html_api = HtmlApi(client)
13
14try:
15    res = html_api.convertApi.convert_storage_to_storage(input_file="test.xhtml", output_file="test.pdf",
16                                                         storage_name=None)
17except ApiException as ex:
18    print("Exception")
19    print("Info: " + str(ex))
20    raise ex

PHP

Das folgende Beispiel zeigt, wie man XHTML in PDF mit PHP konvertiert. Sie können das PHP SDK aus dem GitHub-Repository herunterladen.

 1<?php
 2require_once(__DIR__ . '/vendor/autoload.php');
 3
 4$configuration = array(
 5    "basePath" => "https://api.aspose.cloud/v4.0",
 6    "authPath" => "https://api.aspose.cloud/connect/token",
 7    "apiKey" => "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 8    "appSID" => "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
 9    "defaultUserAgent" => "Webkit"
10);
11
12$api_html = new HtmlApi($configuration);
13
14$src = "FolderInStorage/test.xhtml";
15$dst = 'FolderInStorage/test.pdf';
16$options = null;
17
18try {
19    $result = $api_html->convertStorageToStorage($src, $dst, null, $options);
20    print_r($result);
21} catch (Exception $e) {
22    echo 'Exception when calling $api_html->convertStorageToStorage: ', $e->getMessage(), PHP_EOL;
23}
24?>

Ruby

Das folgende Beispiel zeigt, wie man XHTML in PDF mithilfe der Ruby-Sprache konvertiert. Sie können das Ruby SDK aus dem GitHub-Repository herunterladen.

 1# load the gem
 2require 'aspose_html_cloud'
 3
 4# Get keys from aspose site.
 5# There is free quota available. 
 6# For more details, see https://purchase.aspose.cloud/pricing
 7
 8
 9CONFIG = {
10    "basePath":"https://api.aspose.cloud/v4.0",
11    "authPath":"https://api.aspose.cloud/connect/token",
12    "apiKey":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
13    "appSID":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
14    "debug":true
15}
16
17api_instance = AsposeHtml::HtmlApi.new CONFIG
18
19src = "FolderInStorage/test.xhtml" # String | Source file.
20dst = "FolderInStorage/test.pdf"  # String | Result file.
21storage = nil
22
23begin
24  #Convert the file from the storage and save result to the storage.
25  result = api_instance.convert_storage_to_storage(src, dst, storage)
26  p result
27rescue AsposeHtml::ApiError => e
28  puts "Exception when calling api_instance.convert_storage_to_storage: #{e}"
29end

Node.js

Das folgende Beispiel zeigt, wie XHTML in PDF mithilfe der Node.js-Sprache konvertiert wird.

 1// Get keys from aspose site.
 2// There is free quota available.
 3// For more details, see https://purchase.aspose.cloud/pricing
 4	
 5var conf = {
 6    "basePath":"https://api.aspose.cloud/v4.0",
 7    "authPath":"https://api.aspose.cloud/connect/token",
 8    "apiKey":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 9    "appSID":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
10    "defaultUserAgent":"NodeJsWebkit"
11};
12
13var api = require('@asposecloud/aspose-html-cloud');
14
15// Create Conversion Api object
16var conversionApi = new api.ConversionApi(conf);
17
18var src = "FolderInStorage/test.xhtml"; // {String} Source document.
19var dst = "FolderInStorage/test.pdf"; // {String} Result document.
20var opts = null;
21var storage = null;
22
23var callback = function(error, data, response) {
24  if (error) {
25    console.error(error);
26  } else {
27    console.log(data);
28  }
29};
30
31conversionApi.convertStorageToStorage(src, dst, storage, opts, callback);

Swift

Das folgende Beispiel zeigt, wie man mithilfe der Swift-Sprache XHTML in PDF konvertiert. Sie können das Swift SDK aus dem GitHub-Repository herunterladen.

 1import Alamofire
 2import Foundation
 3import XCTest
 4import AsposeHtmlCloud
 5
 6ClientAPI.setConfig(
 7	basePath: "https://api.aspose.cloud/v4.0",
 8	authPath: "https://api.aspose.cloud/connect/token",
 9	apiKey: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
10	appSID: "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
11	debugging: true
12)
13
14let src = "FolderInStorage/test.xhtml"
15let dst = "FolderInStorage/test.pdf"
16
17let expectation = self.expectation(description: "testConvert to pdf")
18
19HtmlAPI.convertStorageToStorage(src: src, dst: dst, storage: nil, options: nil) { (data, error) in
20
21    guard error == nil else {
22        XCTFail("Error convert XHTML to pdf. Error=\(error!.localizedDescription)")
23        return
24    }
25
26    let resultPath = data!.file!
27
28    StorageAPI.objectExists(path: resultPath, storageName: nil, versionId: nil) {(data, error) in
29        guard error == nil else {
30            XCTFail("Error objectExists exist. Error=\(error!.localizedDescription)")
31            return
32        }
33
34        XCTAssertTrue(data!.exists)
35        XCTAssertFalse(data!.isFolder)
36        expectation.fulfill()
37    }
38}
39self.waitForExpectations(timeout: 100.0, handler: nil)

Java/Android

Das folgende Beispiel zeigt, wie man XHTML in PDF mit Java/Android konvertiert. Sie können das Java/Android SDK aus dem GitHub-Repository herunterladen.

 1Configuration.setBasePath("https://api.aspose.cloud");
 2Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
 3
 4HtmlApi api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET");
 5
 6JobBuilder builder = new ConverterBuilder()
 7                .fromStorageFile("input.xhtml")
 8                .saveToStorage("output.pdf");
 9
10OperationResult result = api.convert(builder);

CURL

Das folgende Beispiel zeigt, wie man mithilfe der REST-API XHTML in PDF konvertiert. Die XHTML-Datei befindet sich im Cloud-Speicher, wird in PDF konvertiert und wieder im Cloud-Speicher gespeichert.

1curl -X POST -v \
2	"https://api.aspose.cloud/v4.0/html/conversion/XHTML-pdf" \
3    -d "{'InputPath': '/test.xhtml', 'OutputFile': '/test.pdf'}" \
4    -H "Content-Type: application/json" \
5    -H "Authorization:Bearer <JWT_token>"

Siehe auch

Der Artikel Verfügbare SDKs stellt Ihnen die Fähigkeit von Aspose.HTML Cloud vor, SDKs in verschiedenen Programmiersprachen wie C#, Java, Python, Ruby, PHP, Node.js, Swift, Android und C++ zu verwenden.
Der Artikel SDK-Konvertierungsoptionen beschreibt eine Reihe von Klassen, die Optionen zum Konvertieren eines HTML-basierten Quelldokuments in PDF, XPS und Bild darstellen.
Aspose.HTML Cloud API können Sie direkt von Ihrem Browser aus aufrufen, indem Sie auf die API-Referenz zugreifen.
Aspose.HTML bietet einen kostenlosen Online- XHTML-zu-PDF-Konverter, der XHTML schnell und in hoher Qualität in PDF konvertiert. Laden Sie einfach Ihre Dateien hoch, konvertieren Sie sie und erhalten Sie das Ergebnis in wenigen Sekunden!

XHTML-Konverter XHTML in XPS konvertieren