Package com.arsdigita.templating.html

This package provides facilities for implementing little HTML-like markup languages that extend HTML.

See:
          Description

Interface Summary
AttributeMap Similar to the Attributes interface in SAX.
AttributeMap.Pair Represents a single attribute as a name-value pair.
ContentHandler Receives notification of the logical content of a document.
HTMLParser This interface is intended to provide limited support for templating in the context of CMS and similar applications, where users are expected to submit HTML that may have custom tags that have to be processed programmaticaly.
 

Class Summary
AttributeMapImpl An implementation of the AttributeMap interface.
HTMLlat1 Defines Character entity references for ISO 8859-1 characters.
HTMLParserFactory Different projects may need different HTML parsers.
HTMLspec Defines Character entity references for markup-significant and internationalization characters.
HTMLsym Defines Character entity references for symbols, mathematical symbols, and Greek letters.
StringTemplate A utility class to make it easier to read Java code that generates HTML.
XHTMLParser A SAX-based implementation of HTMLParser.
 

Exception Summary
HTMLParserConfigurationException Encapsulates a configuration error.
HTMLParserException Encapsulates a general html parser error or warning.
 

Package com.arsdigita.templating.html Description

This package provides facilities for implementing little HTML-like markup languages that extend HTML. See HTMLParser and com.arsdigita.templating.html.demo for concrete examples.

Conceptually, the package revolves around two interfaces: HTMLParser and ContentHandler. An html parser can read HTML text and dispatch events to the content handler. The content handler may then process custom tags in a useful manner.

At this time, the package only provides a single implementation of the HTMLParser interface, namely, the XHTMLParser class that relies on a SAX parser to perform the actual parsing.

One example implementation of the ContentHandler is provided by DemoTagHandler.

Another possible implementation of the ContentHandler interface would be a class that "understands" custom "link" tags of the following form:

<p>As we mentioned in our <link cms_id="23889">previous article</link>,
serious Java practitioner tend to shun the
<a href="http://www.google.com/search?q=double-checked+locking">Double-Checked
Locking</a> pattern...
    

where the <link> tag may be used to link one CMS article to another.



Copyright (c) 2004 Red Hat, Inc. Corporation. All Rights Reserved. Generated at July 21 2004:2337 UTC