commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dmi...@apache.org
Subject cvs commit: jakarta-commons/jxpath/xdocs/stylesheets project.xml
Date Sun, 28 Apr 2002 22:43:08 GMT
dmitri      02/04/28 15:43:08

  Modified:    jxpath/xdocs users-guide.xml
               jxpath   STATUS.html project.xml
               jxpath/xdocs/stylesheets project.xml
  Log:
  Cosmetic changed to documentation
  
  Revision  Changes    Path
  1.5       +84 -29    jakarta-commons/jxpath/xdocs/users-guide.xml
  
  Index: users-guide.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/jxpath/xdocs/users-guide.xml,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- users-guide.xml	28 Apr 2002 04:37:01 -0000	1.4
  +++ users-guide.xml	28 Apr 2002 22:43:08 -0000	1.5
  @@ -41,6 +41,61 @@
        <a href="api/org/apache/commons/jxpath/JXPathContext.html"><code>JXPathContext</code></a>.
Most of the
        APIs discussed in this document have to do with the JXPathContext class.
       </p>
  +<ul>
  +  <li><a href="#Object Graph Traversal">Object Graph Traversal</a>
  +     <ul>
  +       <li><a href="#JavaBean Property Access">JavaBean Property Access</a></li>
  +       <li><a href="#Lenient Mode">Lenient Mode</a></li>
  +       <li><a href="#Nested Bean Property Access">Nested Bean Property Access</a></li>
  +       <li><a href="#Collection Subscripts">Collection Subscripts</a></li>
  +       <li><a href="#Retrieving Multiple Results">Retrieving Multiple Results</a></li>
  +       <li><a href="#Map Element Access">Map Element Access</a></li>
  +       <li><a href="#DOM Document Access">DOM Document Access</a></li>
  +       <li><a href="#Containers">Containers</a></li>
  +     </ul>
  +  </li>
  +  <li><a href="#Modifying Object Graphs">Modifying Object Graphs</a>
  +     <ul>
  +       <li><a href="#Setting Properties">Setting Properties</a></li>
  +       <li><a href="#Creating Objects">Creating Objects</a></li>
  +     </ul>
  +  </li>
  +  <li><a href="#Variables">Variables</a>
  +     <ul>
  +       <li><a href="#Custom Variable Pools">Custom Variable Pools</a></li>
  +     </ul>
  +  </li>
  +  <li><a href="#Servlet Contexts">Servlet Contexts</a>
  +     <ul>
  +       <li><a href="#JSP Page Context">JSP Page Context</a></li>
  +       <li><a href="#Servlet Request Context">Servlet Request Context</a></li>
  +       <li><a href="#HttpSession Context">HttpSession Context</a></li>
  +       <li><a href="#ServletContext Context">ServletContext Context</a></li>
  +     </ul>
  +  </li>
  +  <li><a href="#Pointers">Pointers</a></li>
  +  <li><a href="#Extension Functions">Extension Functions</a>
  +     <ul>
  +       <li><a href="#Standard Extension Functions">Standard Extension Functions</a></li>
  +       <li><a href="#Custom Extension Functions">Custom Extension Functions</a></li>
  +       <li><a href="#Expression Context">Expression Context</a></li>
  +     </ul>
  +  </li>
  +  <li><a href="#Type Conversions">Type Conversions</a></li>
  +  <li><a href="#Internationalization">Internationalization</a></li>
  +  <li><a href="#Nested Contexts">Nested Contexts</a></li>
  +  <li><a href="#Compiled Expressions">Compiled Expressions</a></li>
  +  <li><a href="#Customizing JXPath">Customizing JXPath</a>
  +     <ul>
  +       <li><a href="#Custom JXPathBeanInfo">Custom JXPathBeanInfo</a></li>
  +       <li><a href="#Custom DynamicPropertyHandler">Custom DynamicPropertyHandler</a></li>
  +       <li><a href="#Custom Pointers and Iterators">Custom Pointers and Iterators</a></li>
  +       <li><a href="#Alternative JXPath Implementation">Alternative JXPath
Implementation</a></li>
  +     </ul>
  +  </li>
  +  <li><a href="#Miscellaneous">Miscellaneous</a></li>
  +</ul>
  +
   </section>
   
   <section name="Object Graph Traversal">
  @@ -59,7 +114,7 @@
       JXPath can be used to access properties of a JavaBean.
    </p>
   <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
   public class Employee {
       public String getFirstName(){
          ...
  @@ -94,7 +149,7 @@
    JXPath can traverse object graphs:
    </p>
    <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
    public class Employee {
       public Address getHomeAddress(){
          ...
  @@ -120,7 +175,7 @@
    For instance, we can extract the whole Address object in above example:
    </p>
    <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
       Address addr = (Address)context.getValue("homeAddress");
    </source>
    </subsection>
  @@ -130,7 +185,7 @@
     JXPath can extract elements from arrays and collections.
    </p>
    <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
    public class Integers {
       public int[] getNumbers(){
          ...
  @@ -157,7 +212,7 @@
    called in this case is not <code>getValue</code>, but <code>iterate</code>.
    </p>
    <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
    public class Author {
       public Book[] getBooks(){
          ...
  @@ -181,7 +236,7 @@
     JXPath supports maps. To get a value use its key.
    </p>
    <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
    public class Employee {
       private Map addressMap = new HashMap();
       {
  @@ -206,7 +261,7 @@
    elements:
    </p>
    <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
    String homeZipCode = (String)context.
           getValue("addresses[@name='home']/zipCode");
    </source>
  @@ -274,7 +329,7 @@
   Let's say we have the the following XML file, which is stored as a Java resource.
   </p>
   <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
       &lt;?xml version="1.0" ?&gt;
       &lt;vendor&gt;
         &lt;location id="store101"&gt;
  @@ -294,7 +349,7 @@
   Here's the code that makes use of XMLDocumentContainer.
   </p>
   <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
    class Company {
       private Container locations = null;
   
  @@ -338,7 +393,7 @@
    JXPath can be used to modify property values.
    </p>
    <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
    public class Employee {
       public Address getAddress() {
          ...
  @@ -370,7 +425,7 @@
    nodes.
   </p>
    <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
    public class AddressFactory extends AbstractFactory {
       public boolean createObject(JXPathContext context, Pointer pointer,
                                   Object parent, String name, int index){
  @@ -410,7 +465,7 @@
    </p>
   
    <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
    public class Author {
       public Book[] getBooks(){
          ...
  @@ -431,7 +486,7 @@
    </p>
   
    <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
    context.setValue("$index", new Integer(3));
    </source>
   
  @@ -448,7 +503,7 @@
    </p>
   
    <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
    ...
    context.getVariables().declareVariable("book", myBook);
    String title = (String)context.getValue("$book/title);
  @@ -542,7 +597,7 @@
   For example, you can call
   </p>
   <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
   Pointer ptr = context.getPointer("employees[$i]/addresses[$j]")
   </source>
   <p>
  @@ -557,7 +612,7 @@
   found locations:
   </p>
   <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
   List homeAddresses = context.locate("//employee/address[@name='home']");
   </source>
   <p>
  @@ -596,7 +651,7 @@
    Here's how you can create new objects:
   </p>
   <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
    Book book = (Book)context.
      getValue("com.myco.books.Book.new('John Updike')");
   </source>
  @@ -605,7 +660,7 @@
    Here's how you can call static methods:
   </p>
   <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
    Book book = (Book)context.
      getValue("com.myco.books.Book.getBestBook('John Updike')");
   </source>
  @@ -614,7 +669,7 @@
    Here's how you can call regular methods:
   </p>
    <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
    String firstName = (String)context.
      getValue("getAuthorsFirstName($book)");
    </source>
  @@ -634,7 +689,7 @@
    Let's say the following class implements various formatting operations:
   </p>
   <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
    public class Formats {
       public static String date(Date d, String pattern){
           return new SimpleDateFormat(pattern).format(d);
  @@ -647,7 +702,7 @@
    We can register this class with a JXPathContext:
   </p>
   <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
    context.setFunctions(new ClassFunctions(Formats.class, "format"));
    ...
   
  @@ -676,7 +731,7 @@
     gain access to the "current" object in the currently evaluated context.
   </p>
   <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
   public class MyExtenstionFunctions {
      public static boolean isDate(ExpressionContext context){
         Pointer pointer = context.getContextNodePointer();
  @@ -694,7 +749,7 @@
   call it like this:
   </p>
   <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
     "//.[myext:isDate()]"
   </source>
   <p>
  @@ -709,7 +764,7 @@
   For example,
   </p>
   <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
   public class MyExtenstionFunctions {
      ...
      public static boolean contains(ExpressionContext current,
  @@ -729,7 +784,7 @@
   You can call this function to find all people who have a certain phone number:
   </p>
   <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
     "/addressBook/contact[myext:contains(phoneNumbers, '555-5555']"
   </source>
   
  @@ -774,7 +829,7 @@
   A locale can be declared on an XML Element like this:
   </p>
   <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
        &lt;book xml:lang="fr"&gt;Les Miserables&lt;/book&gt;
   </source>
   <p>
  @@ -782,7 +837,7 @@
   for a specific language:
   </p>
   <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
        "//book[lang('fr')]
   </source>
   <p>
  @@ -809,7 +864,7 @@
    </p>
   
   <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
    JXPathContext sharedContext = JXPathContext.newContext(null);
    sharedContext.getVariables().declareVariable("title", "Java");
    sharedContext.setFunctions(new MyExtensionFunctions());
  @@ -838,7 +893,7 @@
   Here's how you can precompile an XPath expression:
   </p>
   <source>
  -                                                                       &#xA0;
  +                                                                       <b></b>
        CompiledExpression expr = context.compile(xpath);
        ...
        Object value = expr.getValue(context);
  
  
  
  1.3       +38 -19    jakarta-commons/jxpath/STATUS.html
  
  Index: STATUS.html
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/jxpath/STATUS.html,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- STATUS.html	7 Feb 2002 19:10:49 -0000	1.2
  +++ STATUS.html	28 Apr 2002 22:43:08 -0000	1.3
  @@ -2,7 +2,7 @@
   <html>
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  -   <meta name="GENERATOR" content="Microsoft FrontPage 5.0">
  +   <meta name="GENERATOR" content="Mozilla/4.75 [en] (Windows NT 5.0; U) [Netscape]">
      <title>Status File for Jakarta Commons "BeanUtils" Component</title>
   </head>
   <body bgcolor="#FFFFFF">
  @@ -11,7 +11,7 @@
   <h1>
   The Jakarta Commons <i>JXPath</i> Component</h1></center>
   
  -<center>$Id: STATUS.html,v 1.2 2002/02/07 19:10:49 jstrachan Exp $
  +<center>$Id: STATUS.html,v 1.3 2002/04/28 22:43:08 dmitri Exp $
   <br><a href="#Introduction">[Introduction]</a><a href="#Dependencies">[Dependencies]</a><a
href="#Release Info">[Release
   Info]</a><a href="#Committers">[Committers]</a><a href="#Action Items">[Action
   Items]</a></center>
  @@ -22,9 +22,9 @@
   The <i>JXPath</i> Component contains a set of Java classes that provide
   static utility methods useful in manipulating Java classes that conform
   to the JavaBeans Specification naming patterns for bean properties in a
  -dynamic fashion using the XPath syntax.  It also supports Java collections
  -and objects with Dynamic Properties (like Map, ServletContext etc).
  -
  +dynamic fashion using the XPath syntax. It also supports Java collections,
  +objects with Dynamic Properties (like Map, ServletContext etc) and mechanism
  +for adding support for additional object models.
   <p>An innovative and unique feature of this component is the unification
   of reference syntax between DOM and Java.
   <br><a NAME="Dependencies"></a>
  @@ -34,25 +34,28 @@
   for development and use:
   <ul>
   <li>
  -<a href="http://java.sun.com/j2se">Java Development Kit</a> (Version 1.2
  +<a href="http://java.sun.com/j2se">Java Development Kit</a> (Version 1.3
   or later)</li>
   
   <li>
  -<a href="http://www.junit.org">JUnit Testing Framework</a> (Version 3.2
  -or later) - for unit tests only, not required for deployment</li>
  +<a href="http://java.sun.com/xml/">JAXP</a> (Version 1.1 or later)</li>
   
   <li>
  -<a href="http://www.webgain.com/products/metamata/java_doc.html">JavaCC</a>
(Version 2.0 or
  -later)</li>
  +<a href="http://www.junit.org">JUnit Testing Framework</a> (Version 3.7
  +or later) - for unit tests only, not required for deployment</li>
   
  +<li>
  +<a href="http://www.webgain.com/products/metamata/java_doc.html">JavaCC</a>
  +(Version 2.0 or later)</li>
   </ul>
   <a NAME="Release Info"></a>
   <h3>
   3. RELEASE INFO</h3>
  -Current Release: <b>Unreleased, CVS Repository Only</b>
  -<p>Planned Next Release: Version 2.0, by September 1, 2001. See the
  -<a href="#Action Items">Action
  -Items</a> list for tasks that need to be completed prior to this release.
  +Current Release: <b>1.0 beta 1</b>
  +<p>Planned Next Release: <b>1.0, timeframe: 27 May, 2002</b>
  +<p>See the
  +<a href="#Action Items">Action Items</a> list for tasks that
  +need to be completed prior to this release.
   <br><a NAME="Committers"></a>
   <h3>
   4. COMMITTERS</h3>
  @@ -67,7 +70,7 @@
   <a NAME="Action Items"></a>
   <h3>
   5. ACTION ITEMS</h3>
  -The following action items need to be completed prior to a Version 2.0
  +The following action items need to be completed prior to a Version 1.0
   release of this component:
   <br>&nbsp;
   <table BORDER >
  @@ -78,12 +81,28 @@
   </tr>
   
   <tr>
  -<td><b>Install / Use Documentation</b>. Create simple installation and
  -User's Guide documentation for this component.</td>
  +<td><b>Documentation</b>. Validate all JavaDoc and user's guide.</td>
  +
  +<td ALIGN=CENTER>Dmitri Plotnikov</td>
  +</tr>
  +
  +<tr>
  +<td><b>Unit Tests.</b> Add more unit tests</td>
  +
  +<td>
  +<center>Dmitri Plotnikov</center>
  +</td>
  +</tr>
  +
  +<tr>
  +<td><b>Fix problems with document order.&nbsp;</b> There are some
cases
  +where JXPath violates the XPath spec in relation to document order.</td>
   
  -<td ALIGN=CENTER></td>
  +<td>
  +<center>Dmitri Plotnikov</center>
  +</td>
   </tr>
   </table>
   
   </body>
  -</html>
  \ No newline at end of file
  +</html>
  
  
  
  1.2       +1 -1      jakarta-commons/jxpath/project.xml
  
  Index: project.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/jxpath/project.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- project.xml	22 Apr 2002 15:40:25 -0000	1.1
  +++ project.xml	28 Apr 2002 22:43:08 -0000	1.2
  @@ -6,7 +6,7 @@
     <id>jakarta-commons-jxpath</id>
     <currentVersion>1.0-beta1-dev</currentVersion>
     <organization>Apache Software Foundation</organization>
  -  <inceptionYear>2002</inceptionYear>
  +  <inceptionYear>2001</inceptionYear>
     <package>org.apache.commons.jxpath</package>
     
     <shortDescription>XPath for Java Objects</shortDescription>
  
  
  
  1.3       +1 -0      jakarta-commons/jxpath/xdocs/stylesheets/project.xml
  
  Index: project.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/jxpath/xdocs/stylesheets/project.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- project.xml	22 Apr 2002 15:35:13 -0000	1.2
  +++ project.xml	28 Apr 2002 22:43:08 -0000	1.3
  @@ -27,6 +27,7 @@
              <item name="Original&amp;nbsp;Proposal"        href="http://cvs.apache.org/viewcvs/~checkout~/jakarta-commons/jxpath/PROPOSAL.html?content-type=text/html"/>
          </menu>
          <menu name="Downloads">
  +           <item name="Release"                       href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-jxpath/"/>
              <item name="Nightly Build"                 href="http://jakarta.apache.org/builds/jakarta-commons/nightly/commons-jxpath/"/>
          </menu>
          <menu name="About Us">
  
  
  

--
To unsubscribe, e-mail:   <mailto:commons-dev-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:commons-dev-help@jakarta.apache.org>


Mime
View raw message