MQSeries.net :: View topic

Esa · Posted: Wed Jan 25, 2012 2:35 pm Post subject:

In Message Broker Java API (V8 ) and in Message Flow API (V7), Node class has methods addNsmapping(), removeNsmapping() and getNsmappingtables(). Used for adding, removing and listing NamespacePrefixMap objects associated with the Node.

Obviously NamespacePrefixMap objects are used for replacing default or generated namespace prefixes. But the documentation does not tell how the nodes are making use of them and how, or which nodes are actually making use of them.

Are they used by compute nodes to override what has been set with DECLARE NAMESPACE? I doupt that.

The only use i could think of is an output node telling the (XMLNSC) parser to replace generated namespace prefixes with the mapped in the serialized output message.

Could not find any examples. The documentation of NamespacePrefixMap represents a standard entry in these javadocs - many of the classes I have checked have almost the same description.

By the way, NamespacePrefixMap has these methods:

getnamespace()
getNsPrefix()
setNamespace()
setNsPrefix()

I hope/fear that getnamespace() will in the future be deprecated and replaced with getNamespace()...

There is similar inconsistency in naming accross the javadoc, that has not been corrected in V8. It seems that not very many customers are actually using these APIs (which are designed to be used for modifying generated pattern instances, not for implementing message transformations or similar runtime functionality).

But I would like to remind that it would be much easier to correct these things now than later when customers have started using them.

In fact, I was examining something else when this come up as a typical example of the quality of the API documentation.