shannon 02/05/30 10:38:43
Added: src/documentation/xdocs/faq faq-selectors.xml
Log:
userdocs/faq/faq-selectors.xml
Created new file in anticipation
of community contributions.
Added basic definition.
Added useful content from webapp/sitemap.xmap,
userdocs/concepts/matchers_selectors.xml, and
userdocs/selectors/selectors.xml
Revision Changes Path
1.1 xml-cocoon2/src/documentation/xdocs/faq/faq-selectors.xml
Index: faq-selectors.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 Selector FAQs">
<faq>
<question>
What is a selector?
</question>
<answer>
<p>
A selector is a core sitemap component of Cocoon. Selectors are designed to evaluate
a
generally simple boolean expression regarding some part of the environment (request
URI, headers, or cookies, for example). The result of this evaluation determines which
pipeline fragments should be combined within a given pipeline. Selectors are executed
during pipeline setup.
</p>
<p>
In the sitemap file, each selector has a unique name which is mapped to a java
class. One selector name must be declared as the default selector. Each selector may
have additional configuration information specified in child elements.
</p>
<p>
For more conceptual information about selectors see <link
href="../userdocs/concepts/matchers_selectors.html">Using and Implementing Matchers
and Selectors</link>. For detailed descriptions about all of the available Cocoon
selectors, see the user's guide document <link
href="../userdocs/selectors/selectors.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]
