Author: rdonkin
Date: Tue Oct 31 12:11:17 2006
New Revision: 469633
URL: http://svn.apache.org/viewvc?view=rev&rev=469633
Log:
Updated notes for 0.8
Modified:
jakarta/commons/proper/betwixt/trunk/README.txt
jakarta/commons/proper/betwixt/trunk/RELEASE-NOTES.txt
Modified: jakarta/commons/proper/betwixt/trunk/README.txt
URL:
http://svn.apache.org/viewvc/jakarta/commons/proper/betwixt/trunk/README.txt?view=diff&rev=469633&r1=469632&r2=469633
==============================================================================
--- jakarta/commons/proper/betwixt/trunk/README.txt (original)
+++ jakarta/commons/proper/betwixt/trunk/README.txt Tue Oct 31 12:11:17 2006
@@ -4,8 +4,9 @@
Welcome to the Betwixt component of the Jakarta Commons
project (http://jakarta.apache.org/commons).
-Betwixt uses Maven (http://maven.apache.org) for build
-process management.
+Betwixt uses Maven 1 (http://maven.apache.org) for build
+process management. It is known to build with Maven 1.0.2
+though other versions may also work.
To build Betwixt using Maven type:
Modified: jakarta/commons/proper/betwixt/trunk/RELEASE-NOTES.txt
URL:
http://svn.apache.org/viewvc/jakarta/commons/proper/betwixt/trunk/RELEASE-NOTES.txt?view=diff&rev=469633&r1=469632&r2=469633
==============================================================================
--- jakarta/commons/proper/betwixt/trunk/RELEASE-NOTES.txt (original)
+++ jakarta/commons/proper/betwixt/trunk/RELEASE-NOTES.txt Tue Oct 31 12:11:17
2006
@@ -1,73 +1,55 @@
$Id$
- Commons Betwixt Package
- Version 0.7
- Release Notes
+ Commons Betwixt Version 0.8
+ Release Notes
INTRODUCTION:
Betwixt provides a flexible way to map beans into XML - and vice versa.
-Betwixt 0.7 is a feature release. A number of new strategies have been
-introduced to add flexibility. Improvements have been made to binding and
-introspection including improved support for polymophism. Improvements have
-been made to the dot betwixt file format including support for multiple
-specifications within the same file.
-
-Betwixt 0.7 is binary compatible with 0.6 but a number of changes have been
-made to some semantics. It is believed that the impact of these changes should
-be minimal.
+Betwixt 0.8 is a feature release. Support for polymorphic mappings has been
improved.
+More flexible mapping are possible using new strategies.
-For more details see the tasks and change log documents.
-
-KNOWN DEFECTS
- * .Betwixt file: the 'add-adder' attribute of the 'addDefaults' element is
buggy.
+Betwixt 0.8 is compatible with 0.7.
-ENHANCEMENTS AND BUG FIXES
- * Fixed bug in nested element diagnosing empty elements.
- * Added support for polymorphic mappings.
- This allows the type of a property to be guessed at bind time
- (rather than at compile time).
- * Added options to context. This replaces direct flavour mechanism.
- (Flavour becomes just a specific option).
- * Factored out id storage into strategy
- * anonymous collections now allowed in betwixt files
- * Improved introspection support for DynaBeans
- * Improved introspection for interfaces superinterface
- properties now checked.
- * Attribute suppression - Betwixt now allows the
- expression of certain values to be suppressed through a custom strategy.
- * Custom Dot Betwixt Documents - custom dot betwixt
- documents can be passed in directly.
- * Multi mapping documents allowing several mappings to be
- specified within a single document.
- * Improved support for derived beans bind time type
- population now supported and enabled by default
- * All exceptions are now complex
- * PropertySuppressionStrategy added which allows
- course grained control of those properties which should be ignored by
Betwixt.
- * Improved support for java.util collections API implementations.
- Betwixt now recognizes additional properties on custom collection
implementations.
+For more details see the tasks and change log documents.
+FEATURES
+ * Added strategies for suppression of attributes and elements at
introspection time.
+ * Improved support for natural polymorphic mappings of collection subclasses.
+ * Added support for option inheritance between parent and target mappings.
Issue #37542.
+ * Added getInheritedOption method to Context to assist with inheritance
amongst options.
+ * Added convenience constructor to DefaultIdStoringStrategy. This makes life
easier for users that want to
+ use object identity (rather than equality) when generating IDs.
+ * Added support for text and options into multi-mappings.
+ * Improved support for subclasses of Java collective types by factoring
collective type recognition into
+ strategy.
+ * Added support for multiple contained polymorphic mappings.
+ * Added transcription strategy to allow flexbility for schema type names.
+ * Added package name property suppression strategy and make default property
suppression strategy
+ public nest so that it can be subclassed.
+ * Made intitial indent level used for pretty printing configurable.
+ * Added guess-name attribute to addDefaults element in dot betwixt file. This
allows mixed collections to
+ be used with add-adders and addDefaults.
+
+
+FIXES
+ * Fixed TextRule content bug. (Issue #36930).
+ * Fixed attribute ID name recognition bug. (Issue #36929).
+ * Fixed bug when introspecting in secure environments.
+ * Fixed formatting bug when pretty printing elements with
endTagForEmptyElement is true.
+ * Fixed map custom updater in dot betwixt file bug.
+ * EOL in pretty printed xml now defaults to platform line separator.
+ * Added ValueSuppressionStrategy.suppressElement to allow elements to be
suppressed on the basis
+ of the value of the property. Useful for Hibernate users.
+ * Added forceAccessible to element tag in dot betwixt file. This allows
updater methods to be found that
+ are not public.
+
DEPRECATIONS
- * ObjectStringConverter.objectToString replaced by method without flavour
in signature
- * ObjectStringConverter.stringToObject replaced by method without flavour
in signature
+ * IdStoringStrategy.DEFAULT should never have been a constanr since the
implementation uses instance
+ variables. Using this constant will result in a memory leak. Note: use
proper factory methods rather than
+ public constant fields in the future!
+ * ElementRule added forceAccessible attribute and configureDescriptor
replaced by private method
+ with extra parameter
-SEMANTIC CHANGES
- * Betwixt now (by default) suppresses the expression of all empty
attributes.
- The old behaviour can be restored by setting the
ValueSuppressionStrategy
- of the BindingConfiguration used by the writer to
- ValueSuppressionStrategy.ALLOW_ALL_VALUES
- * Betwixt now defaults to bind time type mapping. Now read beans will (by
default)
- be populated by their bind time type (as opposed to their introspection
time type).
- Most users should notice no negative effects from this change. The
previous behaviour
- can be enabled by setting an introspection configuration property.
- * All exceptions are now complex types. This is now more consistent but
the default
- binding for exceptions in java.lang package have been changed from
simple to complex.
- * Properties on collection implementations are now recognized (rather
than ignored)
- by Betwixt. Please use an appropriate ClassNormalizer for
implementations
- that need to hide their extra properties.
-
-DEPENDENCIES
- * Upgraded commons-beanutils to 1.7.0
- * Upgraded commons-digester to 1.6
+
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
