You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@commons.apache.org by Ev...@national.com.au on 2004/08/20 05:16:58 UTC
specifying .betwixt file to use
Hi All,
I've been looking at mapping our java objects to xml using .betwixt files.
We have a number of xml formats that we want to use and we are reusing same
objects for each xml message. The question is - can I specify which
.betwixt file I want to use when converting my java object to xml?
your help would be greatly appreciated
Evgueni Iakhontov
This email is sent by or on behalf of the named sender identified above. If
you do not wish to receive any email marketing material from this person in
the future, please forward the contents of this email to
unsubscriptions@national.com.au with the word "unsubscribe" in the subject
box. If you do not forward the contents of this email with your
unsubscription then it may not be able to be implemented. If you wish to
unsubscribe from all central email marketing lists used by our business,
please forward the contents of this email to
unsubscriptions@national.com.au with the message "unsubscribe from all
central email marketing lists" in the subject box. If you do not forward
the contents of this email with your unsubscription then it may not be able
to be implemented.
The information contained in this email communication may be confidential.
You should only disclose, re-transmit, copy, distribute, act in reliance on
or commercialise the information if you are authorised to do so. Any views
expressed in this email communication are those of the individual sender,
except where the sender specifically states them to be the views of a
member of the National Australia Bank Group of companies. Any advice
contained in this e-mail has been prepared without taking into account your
objectives, financial situation or needs. Before acting on any advice in
this e-mail, National Australia Bank Limited recommends that you consider
whether it is appropriate for your circumstances. If this e-mail contains
reference to any financial products, the National recommends you consider
the Product Disclosure Statement (PDS) or other disclosure document before
making any decisions regarding any products. The National Australia Bank
Group of companies does not represent, warrant or guarantee that the
integrity of this communication has been maintained nor that the
communication is free of errors, virus or interference.
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-user-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-user-help@jakarta.apache.org
Re: specifying .betwixt file to use
Posted by robert burrell donkin <ro...@blueyonder.co.uk>.
i've now committed support for custom dot betwixt documents and
multi-mapping documents (apologies for the delay, i've been a little
unwell recently). thanks to brian for the original contribution. there
should be some information about how this works in the current guide
(which should now be deployed on the website). you'll need to build
from CVS HEAD (or grab a new nightly) to use these new features.
- robert
On 20 Aug 2004, at 04:16, Evgueni_Iakhontov@national.com.au wrote:
>
>
>
>
> Hi All,
> I've been looking at mapping our java objects to xml using .betwixt
> files.
> We have a number of xml formats that we want to use and we are reusing
> same
> objects for each xml message. The question is - can I specify which
> .betwixt file I want to use when converting my java object to xml?
>
> your help would be greatly appreciated
> Evgueni Iakhontov
>
> This email is sent by or on behalf of the named sender identified
> above. If
> you do not wish to receive any email marketing material from this
> person in
> the future, please forward the contents of this email to
> unsubscriptions@national.com.au with the word "unsubscribe" in the
> subject
> box. If you do not forward the contents of this email with your
> unsubscription then it may not be able to be implemented. If you wish
> to
> unsubscribe from all central email marketing lists used by our
> business,
> please forward the contents of this email to
> unsubscriptions@national.com.au with the message "unsubscribe from all
> central email marketing lists" in the subject box. If you do not
> forward
> the contents of this email with your unsubscription then it may not be
> able
> to be implemented.
>
>
> The information contained in this email communication may be
> confidential.
> You should only disclose, re-transmit, copy, distribute, act in
> reliance on
> or commercialise the information if you are authorised to do so. Any
> views
> expressed in this email communication are those of the individual
> sender,
> except where the sender specifically states them to be the views of a
> member of the National Australia Bank Group of companies. Any advice
> contained in this e-mail has been prepared without taking into account
> your
> objectives, financial situation or needs. Before acting on any advice
> in
> this e-mail, National Australia Bank Limited recommends that you
> consider
> whether it is appropriate for your circumstances. If this e-mail
> contains
> reference to any financial products, the National recommends you
> consider
> the Product Disclosure Statement (PDS) or other disclosure document
> before
> making any decisions regarding any products. The National Australia
> Bank
> Group of companies does not represent, warrant or guarantee that the
> integrity of this communication has been maintained nor that the
> communication is free of errors, virus or interference.
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: commons-user-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: commons-user-help@jakarta.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-user-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-user-help@jakarta.apache.org
Re: specifying .betwixt file to use
Posted by robert burrell donkin <ro...@blueyonder.co.uk>.
On 23 Aug 2004, at 17:29, b p wrote:
> I had a similar requirement and started down the path of creating an
> introspector that had a single xml file that held all the mappings and
> could be passed in at runtime. As requirements changed on me, I didn't
> end up needing to really use it, but I had the basic idea implemented.
> You are welcome to use the code below as is or take some ideas from
> it (it could probably still use a little cleaning up in the caching of
> mappings and registering of beans). There is a test case attached as
> well that should show you how to use it.
this is a good solution to a niggling worry: it's not just one mapping
file that needs to be switched out but a complete set. i'd been
considering a betwixt source strategy which locate input sources on a
per class basis but that's more than a little clunky. this solution is
much better :)
i've a taken a look and had a think. it would be more flexible if the
loading didn't flush the registry. a typical use case is to share one
introspector per binding configuration and preload the registry's
cache. without the flush, earlier registrations would (by default)
override later ones. this would provide an easy method for a class or
two (for example, in a bulk mapping) to be overridden.
i think that i'll add methods to the XMLIntrospector that will allow a
input source to be provided for a single class and also an
multiple-class input source in the new extended dot betwixt syntax.
> Robert, as always you are welcome to commit all or any pieces of the
> code that you think would be useful for betwixt.
cool :)
BTW brian, you've been helping to develop betwixt for quite a while
now. if you do fancy stepping up to the next level on betwixt (from
developer to committer), let me know and i'll start the wheels in
motion. of course, i understand if you're happy as you are.
- robert
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-user-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-user-help@jakarta.apache.org
Re: specifying .betwixt file to use
Posted by b p <tr...@yahoo.com>.
I had a similar requirement and started down the path of creating an introspector that had a single xml file that held all the mappings and could be passed in at runtime. As requirements changed on me, I didn't end up needing to really use it, but I had the basic idea implemented. You are welcome to use the code below as is or take some ideas from it (it could probably still use a little cleaning up in the caching of mappings and registering of beans). There is a test case attached as well that should show you how to use it.
Robert, as always you are welcome to commit all or any pieces of the code that you think would be useful for betwixt.
-Brian
______________________________________________
XMLSingleMappingFileBeanInfoDigester.java
package org.apache.commons.betwixt.digester;
import org.apache.commons.betwixt.digester.AddDefaultsRule;
import org.apache.commons.betwixt.digester.AttributeRule;
import org.apache.commons.betwixt.digester.ElementRule;
import org.apache.commons.betwixt.digester.HideRule;
import org.apache.commons.betwixt.digester.XMLBeanInfoDigester;
import org.apache.commons.betwixt.registry.XMLBeanInfoRegistry;
import java.util.HashMap;
/**
* <code>XMLSingleMappingFileBeanInfoDigester</code> is a digester of XML files
* containing XMLBeanInfo definitions for a JavaBeans.
*
* @author Brian Pugh
*/
public class XMLSingleMappingFileBeanInfoDigester extends XMLBeanInfoDigester {
private HashMap beanInfoMap = new HashMap();
// Implementation methods
//-------------------------------------------------------------------------
/**
* Reset configure for new digestion.
*/
protected void configure() {
if (!configured) {
configured = true;
// add the various rules
addRule("betwixt-config", new ConfigRule());
addRule("betwixt-config/class", new ClassRule());
addRule("*/element", new ElementRule());
addRule("*/attribute", new AttributeRule());
addRule("*/hide", new HideRule());
addRule("*/addDefaults", new AddDefaultsRule());
}
// now initialize
//setAttributesForPrimitives(true);
getProcessedPropertyNameSet().clear();
getXMLIntrospector().getRegistry().flush();
}
/**
* Map containing <code>XMLBeanInfo</code> classes.
* Keys are the <code>Class</code> and values are the <code>XMLBeanInfo</code> objects.
*
* @return map of XMLBeanInfos
*/
public HashMap getBeanInfoMap() {
return beanInfoMap;
}
/**
* Set the Map containing <code>XMLBeanInfo</code> classes.
* @param beanInfoMap map to set.
*/
public void setBeanInfoMap(HashMap beanInfoMap) {
this.beanInfoMap = beanInfoMap;
}
}
-------------------------------------------------------
ClassRule.java
package org.apache.commons.betwixt.digester;
import org.apache.commons.betwixt.XMLBeanInfo;
import org.apache.commons.betwixt.digester.RuleSupport;
import org.apache.commons.betwixt.digester.XMLBeanInfoDigester;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.xml.sax.Attributes;
import org.xml.sax.SAXException;
import java.util.HashMap;
/**
* Digester Rule to process class elements.
* @author Brian Pugh
*/
public class ClassRule extends RuleSupport {
/** Logger. */
private static final Log log = LogFactory.getLog(ClassRule.class);
/** Base constructor. */
public ClassRule() {
}
// Rule interface
//-------------------------------------------------------------------------
/**
* Process the beginning of this element.
*
* @param attributes The attribute list of this element
* @throws org.xml.sax.SAXException if the primitiveTypes attribute contains an invalid value
*/
public void begin(Attributes attributes) throws SAXException {
String className = attributes.getValue("name");
if (className == null || "".equals(className)) {
throw new SAXException("Invalid 'class' element. "
+ "Attribute 'name' is required but was not found but was not found.");
}
try {
Class beanClass = Class.forName(className);
XMLBeanInfo xmlBeanInfo = new XMLBeanInfo(beanClass);
XMLBeanInfoDigester xmlBeanInfoDigester =(XMLBeanInfoDigester) getDigester();
xmlBeanInfoDigester.setBeanClass(beanClass);
xmlBeanInfoDigester.push(xmlBeanInfo);
}
catch (ClassNotFoundException e) {
throw new SAXException("Invalid 'class' element. Unable to find class: " + className, e);
}
}
/**
* Process the end of this element.
*/
public void end() {
XMLBeanInfo xmlBeanInfo = (XMLBeanInfo) getDigester().pop();
XMLSingleMappingFileBeanInfoDigester digester = (XMLSingleMappingFileBeanInfoDigester) getDigester();
HashMap xmlBeanInfoMapping = digester.getBeanInfoMap();
xmlBeanInfoMapping.put(xmlBeanInfo.getBeanClass(), xmlBeanInfo);
digester.setBeanClass(null);
}
}
-------------------------------------------
ConfigRule.java
package org.apache.commons.betwixt.digester;
import org.apache.commons.betwixt.digester.RuleSupport;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.xml.sax.Attributes;
import org.xml.sax.SAXException;
import java.util.HashMap;
/**
* Digester Rule to process config elements.
* @author Brian Pugh
*/
public class ConfigRule extends RuleSupport {
/** Logger. */
private static final Log log = LogFactory.getLog(ConfigRule.class);
/** Base constructor. */
public ConfigRule() {
}
// Rule interface
//-------------------------------------------------------------------------
/**
* Process the beginning of this element.
*
* @param attributes The attribute list of this element
* @throws org.xml.sax.SAXException if the primitiveTypes attribute contains an invalid value
*/
public void begin(Attributes attributes) throws SAXException {
String value = attributes.getValue("primitiveTypes");
if (value != null) {
if (value.equalsIgnoreCase("element")) {
getXMLInfoDigester().setAttributesForPrimitives(false);
}
else if (value.equalsIgnoreCase("attribute")) {
getXMLInfoDigester().setAttributesForPrimitives(true);
}
else {
throw new SAXException(
"Invalid value inside element <betwixt-config> for attribute 'primitiveTypes'."
+ " Value should be 'element' or 'attribute'");
}
}
XMLSingleMappingFileBeanInfoDigester digester = (XMLSingleMappingFileBeanInfoDigester) getDigester();
getDigester().push(digester.getBeanInfoMap());
}
/**
* Process the end of this element.
*/
public void end() {
Object top = getDigester().pop();
}
}
---------------------------------------------------
XMLSingleMappingFileIntrospector.java
package org.apache.commons.betwixt;
import org.apache.commons.betwixt.XMLBeanInfo;
import org.apache.commons.betwixt.XMLIntrospector;
import org.apache.commons.betwixt.digester.XMLBeanInfoDigester;
import org.apache.commons.betwixt.digester.XMLSingleMappingFileBeanInfoDigester;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import java.net.URL;
import java.util.HashMap;
/**
* Introspector that uses a single mapping file to define all mappings (rather than seperate .betwixt files for each class).
* Mapping file format is very almost the same as standard .betwixt mapping file with the addition that multiple classes
* can be mapped in one file.
* <p/>
* Sample mapping:
* <PRE>
* <code>
* <?xml version="1.0"?>
* <betwixt-config>
* <!--name of the class to map -->
* <class name="org.some.package.MyClass">
* <!-- standard definations (same as in standard .betwixt file) -->
* <element name="repository-registration-result">
* <element name="repository-id" property="repositoryId"/>
* <element name="id-mapping" property="idMapping" class="org.some.package.SomeOtherClass"/>
* <element name="status" property="status"/>
* <element name="exception" property="exception"/>
* <element name="primary-luid" property="primaryLuid"/>
* <addDefaults add-properties='false'/>
* </element>
* </class>
* ...
* <!--additional class mappings -->
* <class>
* ...
* </class>
* ...
* </betwixt-config>
* </code>
* </PRE>
*
* @author Brian Pugh
*/
public class XMLSingleMappingFileIntrospector extends XMLIntrospector {
/**
* Log used for logging.
*/
protected Log log = LogFactory.getLog(XMLSingleMappingFileIntrospector.class);
/**
* Digester used to parse the XML descriptor files.
*/
private XMLBeanInfoDigester digester;
private boolean mapLoaded = false;
private String mappingFile;
private HashMap beanInfoMap;
/**
* construct a XMLSingleMappingFileIntrospector.
*/
public XMLSingleMappingFileIntrospector() {
}
/**
* get the digester that will be used to interpret the mapping file.
*
* @return digester.
*/
public XMLBeanInfoDigester getDigester() {
return digester;
}
/**
* Set the digester that will be used to interpret the mapping file.
*
* @param digester digester to use with this Introspector.
*/
public void setDigester(XMLBeanInfoDigester digester) {
this.digester = digester;
}
/**
* Get the mapping file.
*
* @return mapping file name.
*/
public String getMappingFile() {
return mappingFile;
}
/**
* Set the mapping file. The name should follow the rules for a resource as defined in <code>ClassLoader.getResource()</code>.
*
* @param mappingFile the name of the mapping file.
* @see java.lang.ClassLoader
*/
public void setMappingFile(String mappingFile) {
this.mappingFile = mappingFile;
}
/**
* Attempt to lookup the XML descriptor for the given class using the
* mappingfile or return null if it could not be loaded.
*
* @param aClass class to create XMLBeanInfo for.
* @return XMLBeanInfo digested from the mappingfile if one can be found.
* Otherwise null.
*/
protected synchronized XMLBeanInfo findByXMLDescriptor(Class aClass) {
if (!isMapLoaded()) {
loadXmlBeanInfoMapping();
if (beanInfoMap == null && log.isWarnEnabled()) {
log.warn("Unable to load XMLBeanInfo classes");
}
}
XMLBeanInfo xmlBeanInfo = null;
if (beanInfoMap != null) {
xmlBeanInfo = (XMLBeanInfo)beanInfoMap.get(aClass);
}
return xmlBeanInfo;
}
/**
* Use <code>mappingFile</code> to create and load known <code>XMLBeanInfo</code> classes.
*/
public void loadXmlBeanInfoMapping() {
ClassLoader loader = getClass().getClassLoader();
URL url = null;
if (loader != null && mappingFile != null) {
url = loader.getResource(mappingFile);
if (url == null) {
url = loader.getResource("/" + mappingFile);
}
}
if (url != null) {
String urlText = url.toString();
try {
if (log.isDebugEnabled()) {
log.debug("Parsing XML descriptor: " + urlText);
}
// synchronized method so this digester is only used by
// one thread at once
if (digester == null) {
digester = new XMLSingleMappingFileBeanInfoDigester();
digester.setXMLIntrospector(this);
}
beanInfoMap = (HashMap)digester.parse(urlText);
mapLoaded = true;
}
catch (Exception e) {
log.warn("Caught exception trying to parse: " + urlText, e);
throw new RuntimeException("Unable to parse mapping file [" + mappingFile + "]", e);
}
}
else {
if (log.isWarnEnabled()) {
log.warn("Could find XML descriptor file [" + mappingFile + "]. No mapping file will be used. ");
}
}
}
/**
* Map containing loaded <code>XMLBeanInfo</code> classes.
* Keys are the <code>Class</code> and values are the <code>XMLBeanInfo</code> objects.
*
* @return map of XMLBeanInfos
*/
public HashMap getBeanInfoMap() {
return beanInfoMap;
}
/**
* indicates whether the mappingFile has been read to load the <code>XMLBeanInfo</code>s.
*
* @return true if mapping file has been loaded.
*/
public boolean isMapLoaded() {
return mapLoaded;
}
}
---------------------------
TestXMLSIngleMappingFileInstrospector.java
package org.apache.commons.betwixt;
import junit.framework.Test;
import junit.framework.TestSuite;
import junit.framework.TestCase;
import junit.textui.TestRunner;
import java.util.Date;
import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;
import java.io.StringWriter;
import java.io.IOException;
import java.io.StringReader;
import java.beans.IntrospectionException;
import org.apache.commons.betwixt.io.BeanWriter;
import org.apache.commons.betwixt.io.BeanReader;
import org.xml.sax.SAXException;
/**
* @author Brian Pugh
*/
public class TestXMLSIngleMappingFileInstrospector extends TestCase {
public void testRoundTripWithSingleMappingFile() throws IOException, SAXException, IntrospectionException {
AddressBean addressBean = new AddressBean();
addressBean.setCity("New York");
addressBean.setCode("92342");
addressBean.setCountry("USA");
addressBean.setStreet("12312 Here");
PartyBean partyBean = new PartyBean();
partyBean.setDateOfParty(new Date());
partyBean.setExcuse("too late");
partyBean.setFromHour(22);
partyBean.setVenue(addressBean);
StringWriter outputWriter = new StringWriter();
outputWriter.write("<?xml version='1.0' ?>\n");
BeanWriter beanWriter = new BeanWriter(outputWriter);
beanWriter.enablePrettyPrint();
beanWriter.setWriteEmptyElements(true);
XMLSingleMappingFileIntrospector xmlIntrospector = new XMLSingleMappingFileIntrospector();
xmlIntrospector.setMappingFile("org/apache/commons/betwixt/mapping.xml");
beanWriter.setXMLIntrospector(xmlIntrospector);
beanWriter.write(partyBean);
String expectedOut = "<?xml version='1.0' ?>\n" +
" <party id=\"1\">\n" +
" <the-excuse>too late</the-excuse>\n" +
" <location id=\"2\">\n" +
" <street>12312 Here</street>\n" +
" <city>New York</city>\n" +
" <code>92342</code>\n" +
" <country>USA</country>\n" +
" </location>\n" +
" <time>22</time>\n" +
" </party>\n";
assertEquals(expectedOut, outputWriter.toString());
BeanReader beanReader = new BeanReader();
beanReader.setXMLIntrospector(xmlIntrospector);
StringReader xmlReader = new StringReader(outputWriter.toString());
registerBeanClass(beanReader, PartyBean.class);
//Parse the xml
PartyBean result = (PartyBean)beanReader.parse(xmlReader);
assertEquals(partyBean.getExcuse(), result.getExcuse());
assertEquals(partyBean.getFromHour(), result.getFromHour());
AddressBean addressResult = result.getVenue();
assertEquals(addressBean.getCity(), addressResult.getCity());
assertEquals(addressBean.getCode(), addressResult.getCode());
assertEquals(addressBean.getCountry(), addressResult.getCountry());
assertEquals(addressBean.getStreet(), addressResult.getStreet());
}
/**
* Register a bean class with the XML element as defined in the mapping file. If no occurance of the class
* is found in the mapping file, use default registration.
*
* @param clazz class to register.
*/
private void registerBeanClass(BeanReader beanReader, Class clazz) throws IntrospectionException {
boolean classMapped = false;
XMLIntrospector introspector = beanReader.getXMLIntrospector();
if (introspector != null) {
if (introspector instanceof XMLSingleMappingFileIntrospector) {
XMLSingleMappingFileIntrospector unifiedXMLIntrospector = (XMLSingleMappingFileIntrospector)introspector;
HashMap beanInfoMap = unifiedXMLIntrospector.getBeanInfoMap();
if (beanInfoMap != null) {
for (Iterator i = beanInfoMap.entrySet().iterator(); i.hasNext();) {
Map.Entry e = (Map.Entry)i.next();
XMLBeanInfo xmlBeanInfo = (XMLBeanInfo)e.getValue();
if (xmlBeanInfo.getBeanClass() == clazz) {
beanReader.registerBeanClass(xmlBeanInfo.getElementDescriptor().getQualifiedName(), xmlBeanInfo.getBeanClass());
classMapped = true;
break;
}
}
}
}
}
if (!classMapped) {
throw new RuntimeException("Could not map the class '\" + e.getKey() + \" to a XMLBeanInfo.");
}
}
public static Test suite() {
return new TestSuite(TestXMLSIngleMappingFileInstrospector.class);
}
public static void main(String[] args) {
TestRunner.run(suite());
}
}
-----------------------------
mapping.xml (put in org.apache.commons.betwixt)
<?xml version="1.0"?>
<betwixt-config>
<class name="org.apache.commons.betwixt.PartyBean">
<element name="party">
<element name="the-excuse" property="excuse"/>
<element name="location" property="venue"/>
<element name="time" property="fromHour"/>
</element>
</class>
<class name="org.apache.commons.betwixt.AddressBean">
<element name="address">
<element name="street" property="street"/>
<element name="city" property="city"/>
<element name="code" property="code"/>
<element name="country" property="country"/>
</element>
</class>
</betwixt-config>
robert burrell donkin <ro...@blueyonder.co.uk> wrote:
On 20 Aug 2004, at 04:16, Evgueni_Iakhontov@national.com.au wrote:
> Hi All,
> I've been looking at mapping our java objects to xml using .betwixt
> files.
> We have a number of xml formats that we want to use and we are reusing
> same
> objects for each xml message. The question is - can I specify which
> .betwixt file I want to use when converting my java object to xml?
not at the moment but this is a feature that's on the todo radar. i
might take a look at adding this over the next day or two..
there are some performance wrinkles that might need a little thought.
loading, parsing then processing the betwixt file is slow. (which is
why the registry exists.) however, it's probably better to add the
feature now and worry later.
- robert
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-user-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-user-help@jakarta.apache.org
---------------------------------
Do you Yahoo!?
New and Improved Yahoo! Mail - 100MB free storage!
Re: specifying .betwixt file to use
Posted by robert burrell donkin <ro...@blueyonder.co.uk>.
On 20 Aug 2004, at 04:16, Evgueni_Iakhontov@national.com.au wrote:
> Hi All,
> I've been looking at mapping our java objects to xml using .betwixt
> files.
> We have a number of xml formats that we want to use and we are reusing
> same
> objects for each xml message. The question is - can I specify which
> .betwixt file I want to use when converting my java object to xml?
not at the moment but this is a feature that's on the todo radar. i
might take a look at adding this over the next day or two..
there are some performance wrinkles that might need a little thought.
loading, parsing then processing the betwixt file is slow. (which is
why the registry exists.) however, it's probably better to add the
feature now and worry later.
- robert
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-user-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-user-help@jakarta.apache.org