shannon 02/05/30 10:36:04
Added: src/documentation/xdocs/faq faq-matchers.xml
Log:
Created new file in anticipation
of community contributions.
Added useful content from webapp/sitemap.xmap,
userdocs/concepts/matchers_selectors.xml, and
userdocs/matchers/matchers.xml
Revision Changes Path
1.1 xml-cocoon2/src/documentation/xdocs/faq/faq-matchers.xml
Index: faq-matchers.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE faqs PUBLIC "-//APACHE//DTD FAQ V1.0//EN" "../dtd/faq-v10.dtd">
<faqs title="Cocoon Sitemap Matcher FAQs">
<faq>
<question>
What is a matcher?
</question>
<answer>
<p>
A matcher is a core sitemap component of Cocoon. Matchers are used to
determine the flow, order, and components involved in request processing.
Matchers typically contain a generator and a serializer. They may redirect
requests to other pipelines or call other sitemap resources. Matchers may also
be nested with other matchers.
</p>
<p>
Matchers are executed during pipeline setup. They determine which pipeline
will process a URI request. Most typically, the match is based on the requested
URI string. However, a number of other matchers exist, for example, Session and
Cookie matchers.
</p>
<p>
In the sitemap file, each matcher has a unique name which is mapped to a java
class. One matcher name must be declared as the default matcher. Each matcher
may have additional configuration information specified in child elements.
</p>
<p>
For more conceptual information about matchers see <link
href="../userdocs/concepts/matchers_selectors.html">Using and Implementing
Matchers and Selectors</link>. For detailed descriptions about all of the
available Cocoon matchers, see the user's guide document <link
href="../userdocs/matchers/matchers.html">Matchers in Cocoon</link>. You may
also wish to consult the Cocoon API documentation.
</p>
</answer>
</faq>
<faq>
<question>
What is the difference between a selector and a matcher?
</question>
<answer>
<p>
Both matchers and selectors can be used to determine the flow, order, and
components involved in request processing. Their differences include the
complexity of the decisions they can make about processing as well as the
values they return to the sitemap. For a more detailed discussion of their
similarities and differences, see <link
href="../userdocs/concepts/matchers_selectors.html">Using and Implementing
Matchers and Selectors</link>.
</p>
</answer>
</faq>
</faqs>
----------------------------------------------------------------------
In case of troubles, e-mail: [EMAIL PROTECTED]
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
