Convierta XHTML a PDF – Cloud SDK y API REST

XHTML a PDF

XHTML es un lenguaje de marcado que combina la sintaxis de HTML con el rigor de XML, lo que permite documentos web estructurados y bien formados. La conversión de XHTML a PDF ofrece muchos beneficios, entre los que destaca la preservación del diseño, el estilo y la estructura del contenido web en un formato portátil y fácilmente distribuible. Los archivos PDF mantienen la integridad del contenido XHTML original, incluido el formato de texto, imágenes e hipervínculos, lo que los hace ideales para distribuir documentos en múltiples plataformas y dispositivos. Además, los archivos PDF son ampliamente compatibles con varias aplicaciones de software y se pueden ver e imprimir fácilmente mediante un software de lectura de PDF, lo que brinda a los usuarios acceso universal al contenido.

Aspose.HTML Cloud v4.0 proporciona la API más sencilla para convertir documentos XHTML al formato PDF con alta calidad, fácil y rápido.

El artículo explica en un conjunto de ejemplos de código cómo convertir un documento XHTML a PDF usando Aspose.HTML Cloud SDK y REST API. Los SDK están disponibles en PHP, C++, Python, C#, Ruby, Java, Android, Swift y Node.js. Consideraremos varios escenarios de conversión de XHTML a PDF:

Convertir un archivo XHTML local a PDF y guardar el resultado en su sistema de archivos local. En este escenario, exploraremos tanto las conversiones con parámetros de conversión predeterminados como con parámetros especificados explícitamente.
Conversión de XHTML a PDF en almacenamiento en la nube con parámetros de conversión predeterminados.

Ejemplos de conversión de XHTML a PDF

Un caso de uso generalizado de las funciones de Aspose.HTML Cloud es el procesamiento y conversión de archivos. Cloud SDK le permite recuperar un documento XHTML de una ubicación de almacenamiento por su nombre o un archivo local en su disco, convertirlo a un formato específico y guardarlo en el almacenamiento o en un disco local. Los siguientes ejemplos de código demuestran cómo convertir XHTML a PDF para diferentes casos utilizando los SDK y la API REST disponibles.

Ejemplo 1. Convertir XHTML a PDF con opciones de conversión predeterminadas

Considere convertir un documento XHTML inicialmente ubicado en un sistema de archivos local al formato PDF. Luego, el archivo resultante se guarda nuevamente en el sistema de archivos local. La conversión se produce con las opciones de conversión predeterminadas.

El siguiente ejemplo demuestra la forma más sencilla de convertir XHTML a PDF usando C#. Puede descargar el SDK de C# desde el repositorio de GitHub.

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

El siguiente ejemplo demuestra cómo convertir XHTML a PDF usando Java. Puede descargar el SDK de Java desde el repositorio de GitHub.

 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++

El siguiente ejemplo demuestra cómo convertir XHTML a PDF aplicando el lenguaje C++. XHTML local convertido a PDF y guardado en la ruta local.

 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

El siguiente ejemplo demuestra cómo convertir XHTML a PDF aplicando el lenguaje Python. Puede descargar el SDK de Python desde el repositorio de GitHub.

 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

El siguiente ejemplo demuestra cómo convertir XHTML a PDF usando PHP. Puede descargar el SDK de PHP desde el repositorio de GitHub

 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

El siguiente ejemplo demuestra cómo convertir XHTML a PDF aplicando el lenguaje Ruby. Puede descargar el SDK de Ruby desde el repositorio de GitHub.

 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

El siguiente ejemplo demuestra cómo convertir XHTML a PDF aplicando el lenguaje Node.js. XHTML local convertido a PDF y guardado en la ruta local.

 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

El siguiente ejemplo demuestra cómo convertir XHTML a PDF aplicando el lenguaje Swift. Puede descargar el SDK de Swift desde el repositorio de GitHub.

 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

El siguiente ejemplo demuestra cómo convertir XHTML a PDF usando Java/Android. Puede descargar el SDK de Java/Android desde el repositorio de GitHub.

 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

Cargue un archivo local al almacenamiento usando API de almacenamiento.
Llame a la API REST para ejecutar la conversión (en el ejemplo siguiente).
Descargue el resultado de la conversión desde el almacenamiento usando API de almacenamiento.

El siguiente ejemplo demuestra cómo convertir XHTML a PDF usando la API REST. Siga algunos pasos requeridos:

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>"

La conversión de XHTML a PDF se produce con las opciones de conversión predeterminadas: el ancho y el alto del documento PDF resultante corresponden a A4, y todos los márgenes tienen valor cero.

Ejemplo 2. Convertir XHTML a PDF con opciones especificadas explícitamente

El siguiente ejemplo demuestra cómo convertir un archivo XHTML del sistema de archivos local a PDF con opciones especificadas explícitamente y guardar el resultado en la ruta local.

El siguiente ejemplo de SDK demuestra cómo convertir XHTML a PDF usando C#. XHTML se toma del sistema de archivos local, se convierte a PDF y se guarda en el sistema de archivos local. Puede descargar el SDK de C# desde el repositorio de GitHub.

 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

El siguiente ejemplo demuestra cómo convertir XHTML a PDF usando Java. XHTML se toma del sistema de archivos local, se convierte a PDF y se guarda en la ruta local. Puede descargar el SDK de Java desde el repositorio de GitHub.

 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++

El siguiente ejemplo demuestra cómo convertir XHTML a PDF usando C++. XHTML se toma del sistema de archivos local, se convierte a PDF y se guarda en la unidad local.

 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

El siguiente ejemplo demuestra cómo convertir XHTML a PDF aplicando el lenguaje Python. XHTML se toma del sistema de archivos local, se convierte a PDF y se guarda en la unidad local. Puede descargar el SDK de Python desde el repositorio de GitHub.

 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

El siguiente ejemplo demuestra cómo convertir XHTML a PDF usando PHP. XHTML se toma del sistema de archivos local, se convierte a PDF y se guarda en el sistema de archivos local. Puede descargar el SDK de PHP desde el repositorio de GitHub

 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

El siguiente ejemplo demuestra cómo convertir XHTML a PDF aplicando el lenguaje Ruby. XHTML se toma del sistema de archivos local, se convierte a PDF y se guarda en la ruta local. Puede descargar el SDK de Ruby desde el repositorio de GitHub.

 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

El siguiente ejemplo demuestra cómo convertir XHTML a PDF aplicando el lenguaje Node.js. XHTML se toma del sistema de archivos local, se convierte a PDF y se guarda en el sistema de archivos local.

 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

El siguiente ejemplo demuestra cómo convertir XHTML a PDF aplicando el lenguaje Swift. XHTML se toma del sistema de archivos local, se convierte a PDF y se guarda en la unidad local. Puede descargar el SDK de Swift desde el repositorio de GitHub.

 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

El siguiente ejemplo demuestra cómo convertir XHTML a PDF usando Java/Android. XHTML se toma del sistema de archivos local, se convierte a PDF y se guarda en la unidad local. Puede descargar el SDK de Java/Android desde el repositorio de GitHub.

 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

El siguiente ejemplo demuestra cómo convertir XHTML a PDF usando la API REST. XHTML local convertido a PDF y guardado en el sistema de archivos local. Siga algunos pasos requeridos:

Cargue el archivo local al almacenamiento usando API de almacenamiento.
Llame a la API REST para ejecutar la conversión (en el ejemplo siguiente).
Descargue el resultado de la conversión desde el almacenamiento usando API de almacenamiento.

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>"

Más detalles sobre los parámetros de conversión disponibles para archivos XHTML se encuentran en la sección Opciones de conversión SDK.

Ejemplo 3. Convertir XHTML a PDF dentro del almacenamiento en la nube

Aspose.HTML Cloud le permite obtener un archivo XHTML de su almacenamiento en la nube y guardar el resultado de la conversión en el almacenamiento en la nube. Veamos un ejemplo de conversión dentro del almacenamiento en la nube con opciones de guardado predeterminadas.

El siguiente ejemplo muestra cómo convertir XHTML a PDF usando C#. Puede descargar el SDK de C# desde el repositorio de GitHub.

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

El siguiente ejemplo muestra cómo convertir XHTML a PDF usando Java. Puede descargar el SDK de Java desde el repositorio de GitHub.

 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++

El siguiente ejemplo demuestra cómo convertir XHTML a PDF usando C++. XHTML se encuentra en el almacenamiento en la nube, se convierte a PDF y se guarda en la nube.

 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

El siguiente ejemplo muestra cómo convertir XHTML a PDF aplicando el lenguaje Python. Puede descargar el SDK de Python desde el repositorio de GitHub.

 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

El siguiente ejemplo demuestra cómo convertir XHTML a PDF usando PHP. Puede descargar el SDK de PHP desde el repositorio de GitHub.

 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

El siguiente ejemplo muestra cómo convertir XHTML a PDF aplicando el lenguaje Ruby. Puede descargar el SDK de Ruby desde el repositorio de GitHub.

 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

El siguiente ejemplo muestra cómo convertir XHTML a PDF aplicando el lenguaje Node.js.

 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

El siguiente ejemplo muestra cómo convertir XHTML a PDF aplicando el lenguaje Swift. Puede descargar el SDK de Swift desde el repositorio de GitHub.

 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

El siguiente ejemplo muestra cómo convertir XHTML a PDF usando Java/Android. Puede descargar el SDK de Java/Android desde el repositorio de GitHub.

 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

El siguiente ejemplo demuestra cómo convertir XHTML a PDF usando la API REST. El archivo XHTML se encuentra en el almacenamiento en la nube, se convierte a PDF y se guarda nuevamente en el almacenamiento en la nube.

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>"

Ver también

El artículo SDK disponibles le presenta la capacidad de Aspose.HTML Cloud para usar SDK en varios lenguajes de programación, como C#, Java, Python, Ruby, PHP, Node.js, Swift, Android y C++.
El artículo Opciones de conversión describe un conjunto de clases que representan opciones para convertir un documento fuente basado en HTML a PDF, XPS e imagen.
Aspose.HTML Cloud API a la que puedes llamar directamente desde tu navegador accediendo a la Referencia de API.
Aspose.HTML ofrece un Convertidor de XHTML a PDF en línea gratuito que convierte rápidamente XHTML a PDF con alta calidad. ¡Simplemente cargue sus archivos, conviértalos y obtenga el resultado en unos segundos!

Convertidor XHTML Convertir XHTML a XPS