| 1 |
<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> |
| 2 |
<!-- |
| 3 |
Licensed to the Apache Software Foundation (ASF) under one or more |
| 4 |
contributor license agreements. See the NOTICE file distributed with |
| 5 |
this work for additional information regarding copyright ownership. |
| 6 |
The ASF licenses this file to You under the Apache License, Version 2.0 |
| 7 |
(the "License"); you may not use this file except in compliance with |
| 8 |
the License. You may obtain a copy of the License at |
| 9 |
|
| 10 |
http://www.apache.org/licenses/LICENSE-2.0 |
| 11 |
|
| 12 |
Unless required by applicable law or agreed to in writing, software |
| 13 |
distributed under the License is distributed on an "AS IS" BASIS, |
| 14 |
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 15 |
See the License for the specific language governing permissions and |
| 16 |
limitations under the License. |
| 17 |
--> |
| 18 |
<html> |
| 19 |
<head> |
| 20 |
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
| 21 |
<meta name="GENERATOR" content="Microsoft FrontPage 5.0"> |
| 22 |
<title>Proposal for BeanUtils Package</title> |
| 23 |
</head> |
| 24 |
<body bgcolor="#FFFFFF"> |
| 25 |
|
| 26 |
<center> |
| 27 |
<h1> |
| 28 |
Proposal for <i>JXPath</i> Package</h1></center> |
| 29 |
|
| 30 |
<h3> |
| 31 |
(0) Rationale</h3> |
| 32 |
In heterogenous techologies like Struts, XML documents are combined with |
| 33 |
object graphs consisting of JavaBeans, collections, arrays, maps and primitive |
| 34 |
values. In such systems there is a need for a consistent way of referencing |
| 35 |
both parts of XML documents and elements of object graphs. XPath |
| 36 |
is a powerful language introduced by W3C (<a href="http://www.w3.org/TR/xpath">XML |
| 37 |
Path Language</a>) as a common format for addressing elements of XML documents. |
| 38 |
The proposed <i>JXPath </i>component provides a mechanism for applying the |
| 39 |
same XPath language to generic object graphs. |
| 40 |
<h3> |
| 41 |
(1) Scope of the Package</h3> |
| 42 |
This proposal is to create a package of Java utility methods for accessing |
| 43 |
and modifying the elements of arbitrary graphs consisting of JavaBeans, |
| 44 |
collections, arrays, maps and primitive values using the XPath syntax. |
| 45 |
This package will (at least initially) depend on an external implementation |
| 46 |
of an XPath expression processor. |
| 47 |
<p>This package augments BeanUtils, which provides a lighter-weight reference |
| 48 |
format. |
| 49 |
<h3> |
| 50 |
(1.5) Interaction With Other Packages</h3> |
| 51 |
JXPath relies on |
| 52 |
<ul> |
| 53 |
<li> |
| 54 |
Java Development Kit (Version 1.2 or later)</li> |
| 55 |
|
| 56 |
<li> |
| 57 |
A JAXP 1.1 implementation</li> |
| 58 |
|
| 59 |
<li> |
| 60 |
An XPath interpreter implementation. Initially the package will only support |
| 61 |
the interpreter provided by the Apache Xalan project, but will have an |
| 62 |
extensibility mechanism that will allow adding alternative XPath processors |
| 63 |
later.</li> |
| 64 |
</ul> |
| 65 |
No external configuration files are utilized. |
| 66 |
<h3> |
| 67 |
(2) Initial Source of the Package</h3> |
| 68 |
The original source of the component was donated by PLOTNIX, Inc (<a href="http://www.plotnix.com">www.plotnix.com</a>). |
| 69 |
<p>The proposed package names for the new component are |
| 70 |
<ul> |
| 71 |
<li> |
| 72 |
<tt>org.apache.commons.jxpath</tt> for the main API package</li> |
| 73 |
|
| 74 |
<li> |
| 75 |
<tt>org.apache.commons.jxpath.tree </tt>for a light-weight DOM-JavaBeans |
| 76 |
API adapter</li> |
| 77 |
|
| 78 |
<li> |
| 79 |
<tt>org.apache.commons.jxpath.xalan </tt>for a Xalan XPath interpreter adapter</li> |
| 80 |
</ul> |
| 81 |
|
| 82 |
<h3> |
| 83 |
(3) Required Jakarta-Commons Resources</h3> |
| 84 |
|
| 85 |
<ul> |
| 86 |
<li> |
| 87 |
CVS Repository - New directory jxpath in the <tt>jakarta-commons</tt> CVS |
| 88 |
repository. There is a requirement to setup an additional committer: Dmitri |
| 89 |
Plotnikov.</li> |
| 90 |
|
| 91 |
<li> |
| 92 |
Mailing List - Discussions will take place on the general <i>[email protected]</i> |
| 93 |
mailing list. To help list subscribers identify messages of interest, it |
| 94 |
is suggested that the message subject of messages about this component |
| 95 |
be prefixed with [JXPath].</li> |
| 96 |
|
| 97 |
<li> |
| 98 |
Bugzilla - New component "JXPath" under the "Commons" product category, |
| 99 |
with appropriate version identifiers as needed.</li> |
| 100 |
|
| 101 |
<li> |
| 102 |
Jyve FAQ - New category "commons-jxpath" (when available).</li> |
| 103 |
</ul> |
| 104 |
|
| 105 |
<h3> |
| 106 |
(4) Initial Committers</h3> |
| 107 |
The initial committers on the JXPath component shall be Dmitri Plotnikov and Craig McClanahan. |
| 108 |
</body> |
| 109 |
</html> |