alvinalexander.com | career | drupal | java | mac | mysql | perl | scala | uml | unix  

Commons Digester example source code file (readme.txt)

This example Commons Digester source code file (readme.txt) is included in the DevDaily.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Java by Example" TM.

Java - Commons Digester tags/keywords

apache, asf, conditions, digester, digester, foundation, license, license, rule, see, see, the, the, you

The Commons Digester readme.txt source code

#########################################################################
# 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.
#########################################################################

== overview

The files in this directory are intended as an example of how to use
the Apache Digester to parse "document-markup" style xml. It also serves as an
example of how to subclass the main Digester class in order to extend
its functionality.

By "document-markup" xml, we mean input like XHTML, where the data is valid
xml and where some elements contain interleaved text and child elements.

For example, "<p>Hi, this is some document-style xml.

" Topics covered: * how to subclass digester * how to process markup-style xml. == compiling and running First rename the build.properties.sample file in the parent directory to build.properties and edit it to suit your environment. Then in this directory: * to compile: ant compile * to run: ant run Alternatively, you can set up your CLASSPATH appropriately, and run the example directly. See the build.properties and build.xml files for details. == Notes The primary use of the Digester is to process xml configuration files. Such files do not typically interleave text and child elements in the style encountered with document markup. The standard Digester behaviour is therefore to accumulate all text within an xml element's body (of which there is expected to be only one "segment") and present it to a Rule or user method as a single string. While this significantly simplifies the implementation of Rule classes for the primary Digester goal of parsing configuration files, this process of simplifying all text within an element into a single string "loses" critical information necessary to correctly parse "document-markup" xml. This example shows one method of extending the Digester class to resolve this issue.. At some time the ability to process "document-markup" style xml may be built into the standard Digester class.

Other Commons Digester examples (source code examples)

Here is a short list of links related to this Commons Digester readme.txt source code file:

... this post is sponsored by my books ...

#1 New Release!

FP Best Seller

 

new blog posts

 

Copyright 1998-2021 Alvin Alexander, alvinalexander.com
All Rights Reserved.

A percentage of advertising revenue from
pages under the /java/jwarehouse URI on this website is
paid back to open source projects.