PMML Cookbook     About     Feed

JPMML-Model: Transforming and measuring the memory consumption of class model objects using the Java agent technology

Written by Villu Ruusmann on 06 Feb 2015

Java (programming language-) agent is a JVM service that is based on the Java Instrumentation API. Java agents are loaded into the JVM and activated before any Java application code is loaded. Therefore, Java agents have the unique ability to monitor and/or control the complete life-cycle of Java applications. This is typically achieved by modifying the definitions of Java class files.

SAX Locator information

The JPMML-Model library provides a class model that is rooted at abstract class org.dmg.pmml.PMMLObject. This class declares a single field locator, whose responsibility is to hold SAX Locator information. Different JAXB runtimes are able to discover and initialize this field in a completely automated fashion, because it is marked with appropriate proprietary annotations (eg. com.sun.xml.bind.annotation.XmlLocation for GlassFish Metro implementation, org.eclipse.persistence.oxm.annotations.XmlLocation for EclipseLink MOXy implementation).

Application developers can access SAX Locator information using the interface org.dmg.pmml.HasLocator.

public Locator getLocator(Object object){

  if(object instanceof HasLocator){
    HasLocator hasLocator = (HasLocator)object;

    return hasLocator.getLocator();

  return null;

The method HasLocator#getLocator() returns an instance of org.xml.sax.Locator when the PMML document was unmarshalled from a SAX source or a SAX-backed DOM source. It returns a null reference when the PMML document was unmarshalled from other types of sources, or created manually.

SAX Locator information is relevant for PMML consumers, especially in model development and model testing stages. For example, the JPMML-Evaluator library uses it to point out the exact location of the problematic class model object in the source PMML document when throwing a subclass of org.jpmml.manager.PMMLException. However, if the quality assurance process is up to the challenge, then there should be no place for such debugging work in the final model deployment stage.

Conversely, SAX Locator information is absolutely irrelevant for PMML producers. For example, it cannot be used to order the JAXB runtime to format the PMML document in a specific way when marshalling.

This leads to the conclusion that, more often than not, it would be desirable to get rid of the field locator in a safe and easy manner. The main benefit of doing so is that it reduces the memory consumption by 25-30%. Given that RAM is cheap and plentiful nowadays, this optimization becomes economically rational to pursue when the application needs to deploy a large number of ensemble models (eg. Random Forest models) in parallel. The added benefit is that the unmarshalling time is reduced in the same proportion.

Activating the JPMML agent

JPMML agent is part of the JPMML-Model library project. JPMML agent depends on the Javassist library for its Java class file transformation functionality. Both the JPMML agent JAR file and the Javassist JAR file can be downloaded from the Maven Central repository:

The following example assumes that the Java application is packaged into an executable JAR file myapplication.jar and the name of the main class is com.mycompany.myapplication.Main.

Executing the application:

$ java -jar myapplication.jar

JPMML agent is loaded into the JVM using the -javaagent option. It takes an optional boolean argument transform, which indicates if the field locator should be deleted (true) or not (false):

Executing the application with the JPMML agent in "non-transforming mode":

$ java -javaagent:pmml-agent-1.1.14.jar -jar myapplication.jar

Executing the application with the JPMML agent in "transforming mode":

$ java -javaagent:pmml-agent-1.1.14.jar=transform=true -cp javassist-3.19.0-GA.jar:myapplication.jar com.mycompany.myapplication.Main

If the JAR file myapplication.jar does not contain Javassist classes, then they need to be added to the application classpath by other means. The JVM ignores the -cp option when the -jar option is set. Therefore, in the last command, the application classpath is crafted manually by "prepending" the Javassist JAR file to the application JAR file, and the name of the main class is spelled out in full.


Transformation is performed by the class org.jpmml.agent.PMMLObjectTransformer. The current implementation is naive, because the SAX Locator information is omitted simply by deleting the field locator. A more sophisticated implementation could perform a series of "push down" refactorings, so that this field is preserved for subclasses that are associated with more error-prone PMML content.

Java source code representation of the class PMMLObject before transformation:

package org.dmg.pmml;


import javax.xml.bind.annotation.XmlTransient;

import org.xml.sax.Locator;

public class PMMLObject implements HasLocator, Serializable {

  private Locator locator = null;

  public Locator getLocator(){
    return this.locator;

  public void setLocator(Locator locator){
    this.locator = locator;

The same after transformation:

package org.dmg.pmml;


import org.xml.sax.Locator;

public class PMMLObject implements HasLocator, Serializable {

  public Locator getLocator(){
    return null;

  public void setLocator(Locator locator){

This transformation should be completely safe and undetectable from the Java application perspective.

Memory measurement

Memory measurement is performed by the class org.jpmml.model.visitors.MemoryMeasurer that traverses a class model object first by JPMML-Model Visitor API and then by Java Reflection API. This Visitor maintains a set of distinct objects that are reachable from the specified "root" object. The size of individual objects is approximated using the method java.lang.instrument.Instrumentation#getObjectSize(Object). The total size of the class model object is calculated by summing the sizes of set members.

The decision to implement yet another memory measurement tool (as opposed to reusing some existing tool, eg. Java Agent for Memory Measurements) is supported by specific traits of the JPMML-Model class model:

Java source code of a simple application that outputs basic information about a class model object:

public class Main {

  public void main(String... args) throws Exception {
    PMML pmml;

    InputStream is = new FileInputStream(args[0]);

    try {
      pmml = JAXBUtil.unmarshalPMML(new StreamSource(is));
    } finally {

    MemoryMeasurer measurer = new MemoryMeasurer();

    Set<Object> objects = measurer.getObjects();
    System.out.println("The number of distinct objects in the object graph: " + objects.size());

    long size = measurer.getSize();
    System.out.println("The size of the object graph: " + size + " bytes");

Memory measurements are performed on the already familiar PMML document "RandomForestIris.pmml".

The results in "non-transforming mode":

$ java -version
java version "1.8.0_31"
Java(TM) SE Runtime Environment (build 1.8.0_31-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.31-b07, mixed mode)

$ java -javaagent:pmml-model-1.1.14.jar -cp javassist-3.19.0-GA.jar:example.jar Main RandomForestIris.pmml
The number of distinct objects in the object graph: 373
The size of the object graph: 13680 bytes

The results in "transforming mode":

$ java -javaagent:pmml-model-1.1.14.jar=transform=true -cp javassist-3.19.0-GA.jar:example.jar Main RandomForestIris.pmml
The number of distinct objects in the object graph: 271
The size of the object graph: 9920 bytes

All the differences between these two object graphs are solely attributable to the omission of SAX Locator information. It can be seen that instances of org.xml.sax.Locator make up (373 - 271) / 373 = 27.3% of distinct objects and (13680 - 9920) / 13680 = 27.5% of memory consumption.

comments powered by Disqus