Version 0.3.1 Changelog

Major changes

• Improved UTF-8 support: UTF-8 encoding is now used essentially whenever a File or InputStream/OutputStream object is passed into one of biweekly's reader/writer classes. Java Reader/Writer objects are not effected by this change because they are configured to use their own character encoding.
  • If a File or OutputStream object is passed into a writer class, UTF-8 encoding will be used.
  • If a File or InputStream object is passed into a plain-text iCal or jCal reader, UTF-8 encoding will be used.
  • If a File or InputStream object is passed into a xCal reader, the "encoding" attribute in the header portion of the XML document will be properly taken into account. Before, it was ignored and the document was parsed according to the JVM's default character encoding.
• Added support for the EXRULE property.
• RRULE now supports non-standard rule parts.
• "Duration" class improvements: Added the following methods to the Duration class (credit: Caruyer Perrine):
  • toMillis() - Converts the duration to milliseconds
  • add(Date) - Adds the duration to a Date object
  • diff(Date, Date) - Factory method that builds a Duration from the difference between two Dates
  • fromMillis(long) - Factory method that builds a Duration from a milliseconds value

Other changes:

• Added the ability to append onto existing files when writing plain-text files with the Biweekly class.
• The Biweekly.parse(File) methods no longer throw a FileNotFoundException.
• The ICalParameter.getRsvp() method now throws an IllegalStateException when the RSVP parameter value cannot be parsed (i.e. if it's something other than "true" or "false"). Before, it would return "null", which was misleading ("null" typically means that the parameter does not exist). Raw parameter values can still be retrieved using the get() method.
• A CannotParseException is now consistently thrown during the parsing of xCal properties when the XML element which holds the property's value cannot be found.
• When marshalling to xCard, if a property's value is null (a rare occurrence), then an empty XML element will be written (before, no element was written). This increases conformance with the xCard schema.
• Created the ICalMarshallerRegistrar class, which can be used to assign a set of custom marshallers to a reader or writer class.
• Improved the performance of plain-text iCal marshalling by optimizing string escaping functions.
• Changed JCalValue.asStructured() and JCalValue.structured() so they properly support multi-valued structured components.
• Renamed the "Value" class to "ICalDataType" and improved data type abstraction in the data model.
• Moved ValidationWarnings class from the biweekly.component package to the biweekly package.
• Renamed the following methods:
  • ICalPropertyMarshaller.Result.getValue --> getProperty
  • ICalPropertyMarshaller.getDataType --> dataType
  • JCalValue.getSingleValued --> asSingle
  • JCalValue.getMultivalued --> asMulti
  • JCalValue.getStructured --> asStructured
• Added syntax highlighting to the code samples in the Javadocs. :)

See the changelog page for the project's entire changelog history.

Maven

<dependency>
   <groupId>net.sf.biweekly</groupId>
   <artifactId>biweekly</artifactId>
   <version>0.3.1</version>
</dependency>