Update to my post:
I recently discovered that UCCX 9.0(2) and onward using the jdom2 library has a few issues which I have recently run into with a customer today. I am adding to this post with the results of my experience so that others might benefit. My comments here assume some knowledge of Computer Science / Java and how methods (function calls) work behind the scenes.
First, know that jdom2 has decided to incorporate templates (aka generics) as arguments to certain methods. This shouldn't be an issue if you don't call those methods. The issue does occur when both static and template arguments exist for the same method. I.E. the method is overridden.
The UCCX engine, as far as I can tell, has some issues discerning the datatype when the input argument isn't statically known for all instances of that method. When this occurs an exception (ambiguous method) is thrown at compile time or you'll get a Marshalling exception at runtime.
In the example above I am simply accessing an existing node and then setting its value. However, what happens if the node OVERRIDE doesn't exist? In that case we need to create it. The method do to this is called addContent. In jdom1.1 it works fine but jdom2 it has arguments that can be generics. So what seems simple just doesn't work.
Let's edit the DO statement above to check for a non existent element and add it if missing:
Do: {
jdomElement = jdomServiceFile.getRootElement().getChild("OVERRIDE");
if (jdomElement == null) {
jdomElement = new org.jdom2.Element("OVERRIDE");
jdomRootElement.addContent(jdomElement);
}
jdomElement.setText("Closed");
}
This code is valid on UCCX 8.X and lower when jdom1.1 is used. However in jdom2 'addContent' can accept templates (generics) as arguments. The UCCX engine cannot discern the datatype and throws an exception. To get around this issue you need to find a set of methods that don't offer generic types as arguments. Fortunately, JDOM2 has implemented the 'factory' methodology to assist you with creating the correct datatypes.
Lets edit the "DO' section to read.
Do: {
org.jdom2.DefaultJDOMFactory jdomFactory = new org.jdom2.DefaultJDOMFactory();
jdomElement = jdomServiceFile.getRootElement().getChild("OVERRIDE");
if (jdomElement == null) {
jdomElement = new org.jdom2.Element("OVERRIDE");
jdomFactory.addContent(jdomRootElement, jdomElement);
}
jdomElement.setText("Closed");
}
In this case the addContent method of the DefaultJDOMFactory object isn't overriden to accept templates (generics) as arguments so the UCCX Engine can add our new node to the XML tree.
Please help us make the communities better. Rate helpful posts!
Please help us make the communities better. Rate helpful posts!
