| 1 |
|
| 2 |
= Release 1.4 = |
| 3 |
|
| 4 |
== New Features == |
| 5 |
|
| 6 |
* Document: New method iterator() |
| 7 |
* New tools to map a document to a Java class |
| 8 |
|
| 9 |
== Bug Fixes == |
| 10 |
|
| 11 |
== Breaking Changes == |
| 12 |
|
| 13 |
== Planned Features == |
| 14 |
|
| 15 |
* Pass all tests of the "XML W3C Conformance Test Suite" (and not only the |
| 16 |
"standalone+valid" ones). |
| 17 |
* Allow to specify a resolver for external resources (DTDs, XML Schema, etc). |
| 18 |
* Better API to create and modify DTD structures |
| 19 |
* Raise test coverage to the max, again (it's currently "only" 89.5% mostly due |
| 20 |
to the incomplete DTD API). |
| 21 |
* Extract code to parse DTDs into an independent class (currently, it's in |
| 22 |
XMLParser where it doesn't really belong). That would also be a nice test |
| 23 |
case for how to extend the standard XML parser. |
| 24 |
* Create an API to verify the structure of a document or a subtree against |
| 25 |
a DTD or using custom code. |
| 26 |
|
| 27 |
= Release 1.3 = |
| 28 |
|
| 29 |
== New Features == |
| 30 |
|
| 31 |
* Element: New methods to set and remove attributes |
| 32 |
* Copying of nodes (like clone() but without a checked exception) |
| 33 |
* Support for namespaces |
| 34 |
* Text: New methods getTrimmedText() and getNormalizedText() |
| 35 |
* Token: New method getPrefixWhiteSpace() |
| 36 |
* XMLParser: New method `static parse(File)` |
| 37 |
* XMLWriter can now format (a.k.a pretty print) the document on the fly |
| 38 |
|
| 39 |
== Bug Fixes == |
| 40 |
|
| 41 |
== Breaking Changes == |
| 42 |
|
| 43 |
* Attribute instances can now store the whitespace before the name |
| 44 |
and around the equals sign |
| 45 |
* XMLTokenizer.Type.ELEMENT_WHITESPACE is now DTD_WHITESPACE |
| 46 |
* Attribute.getValue() and setValue() now work on the attribute value |
| 47 |
instead of the XML output. Attribute.getAttributeValue() |
| 48 |
* Static helper Attribute.toXML(name,value,quoteChar) has been deleted. |
| 49 |
|
| 50 |
= Release 1.2 = |
| 51 |
|
| 52 |
== New Features == |
| 53 |
|
| 54 |
* Support for DTDs (reading and writing; there is no verifier, yet). |
| 55 |
* Sorted tests into different files to make it easier to find them again |
| 56 |
* Added a couple of helper methods to XMLUtils to check if a node is |
| 57 |
a text, an element or an attribute. |
| 58 |
* To allow to extend Element and Attribute in custom classes, |
| 59 |
setType() is now protected. |
| 60 |
* New method: Parent.clearNodes() to clear all child nodes |
| 61 |
* New method: Element.childIndexOf() to get the index of a child element |
| 62 |
* You can now chose to parse entities, resolve them or treat them as |
| 63 |
plain text. |
| 64 |
* There is a class which can expand all HTML entities (HTML 2.0 - 4.0 and XHTML). |
| 65 |
* Nodes which contain text now offer getText() and setText(). |
| 66 |
* ProcessingInstruction is now modeled more closely after the XML spec. It |
| 67 |
has a target and an optional text. |
| 68 |
* Moved code to handle the XML declaration into a new class |
| 69 |
XMLDeclaration |
| 70 |
* New class Location which can figure out the line and column of a node |
| 71 |
* New class XMLWriter which keeps track of the node that is currently being |
| 72 |
written. This is used in Location to find the position of a node in the |
| 73 |
resulting XML document or partial tree. |
| 74 |
* Improved error messages to show the best location info possible. In many |
| 75 |
cases, the information in XMLParseException is good enough to use it in |
| 76 |
an online editor. |
| 77 |
* DecentXML can now parse simple DTDs. Most of the information is ignored and |
| 78 |
just stuffed into lists of nodes, though. |
| 79 |
* Switched to JUnit 4.4 and maven-javadoc-plugin 2.5. |
| 80 |
* DecentXML passes all tests of the "XML W3C Conformance Test Suite" |
| 81 |
(http://www.w3.org/XML/Test/xmlconf-20031210.html) which are marked as |
| 82 |
"valid" and "standalone" (i.e. no external references). |
| 83 |
It probably also passes all the other "valid" tests but since they |
| 84 |
refer to external DTD files (which DecentXML doesn't currently load), |
| 85 |
running them would be futile. |
| 86 |
* Improved error messages. Many of them now contain a piece of the XML |
| 87 |
where the error occurred to make it easier to locate this spot without |
| 88 |
an editor which shows line and column numbers. |
| 89 |
|
| 90 |
== Bug fixes == |
| 91 |
|
| 92 |
* Element.clearChildNodes() now only deletes elements; it used to |
| 93 |
delete all nodes. |
| 94 |
|
| 95 |
== Breaking Changes == |
| 96 |
|
| 97 |
* Removed XMLParser.escapeXML(). Use XMLUtils.escapeXML() instead. |
| 98 |
* Extracted Token into a top level class |
| 99 |
* Deleted XMLTokenizer.isXMLIdentifier() and replaced it with several |
| 100 |
helper methods: XMLTokenizer.isNameChar(), XMLTokenizer.isNameStartChar() |
| 101 |
and XMLTokenizer.parseName() |
| 102 |
|
| 103 |
== Deprecations == |
| 104 |
|
| 105 |
* Element.getNodePath() renamed to Element.getChildPath(). |
| 106 |
getNodePath() is now deprecated. |
| 107 |
* Element.clearChildNodes() is deprecated, use Element.clearChildren() instead |
| 108 |
|
| 109 |
= Release 1.1 = |
| 110 |
|
| 111 |
== New Features == |
| 112 |
|
| 113 |
* Added copyright notice |
| 114 |
* Added documentation |
| 115 |
* Support to manipulate the XML declaration in the document |
| 116 |
* Added Eclipse project files |
| 117 |
* There is an unescapeXML() method in XMLUtils. |
| 118 |
* Code in BasicNode is better protected against NPEs |
| 119 |
* A lot of private methods have been made public or at |
| 120 |
least protected to allow better reuse. |
| 121 |
* Added more methods to Document to manipulate nodes. |
| 122 |
* Added parent/child relations |
| 123 |
* Elements can be asked for their path in the document and |
| 124 |
you can search elements by path |
| 125 |
* Code cleanup |
| 126 |
|
| 127 |
== Breaking Changes == |
| 128 |
|
| 129 |
* Element.getChild() was renamed to Element.getNode() to make the API |
| 130 |
naming more consistent. A "node" is something derived from Node, |
| 131 |
while a child is always an instance of Element. |
| 132 |
* The text for the type PROCESSING_INSTRUCTION has changed from |
| 133 |
"PI" to "PROCESSING_INSTRUCTION". |
| 134 |
* If a token has no type, toString() will now contain "null" instead |
| 135 |
of "***". |
| 136 |
* XMLTokenizer.Token.typeToString() was deleted. Use Token.getType().toString() |
| 137 |
if you must. |
| 138 |
|
| 139 |
== Deprecations == |
| 140 |
|
| 141 |
* XMLParser.escapeXML() has moved to XMLUtils.escapeXML() |
| 142 |
|
| 143 |
= Release 1.0 = |
| 144 |
|
| 145 |
Initial release. |