Represents the entire Javadoc Doclet API as a virtual XML document (called Data Source Model or Doclet DSM).
DSM Type is a mapping of the Doclet API classes and methods on DSM elements and attributes.
This is the second (current) version of such a mapping introduced since DocFlex/Javadoc v1.5.6. It is different from the old one just in a few places.
The reason why the new mapping (DSM Type) was needed is the support
of the notion of parent element:
a new GOMElement.parent
property and findAncestor()
function have been introduced.
(Later, there will be also a special Location Path axis 'parent'
.)
The notion of parent element is opposite to the notion of child element.
If element1
is a child of element2
, then
element2
must be the parent of element1
.
In particular that means, given
the following must be true:element1 = element2.findChild ("SomeElementType");
For the old mapping, that is not always true (in all situations). The new DSM Type fixes this.element1.parent.id == element2.id