Java Integration Kit

Rebuilding the sample applications

As a Java developer, you can make changes to the source code for any of the sample applications for your own needs.

About this task

The source code for the sample applications is located in sample_src/<sample>/java.

As of Java Integration Kit 2.8, there are two versions of the OpenToken agent: the standard OpenToken agent, and the Jakarta EE 9 OpenToken agent. The Jakarta EE 9 OpenToken agent has its own version of the sample applications. The source code for the Jakarta EE 9 sample applications is located in the jakarta/idp and jakarta/sp files.

You can only deploy the sample Jakarta applications on servers that support Jakarta EE 9, such as Tomcat 10.1. Currently, PingFederate does not support Jakarta EE 9.

After you modify the source code, you can build and repackage the application using ant commands executed from the <sample> directory for the build.xml file included in that directory. You can package either another WAR directory or a compressed WAR file (depending on deployment needs) using the following commands:

For backward compatibility, the build.xml configuration file is set to use version 1.5 of the Java Development Kit (JDK). To recompile using the current JDK version, change the version number in the build.xml file.

Steps

  1. Create a WAR directory. From the <sample> directory, enter:

    ant
  2. Create a WAR file. From the <sample> directory, enter:

    ant war