webPDF and Java: very easy with the “wsclient” library

Minimum technical requirements

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

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 (automatable e.g. via XJC). The parameterization of the web service call can thus be mapped easily and object-oriented.

However, if you want to program a client application, the stubs alone are not sufficient. You will need code to establish the connection to the webPDF server, call the endpoints – either via the SOAP or the REST interface – and handle the retrieval of the generated results on the client side. Starting with the generation of corresponding stubs, all 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 solve all these problems for you and offer you a stable basis for the use of the webPDF server. Parameterization, session structure, call and overall communication with the endpoints of the webPDF server. The library can do all this for you, so that you can concentrate on more important things.

wsclient on Github and in Maven Central

The publicly accessible and free wsclient library can be integrated in all Java-based client applications (from JDK 7 and webPDF Server Version 7). We make the library available to them as a public project under GitHub:

https://github.com/softvision-dev/webpdf-wsclient

Important notes:

In this public project the library will be maintained by us, further developed and adapted to new versions of webPDF. Your feedback or comments and ideas for further development are always welcome. If you find problems, please report an error after searching for duplicates, or create a pull request.

For direct and easy integration into your project, we always provide the latest version of the library 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 xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <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>

Use of the wsclient library:

Detailed explanations and examples for the use of the SOAP and REST interface can be found in the following articles:

Use of the SOAP interface via webPDF wsclient

Use of the REST interface via webPDF wsclient