Adding a Java library to the DITA-OT <parmname>classpath</parmname> parameter You can use the dita.conductor.lib.import extension point to add an additional Java library to the DITA-OT classpath parameter. If necessary, compile the Java code into a JAR file. Create a plugin.xml file that contains the following code: <plugin id="plugin-id"> <feature extension="dita.conductor.lib.import" file="file"/> </plugin>where:
  • plugin-id is the plug-in identifier, for example, com.example.addjar.
  • file is the name of the JAR file, for example, myJavaLibrary.jar.
Install the plug-in. The Ant or XSLT code now can make use of the Java code.

In the following extended example, the myJavaLibrary.jar file performs a validation step during processing, and you want it to run immediately before the conref step. To accomplish this, you will need to use several features:

  • The JAR file must be added to the classpath.
  • The Ant target must be added to the dependency chain for conref.
  • An Ant target must be created that uses this class, and the Ant wrapper integrated into the code.

The files might look like the following:

<filepath>plugin.xml</filepath> file <?xml version="1.0" encoding="UTF-8"?> <plugin id="com.example.samplejava"> <!-- Add the JAR file to the DITA-OT CLASSPATH --> <feature extension="dita.conductor.lib.import" file="com.example.sampleValidation.jar"/> <!-- Integrate the Ant code --> <feature extension="dita.conductor.target.relative" file="antWrapper.xml"/> <!-- Define the Ant target that is called, and the location (before conref) --> <feature extension="depend.preprocess.conref.pre" value="validateWithJava"/> </plugin> <filepath>antWrapper.xml</filepath> file <?xml version="1.0" encoding="UTF-8"?> <dummy> <import file="calljava-antcode.xml"/> </dummy> <filepath>calljava-antcode.xml</filepath> file <?xml version="1.0" encoding="UTF-8"?> <project default="validateWithJava"> <target name="validateWithJava"> <java classname="com.example.sampleValidation"> <!-- The class was added to dost.class.path (the DITA-OT classpath) --> <classpath refid="dost.class.path"/> </java> </target> </project>