Return-Path: Delivered-To: apmail-jakarta-commons-dev-archive@apache.org Received: (qmail 27747 invoked from network); 25 Jan 2003 20:15:29 -0000 Received: from exchange.sun.com (192.18.33.10) by daedalus.apache.org with SMTP; 25 Jan 2003 20:15:29 -0000 Received: (qmail 20410 invoked by uid 97); 25 Jan 2003 20:16:55 -0000 Delivered-To: qmlist-jakarta-archive-commons-dev@jakarta.apache.org Received: (qmail 20393 invoked by uid 97); 25 Jan 2003 20:16:54 -0000 Mailing-List: contact commons-dev-help@jakarta.apache.org; run by ezmlm Precedence: bulk List-Unsubscribe: List-Subscribe: List-Help: List-Post: List-Id: "Jakarta Commons Developers List" Reply-To: "Jakarta Commons Developers List" Delivered-To: mailing list commons-dev@jakarta.apache.org Received: (qmail 20381 invoked by uid 97); 25 Jan 2003 20:16:54 -0000 X-Antivirus: nagoya (v4218 created Aug 14 2002) Date: 25 Jan 2003 20:15:21 -0000 Message-ID: <20030125201521.69838.qmail@icarus.apache.org> From: rdonkin@apache.org To: jakarta-commons-cvs@apache.org Subject: cvs commit: jakarta-commons/betwixt/xdocs tasks.xml navigation.xml overview.xml todo.xml X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N rdonkin 2003/01/25 12:15:21 Modified: betwixt Tag: BETWIXT_1_0_ALPHA_1_RELEASE_BRANCH RELEASE-NOTES.txt project.xml betwixt/xdocs Tag: BETWIXT_1_0_ALPHA_1_RELEASE_BRANCH navigation.xml overview.xml Added: betwixt/src/resource Tag: BETWIXT_1_0_ALPHA_1_RELEASE_BRANCH dotbetwixt.dtd betwixt/xdocs Tag: BETWIXT_1_0_ALPHA_1_RELEASE_BRANCH tasks.xml Removed: betwixt/xdocs Tag: BETWIXT_1_0_ALPHA_1_RELEASE_BRANCH todo.xml Log: Added DTD from main branch. Also renamed todo.xml to tasks.xml (so that it's compatible with maven). Also updated release notes. Revision Changes Path No revision No revision 1.1.2.6 +21 -12 jakarta-commons/betwixt/RELEASE-NOTES.txt Index: RELEASE-NOTES.txt =================================================================== RCS file: /home/cvs/jakarta-commons/betwixt/RELEASE-NOTES.txt,v retrieving revision 1.1.2.5 retrieving revision 1.1.2.6 diff -u -r1.1.2.5 -r1.1.2.6 --- RELEASE-NOTES.txt 19 Jan 2003 17:44:53 -0000 1.1.2.5 +++ RELEASE-NOTES.txt 25 Jan 2003 20:15:20 -0000 1.1.2.6 @@ -4,12 +4,17 @@ Version 1.0-Alpha-1 Release Notes - INTRODUCTION: -This is the first release for betwixt. Betwixt provides a flexible way to map beans into XML - and vice versa. +Betwixt provides a flexible way to map beans into XML - and vice versa. This is the +first betwixt release. -There's quite a lot of work to be done before Betwixt is ready for a full release - but it's already used by other projects. This alpha will give a versioned release for these projects to depend on. A word of warning - though the developers take backwards compatible very seriously, it's likely that some parts of the internal API are going to have to change - and some of these changes may break compatibility. Obviously, these changes will be kept to a minimum. +There's quite a lot of work to be done before Betwixt is ready for a full +release - but it's already used by other projects. This alpha will give a +versioned release for these projects to depend on. A word of warning - though +the betwixt developers take backwards compatible very seriously, it's likely that +some parts of the internal API are going to have to change - and some of these +changes may break compatibility. NEW FEATURES: @@ -18,19 +23,23 @@ But here's some features you might like to take a look at: * Betwixt can write beans to character streams or as SAX events -* Betwixt builds on Digester (http://jakarta.apache.org/commons/digester.html) to allow xml to be read (using SAX) and mapping into beans in a compatible way -* Betwixt supports powerful pluggable general strategies but also allows mappings to be customized at the bean level. +* Betwixt builds on Digester (http://jakarta.apache.org/commons/digester.html) + to allow xml to be read (using SAX) and mapping into beans in a compatible way +* Betwixt supports powerful pluggable general strategies but also allows mappings + to be customized at the bean level. BUG FIXES: KNOWN LIMITATIONS: -* This release of betwixt does not validate the element and attribute names specified in .betwixt files to ensure that they will produce well formed xml. Please take care to ensure that the names you choose for you elements and attributes will result in well formed xml. -* Betwixt is not usable for swing components, unless you write a wrapper class around the Swing component. - The XMLEncoder that is used in JDK 1.4.x does a better job in this, by analyzing what - is needed based on what clone() does and custom processing for swing components. - If you really need this and are writing wrappers around swing components,please contribute - it to the betwixt project. +* This release of betwixt does not validate the element and attribute names + specified in .betwixt files to ensure that they will produce well formed xml. + Please take care to ensure that the names you choose for you elements and + attributes will result in well formed xml. +* Betwixt is not usable for swing components, unless you write a wrapper class + around the Swing component. The XMLEncoder that is used in JDK 1.4.x does a + better job in this, by analyzing what is needed based on what clone() does and + custom processing for swing components. If you really need this and are writing + wrappers around swing components, please contribute it to the betwixt project. - 1.21.2.2 +5 -4 jakarta-commons/betwixt/project.xml Index: project.xml =================================================================== RCS file: /home/cvs/jakarta-commons/betwixt/project.xml,v retrieving revision 1.21.2.1 retrieving revision 1.21.2.2 diff -u -r1.21.2.1 -r1.21.2.2 --- project.xml 19 Jan 2003 14:43:34 -0000 1.21.2.1 +++ project.xml 25 Jan 2003 20:15:20 -0000 1.21.2.2 @@ -4,17 +4,18 @@ ../project.xml Betwixt commons-betwixt - 1.0-alpha-1 + 1.0-alpha-1RC1 2002 Commons Betwixt Commons Betwixt: mapping beans to XML http://jakarta.apache.org/commons/betwixt/ + - 1.0-alpha-1 - 1.0-alpha-1 - 1.0-alpha-1 + 1.0-alpha-1RC1 + 1.0-alpha-1RC1 + 1.0-alpha-1RC1 No revision No revision 1.1.2.1 +36 -0 jakarta-commons/betwixt/src/resource/Attic/dotbetwixt.dtd No revision No revision 1.3.2.1 +1 -1 jakarta-commons/betwixt/xdocs/navigation.xml Index: navigation.xml =================================================================== RCS file: /home/cvs/jakarta-commons/betwixt/xdocs/navigation.xml,v retrieving revision 1.3 retrieving revision 1.3.2.1 diff -u -r1.3 -r1.3.2.1 --- navigation.xml 2 Jan 2003 11:44:32 -0000 1.3 +++ navigation.xml 25 Jan 2003 20:15:21 -0000 1.3.2.1 @@ -10,7 +10,7 @@ - + 1.11.2.1 +1 -1 jakarta-commons/betwixt/xdocs/overview.xml Index: overview.xml =================================================================== RCS file: /home/cvs/jakarta-commons/betwixt/xdocs/overview.xml,v retrieving revision 1.11 retrieving revision 1.11.2.1 diff -u -r1.11 -r1.11.2.1 --- overview.xml 5 Jan 2003 16:27:16 -0000 1.11 +++ overview.xml 25 Jan 2003 20:15:21 -0000 1.11.2.1 @@ -100,6 +100,7 @@ + @@ -107,7 +108,6 @@ - No revision No revision 1.3.2.1 +41 -23 jakarta-commons/betwixt/xdocs/tasks.xml Index: tasks.xml =================================================================== RCS file: /home/cvs/jakarta-commons/betwixt/xdocs/tasks.xml,v retrieving revision 1.3 retrieving revision 1.3.2.1 diff -u -r1.3 -r1.3.2.1 --- tasks.xml 19 Jan 2003 23:25:53 -0000 1.3 +++ tasks.xml 25 Jan 2003 20:15:21 -0000 1.3.2.1 @@ -171,40 +171,58 @@ - -
- + +
  • - Created DTD for .betwixt files. + Using \n as default and now shows a warning when an invalid space character is used.
    + Adding a check to only accept valid characters as lineEndings, so parsers actually + won't choke on the output xml. + BeanWriter should have a setEndOfLine() method to allow configurable EOL strings, defaulting to "\n"
  • - Added validity check for element and attribute names in .betwixt files - .betwixt files contain names for xml elements and attributes. Only certain names - for elements and attributes are allowed by the xml specification. Betwixt now - check to ensure that the names are appropraite and terminates processing with an - Exception if they are not. + Create a SAXWriter class in the io package that takes a bean and writes to a SAX ContentHandler + rather that outputting textual XML like BeanWriter does. + This will allow Betwixt to work nicely in XML pipelining environments like Cocoon and Jelly. +
    • +
  • digester.peek() was giving warning. Now checking if it still has something to peek. + Currently betwixt causes digester to output a warning '[WARN] Digester - -Empty stack (returning null)'. + We should patch the way betwixt uses digester to avoid this warning message.
  • - Created XMLUtils - Separated out basic xml utilty methods into a static utility class called XMLUtils. - This should allow them to be reused in isolation. + Add description of digester-related limitation to FAQ
    • -
- -
-
- -
    -
  • - BeanWriter.escapeAttributeValue() moved into XMLUtils +
  • + Upgrade To Latest Dependencies + Check that betwixt works with the latest versions of the dependent + Replace all references to deprecated methods. +
    • +
  • + Add read and write examples + Add simple read and write examples to getting started section.
    • -
  • - BeanWriter.escapeBodyValue() moved into XMLUtils +
  • + Add strategy documentation. + This needs to be added to the main documentation. + Example code needs to be created. + This code can also be used for more test cases. +
    • +
  • + Add XMLRegistry documentation. + Add documentation about XMLRegistry to main documentation. +
    • +
  • + Add XMLIntrospector Setting Documentation. + Add documentation about the XMLIntrospector settings to main documentation. + Make sure that warnings are added about consequences of changing settings. +
    • +
  • + Improve Java Docs. + Go through java docs, add any which are missing, correct any mistakes etc.
-
+ -- To unsubscribe, e-mail: For additional commands, e-mail: