Other Commons Digester examples (source code examples)
Here is a short list of links related to this Commons Digester index.xml source code file:
The search page
Other Commons Digester source code examples at this package level
Click here to learn more about this project
Commons Digester example source code file (index.xml)
The Commons Digester index.xml source code<?xml version="1.0"?>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document xmlns="http://maven.apache.org/XDOC/2.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
<properties>
<title>Commons
<author email="dev@commons.apache.org">Commons Documentation Team
</properties>
<body>
<section name="The Digester Component">
<p>Many projects read XML configuration files to provide initialization
of various Java objects within the system. There are several ways of doing
this, and the <em>Digester component was designed to provide a common
implementation that can be used in many different projects.</p>
<p>Basically, the Digester package lets you configure an XML ->
Java object mapping module, which triggers certain actions called
<em>rules whenever a particular pattern of nested XML elements is
recognized. A rich set of predefined <em>rules is available for your
use, or you can also create your own. Advanced features of <em>Digester
include:</p>
<ul>
<li>Ability to plug in your own pattern matching engine, if the standard one
is not sufficient for your requirements.</li>
<li>Optional namespace-aware processing, so that you can define rules that
are relevant only to a particular XML namespace.</li>
<li>Encapsulation of Rules into RuleSets that can be
easily and conveniently reused in more than one application that requires
the same type of processing.</li>
</ul>
<p>Starting from release 2.1, the Digester supports Java5 Annotations definition
of rules improving maintainability of both Java code and XML documents, since
rules are now defined in POJOs and <code>Digester parser instances can be
generated at run-time, avoiding manual updates.</p>
</section>
<section name="Documentation">
<p>User documentation is available in the website, you can start reading the
<a href="http://commons.apache.org/digester/commons-digester-2.1/core.html">Core APIs.
<p>The
Release Notes</a> document the new features and bug fixes that have been
included in this release.</p>
<p>The "examples" directory in the source code repository contains code which
demonstrates the basic functionality. In particular, you should read the
AddressBook example in the "api" subdirectory. You can view the examples
directly from the Subversion repository via <a
href="http://svn.apache.org/viewvc/commons/proper/digester/trunk/src/examples/">
the web-based repository browser</a> web site, or can use subversion to
download the files.
</p>
<p>For the FAQ and other digester-related information, see
<a href="http://wiki.apache.org/commons/Digester">the Digester wiki page.
</p>
</section>
<section name="Releases">
<subsection name="Digester 2.1 Release (September 2010)">
<p>
Digester 2.1 is a minor release with new features, a new <code>annotations package
adds facilities to configure the Digester using the Java5 language meta-data annotations,
allowing Digester instances creation introspecting the target POJOs, using a provided set
of annotations. New projects are encouraged to use this release of digester.
<br/>
There are breaking changes from Digester 2.0, see release notes in detail before choosing
to upgrade.
<br/>
There is no urgency for existing projects to upgrade; Digester 2.0 has proven to be a
stable release.
</p>
<p>
Digester 2.1 <b>requires a minimum of JDK 1.5.
</p>
<p>
The recommended dependency set for Digester 2.1 is:
</p>
<table>
<tr>
<th colspan='3'>Recommended Dependency Set
</tr>
<tr>
<td>Digester |
