CookXml is a unique XML data binding engine in Java. It is capable mapping XML documents of desired format directly onto the corresponding object-oriented classes, essentially treating XML as a programming language rather than merely a data storage format. Therefore, it is ideal to use CookXml to write any programs that interprets XML. The tag library of CookXml is constructed dynamically at run time, and thus allows dynamic XML schema. The current implementation has unmarshaling part done.
CookXml is free software, distributed under a permissive, X11 style, licence.
CookXml offers the ability to directly mapping XML documents onto existing classes by breaking down the process into three general steps. Then use a set of delegates, together forming a tag library, to handle actions performed at these steps.
- Object creation. Each element tag corresponds to an object instance. The action to create the object instance corresponds to a creator in CookXml.
- Property setting. Each attribute of the XML element corresponds to setting a property of the object instance. This property can be handled by a setter in CookXml. For languages that offer reflection, such as Java and C#, such property setting can be automatically detected using reflection. In these cases, to match the string attribute value to the target property class type, a converter is necessary.
- Add action. When CookXml obtains an object corresponding to an element tag, it is "added" to the parent object corresponding to the parent element tag. The specific add action is handled by an adder in CookXml.
Save for CDATA nodes, the three above types of actions can handle all elements in an XML document. CDATA in general can be handled either in the creator function or the adder function.
Creators, setters, adders, and converters together form a tag library which is used by the CookXml engine to perform the XML data binding.
Dynamic Tag Library Construction
Because CookXml tag library uses delegates, its tag library needs to be dynamically constructed. This feature is both good and bad. It is bad because there will be a slight initiation cost when the tag library is constructed, and its integrity may not be verified until runtime. It is also good because it allows developers to easily extend an existing tag library at run time.
Preorder and Postorder Addition
Like any trees that can be traversed in preorder and postorder, the object corresponding to an XML element can be added to the parent object in preorder or postorder. In the preorder addition, the object is added to the parent before descendant XML elements get processed. In the postorder addition, the object is added to the parent after descendant XML elements get processed.
XML Tag Inheritance
One discovery made while writing CookXml was that class inheritance of Object-oriented languages can be mirrored into XML element tag inheritance. Semantically, tag inheritance means that the derived tag will inherit the setters and adders of the inherited tags.
For example, javax.swing.JMenu is a child class of javax.swing.JMenuItem. Assuming that javax.swing.JMenu is mapped to <menu> tag and javax.swing.JMenuItem is mapped to <menuitem> tag, then we can declare in CookXml that <menu> tag inherits <menuitem> tag. <menu> tag then inherts the setters for attributes such as "text" and "icon" of the <menuitem> tag.
Polymorphisms of OOP can be mirrored in XML tag inheritance as well. Class casting is similar to dynamically renaming the current namespace and the tag of the element being processed.
XML tag inheritance is a methodology not present in any other XML data binding tools. This feature is immensely useful in mapping XML documents to classes with deep inheritance hierarchy, typically found in GUI API. Thus CookXml is useful in writing XUL motors. CookSwing and CookSwt are two such examples for mapping XML documents to Swing and SWT classes.
Since version 3.0, CookXml is capable of dealing XML documents with multiple namespaces. For backward compatibility, CookXml also parse XML documents without namespaces or partially utilizing namespaces.
Other Implementation Details
As of version 3.0, CookXml operates on top of XML DOM tree to map an XML document to objects. This feature allows developers to utilize XML schema if such exist to verify the incoming XML documents. On the other hand, the memory consumption for a large XML document can be problematic.
Schema and Documentation Generation
Since a tag library for CookXml contains all the mappings between an XML element and its corresponding object classes, it is entirely possible to use this map to generate documentations from this feature. The documentation output can be HTML documents, or XML Schemas.
CookXmlDoc, a doclet API for CookXml can extract Javadoc tags and comments from the tag library source code. The resulting information can in turn be used by an HTML doclet can then generate the appropriate tag documentations. See CookSwing Tag Documentation for an example.
Streaming is a key feature that is under consideration. Such capability would reduce the memory consumption due to the construction DOM tree as well as improving the overall performance.
Wikimedia Foundation. 2010.
Look at other dictionaries:
SAX — (Simple API for XML) is a serial access parser API for XML. SAX provides a mechanism for reading data from an XML document. It is a popular alternative to the Document Object Model (DOM). XML processing with SAX A parser which implements SAX (ie … Wikipedia
XML data binding — refers to the process of representing the information in an XML document as an object in computer memory. This allows applications to access the data in the XML from the object rather than using the DOM to retrieve the data from a direct… … Wikipedia
List of user interface markup languages — The following is a list of user interface markup languages categorized by vendor or platform.Flash*MXML *OpenLaszloJava*CookSwing [http://cookxml.sourceforge.net/cookswing/] *SwiXML [http://swixml.org] *SwixNG [http://swixng.sourceforge.net]… … Wikipedia
Apache XMLBeans — Maintainer David Bau, Cesar Andrei, Patrick Calahan et.al. Aktuelle Version 2.5.0 (14. Dezember 2009) … Deutsch Wikipedia
Java Architecture for XML Binding — (JAXB) Maintainer Metro Projekt Entwickler Sun Microsystems Aktuelle Version 2.2.4 update 1 (8. Juni 2011) Betriebssystem Plattformunabhängig … Deutsch Wikipedia
JiBX — Maintainer Dennis Sosnoski Aktuelle Version 1.2.2 (15. Februar 2010) Betriebssystem plattformunabhängig Programmiersprache Java Ka … Deutsch Wikipedia