wsclient Bibliothek: Webservice Converter

Mindestvoraussetzungen​

  • Java-Version: 7
  • webPDF-Version: 7
  • wsclient-Version: 1

Dieses Beispiel zeigt die Nutzung der Converter-Operation über die webPDF-wsclient-Bibliothek.

Einstieg mit REST- oder SOAP-Session​

Über WebServiceFactory erstellen Sie je nach Protokoll ein Service-Objekt:

ConverterWebService converterWebService = WebServiceFactory.createInstance(session, WebServiceType.CONVERTER);

oder

ConverterRestWebService converterWebService = WebServiceFactory.createInstance(session, WebServiceType.CONVERTER);

Danach wird per setDocument() ein SoapDocument- oder RestDocument-Objekt gesetzt.

Converter-Webservice​

Der Converter-Endpunkt konvertiert zahlreiche Eingangsformate in PDF.

ConverterType converterType = converterWebService.getOperation();

Wichtige Parameter (Auszug)​

pages​

Seitenauswahl, z. B. *, 1, 1-5, 1,3-5.

accessPassword​

Passwort für geschützte Quelldokumente.

compression​

Komprimierung von Datenobjekten im resultierenden PDF.

dpi​

Ausgabeauflösung, zum Beispiel 300 DPI.

embedFonts​

Schriftarten ins Zieldokument einbetten.

jpegQuality​

Qualität der JPEG-Ausgabe steuern.

fileExtension​

Dateiformaterkennung in Sonderfällen manuell setzen.

Objekte im Converter​

html​

Optionen für HTML-basierte Quellen, zum Beispiel adjustFonts, baseURL oder downloadImages.

mail​

Optionen für die E-Mail-Konvertierung, zum Beispiel attachmentMode oder downloadImages.

officeBridge​

Nutzt Office Bridge für die Office-Konvertierung.

sharePointBridge​

Nutzt einen SharePoint-Dienst für die Word-Konvertierung.

page​

Seitenparameter wie Ränder, Höhe, Breite und Maßeinheit.

pdfa​

Direkte PDF/A-Konvertierung über PdfaType.

signature​

Signaturparameter über SignatureType.

report​

Erweitertes Fehlerreporting für textbasierte Dokumente.

template​

Template-Einstellungen für templatebasierte Konvertierungen.

Beispielaufruf (SOAP)​

try (
    SoapSession session = SessionFactory.createInstance(
        WebServiceProtocol.SOAP,
        new URL("https://localhost:8080/webPDF/")
    );
    SoapDocument soapDocument = new SoapDocument(
        new File("Pfad des Quelldokuments").toURI(),
        new File("Pfad des Zieldokuments")
    )
) {
    // Webservice-Aufruf
} catch (ResultException | MalformedURLException ex) {
    // Fehlerbehandlung
}

Weiterführende Informationen: