2007-06-17, util 2.2.3

2007-06-16, util 2.2.2

SourceCode2Html colorization not taken into account: fixed
SourceCode2Html HTML generated files lines numbers unaligned: fixed
New util.parsers.partial package for reserved (internal) parsers
util.app.html.HtmlWeights and util.app.html.HtmlDecorations classes added
util.app.html.HtmlPresentation changes to deal with new util.app.html classes
MultipleDataParser subparser change and end of block comments parsing errors fixed
FileDownloader: wrong downloaded files encoding and content types fixed
New DataDownloader class to handle streams downloads. FileDownloader now inherits from DataDownloader
HtmlFormat 'formatToHtml' and 'formatAllToHTML' changed so that '>>' is replaced with '»' in 'formatAllToHTML' operation only

util.app.html Cpp2Html and Xml2Html translaters added
util.app.html.SourceCode2Html colors and styles NullPointerException bug fixed
SourceCode2Html new operations added to handle arguments which derive from Writer (such as PrintWriter and JspWriter)
FormParams temporay files wrong location (and name) bug fixed
JSP form examples last form submission crash fixed

Many deep HTTP forms parsing and constraints checking changes which make this version non backward-compatible with previous version. Please refer to JSP examples for change
FormProperties now offers an XML-encoding and decoding ability
FormConfiguration class added to deal with global forms constraints
FileParamConstraints and FormParams: expected content types management operations added
FormParams now raises specific exceptions rather than generic ParamConstraintException errors
util.web.FileDowloader class to force files downloads added
Child 'addAttribute' operations renamed to 'setAttribute'
Child 'setChild' and 'setChildren' operations added
GenericXMLTransportable abstract class added
Resetable interface added
util.misc.Digest: stream reading error fixed
API improvements
JSP form examples updated to take util 2.2.0 version changes into account (and new design). Constrained file upload regex fixed, files content types checks added
JSP file download example added

FormParams: uploading file greater than maximum size allowed generated a null pointer exception: fixed
FormParams: XML description file parsing error on 'forms' tag fixed
FormParams: 'formDesc' DTD modified
FormParams 'hasParamValue' renamed to 'hasParam'
ParamsConstraints 'destroyOnError' and 'isDestroyedOnError' operations added
util.web.form.error classes modified to access FormParams instance when an error is raised
util.Digest and util.DigestAlogrithm classes added to support streamed message digests
Minor javadoc improvements
JSP form examples updated: files uploads forms with a new "overwrite" parameter

FormParams: multiple mandatory fields bug fixed
FormValidationConstraintException constructor changed to take a variable number of arguments
Javadoc improvements
JSP form examples updated: include an extra HTML form with email validation and identical password values verification

FormParams changes so that empty or unchecked parameters values are no more registered (to get a similar behaviour independently from submission methods)
StringManager 'findIndex' bug introduced in version 2.1.3 fixed
StringManager 'isInside' operations change to take a variable number of arguments
ParameterConstraints 'isMaxValuesConstrained' renamed to 'isMaxOccurrencesConstrained'
ParameterConstraints 'setMinOccur(int)', 'getMinOccur' and 'isMinOccurrencesConstrained' operations added
Javadoc improvements
JSP form examples updated to take util 2.1.5 'FormParams' modifications

FileManager files listing added
StringManager 'findIndex' bug introduced in version 2.1.3 fixed
StringManager 'isInside' operations change to take a variable number of arguments
ParameterConstraints 'isMaxValuesConstrained' renamed to 'isMaxOccurrencesConstrained'
ParameterConstraints 'setMinOccur(int)', 'getMinOccur' and 'isMinOccurrencesConstrained' operations added
FormParams modified to take ParameterConstraints new constraints into account
Zip class is expected to be deeply modified and thus should not be used until changes are performed
Javadoc improvements
JSP form examples updated to add complementary information and manage forms submission methods errors

FormParams bug when files destination directory was not created fixed
FormFileElement 'getFile()' and 'getFile(int)' operations renamed to 'getValue()' and 'getValue(int)'
FileElement 'copyTo' overload to take one more argument for automatic uploaded files destination directory creation
util.codec.xml.XMLEncodable interface 'toXML' operation overloaded to mention a specific charset
util.codec.xml.NodeManager moved to util.codec.xml.dom subpackage and made unavailable out of this package
util.codec.xml.dom.XML 'getBuilder()' operation declared private
Some javadoc improvements
JSP form examples updated to reflect API changes and automatically create uploaded files destination directory

FormParams file elements constraints now include expected values (which apply to file names)
ParamConstraints parameter validation constraints new operations added
ParamConstraints hasExtraValidations() renamed to isExtraValidationsConstrained()
Some other javadoc improvements
JSP form examples removed from the API and integrated to the 'examples' section of the website

XML classes changes and packages reorganization:
- ParserConfigurationException not raised anymore by many util.codec.xml package methods
- util.codec.xml.XMLTransformable interface created and used by util.codec.xml.dom.XML class
- util.codec.xml.Encoding enumeration created
- NodeManager class moved from util.codec.xml.dom to util.codec.xml
RSS classes changes and packages reorganization:
- util.codec.rss.rss2 package created
- RSSData renamed RSSFeed to hold different RSS versions
- util.codec.xml.XMLEncodabe interface added
- RSSFeed implements XMLEncodable and XMLTransformable interfaces
- JSP form examples updated (constrained form submission bug corrected)

util.codec classes (excluding inner packages) moved to util.codec.misc package
Child.addChild does not duplicate appended child anymore
Child.hasAttribute operations addded
Child.hasChild added
Children.hasChild added
util.codec.rss package created
util.codec.xml package now handles CDATA sections
SAX exception not thrown anymore from util.codec.xml package: replaced by XMLException
util.codec.xml.NodeValue class created
util.format.TimeManager renamed to util.format.TimeFormat
Added TimeFormat dateFormat(String, DateFormat) to convert from stringified date to Calendar
Added email validation to util.StringManager
Forms automatic validation DTD example update
A few documentation updates

util.web.form.FormParams uploaded files names regular expressions matching failed with IE 7: fixed
JSP form examples updated