webPDF and Java: very easy with the wsclient library

Minimum technical requirements​

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

Light bulb: guide and tutorial

Did you know...?​

...that the parameterization of all webservices of webPDF since version 7 has been defined, standardized and even more extensive via XSDs?

Using the XML schema http://schema.webpdf.de/1.0/operation.xsd, you can easily create your own JAXB stubs for Java, for example automated via XJC. This makes it possible to map web service parameterization in a simple and object-oriented way.

However, if you want to build a client application, the stubs alone are not enough. You also need code to connect to the webPDF server, call the endpoints via the SOAP or REST interface, and retrieve the generated results on the client side. All of these intermediate steps take time, and there is a much simpler solution.

We take care of it for you​

With the webPDF wsclient library, we provide a stable foundation for using the webPDF server. Parameterization, session setup, service calls and communication with the server endpoints are centrally supported so that you can focus on your application logic.

wsclient on GitHub and in Maven Central​

The publicly accessible and free wsclient library can be integrated into Java-based client applications from JDK 7 and webPDF Server Version 7 onward. We provide the library as a public project on GitHub.

Important notes:

The project is maintained and continuously developed on GitHub. Feedback, ideas and contributions are welcome. If you find problems, please report an issue after checking for duplicates, or create a pull request.

For direct integration into your project, the library is also available as a Maven package via Maven Central.

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

You can include the library in your POM as follows:

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

Using the wsclient library​

Detailed explanations and examples for using the SOAP and REST interfaces can be found in the following articles: