webPDF und Java: mit der wsclient-Bibliothek ganz einfach

Minimale technische Voraussetzungen​

  • Java version: 7
  • webPDF version: 7
  • wsclient version: 1

Bild Glühbirne: Anleitung - Tutorial

Wussten Sie schon, ...​

...dass die Parametrisierung sämtlicher webPDF-Webservices seit Version 7 über XSD definiert, vereinheitlicht und deutlich erweitert wurde?

Anhand des XML-Schemas http://schema.webpdf.de/1.0/operation.xsd können Sie beispielsweise eigene JAXB-Stubs für Java erzeugen (automatisierbar z. B. mit XJC). Die Parametrisierung des Webservice-Aufrufs lässt sich so objektorientiert abbilden.

Wenn Sie allerdings eine Client-Applikation entwickeln, reichen die Stubs allein nicht aus. Sie benötigen zusätzlich:

  • Verbindungsaufbau zum webPDF-Server
  • Aufruf der Endpunkte über SOAP oder REST
  • Clientseitige Verarbeitung und Abholung der Ergebnisse

Gerade diese Zwischenschritte kosten Zeit. Dafür gibt es eine deutlich einfachere Lösung.

Lassen Sie uns das übernehmen​

Mit der webPDF wsclient-Bibliothek erhalten Sie eine stabile Basis für die Nutzung des webPDF-Servers. Parametrisierung, Session-Aufbau, Aufruf und Kommunikation mit den Endpunkten werden dabei zentral unterstützt, damit Sie sich auf Ihre Fachlogik konzentrieren können.

wsclient auf GitHub und in Maven Central​

Die öffentlich zugängliche und kostenfreie wsclient-Bibliothek lässt sich in Java-basierten Client-Applikationen einbinden (ab JDK 7 und webPDF Server Version 7).

Wichtige Hinweise:

Das Projekt wird auf GitHub gepflegt und weiterentwickelt. Feedback, Ideen und Beiträge sind willkommen. Wenn Sie Probleme finden, melden Sie diese bitte als Issue oder erstellen Sie eine Pull Request.

Für die direkte Integration steht die Bibliothek als Maven-Paket über Maven Central bereit.

<dependency>
  <groupId>net.webpdf</groupId>
  <artifactId>webpdf-wsclient</artifactId>
  <version>1.0.0</version>
</dependency>

Einbindung in der pom.xml:

<?xml version="1.0" encoding="UTF-8"?>
<project>
  <modelVersion>4.0.0</modelVersion>
  <groupId>net.softvision</groupId>
  <artifactId>wsclient-example</artifactId>
  <version>1.0-SNAPSHOT</version>
  <dependencies>
    <dependency>
      <groupId>net.webpdf</groupId>
      <artifactId>webpdf-wsclient</artifactId>
      <version>1.0.0</version>
    </dependency>
  </dependencies>
</project>

Nutzung der wsclient-Bibliothek​

Ausführliche Erläuterungen und Beispiele zur Nutzung der SOAP- und REST-Schnittstelle finden Sie in folgenden Beiträgen: