[jboss-cvs] jboss-seam/doc/reference/en/modules ...
Peter Muir
peter at bleepbleep.org.uk
Tue Jan 15 07:30:12 EST 2008
User: pmuir
Date: 08/01/15 07:30:12
Modified: doc/reference/en/modules configuration.xml
Log:
JBSEAM-2494
Revision Changes Path
1.69 +31 -54 jboss-seam/doc/reference/en/modules/configuration.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: configuration.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/configuration.xml,v
retrieving revision 1.68
retrieving revision 1.69
diff -u -b -r1.68 -r1.69
--- configuration.xml 26 Oct 2007 02:59:48 -0000 1.68
+++ configuration.xml 15 Jan 2008 12:30:12 -0000 1.69
@@ -106,8 +106,34 @@
<para>The Seam master filter <emphasis>must</emphasis> be the first filter specified in
<literal>web.xml</literal>. This ensures it is run first. </para>
- <para>To disable a built in filter, you can set <literal>disabled="true"</literal> on
- a particular filter.</para>
+ <para>
+ The Seam filters share a number of common attributes, you can set these in
+ <literal>components.xml</literal> in addition to any parameters discussed
+ below:
+ </para>
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>url-pattern</literal> — Used to specify which requests are filtered, the
+ default is all requests. <literal>url-pattern</literal> is a Tomcat style pattern
+ which allows a wildcard suffix.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>regex-url-pattern</literal> — Used to specify which requests are filtered, the
+ default is all requests. <literal>regex-url-pattern</literal> is a true regular expression
+ match for request path. It's worth noting when composing the regular expression that the request path does not contain
+ the server or request context path.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>disabled</literal> — Used to disable a built in filter.
+ </para>
+ </listitem>
+ </itemizedlist>
<para> Adding the master filter enables the following built-in filters. </para>
@@ -130,13 +156,7 @@
</components>]]></programlisting>
- <itemizedlist>
- <listitem>
- <para>
- <literal>url-pattern</literal> — Used to specify which requests are filtered, the
- default is all requests. </para>
- </listitem>
- </itemizedlist>
+
</sect3>
<sect3>
@@ -149,14 +169,6 @@
in <literal>components.xml</literal>: </para>
<programlisting><![CDATA[<web:redirect-filter url-pattern="*.seam"/>]]></programlisting>
-
- <itemizedlist>
- <listitem>
- <para>
- <literal>url-pattern</literal> — Used to specify which requests are filtered, the
- default is all requests. </para>
- </listitem>
- </itemizedlist>
</sect3>
<sect3>
@@ -183,11 +195,6 @@
(determined by reading the <literal>Content-Length</literal> header in the request) exceeds
this value, the request will be aborted. The default setting is 0 (no size limit). </para>
</listitem>
- <listitem>
- <para>
- <literal>url-pattern</literal> — Used to specify which requests are filtered, the
- default is all requests. </para>
- </listitem>
</itemizedlist>
</sect3>
@@ -215,11 +222,6 @@
<literal>false</literal>, the request encoding will only be set if the request doesn't
already specify an encoding. The default setting is <literal>false</literal>. </para>
</listitem>
- <listitem>
- <para>
- <literal>url-pattern</literal> — Used to specify which requests are filtered, the
- default is all requests. </para>
- </listitem>
</itemizedlist>
</sect3>
@@ -267,11 +269,6 @@
path, relative to web application context, to the log4j.xml configuration file should be
provided. </para>
</listitem>
- <listitem>
- <para>
- <literal>url-pattern</literal> — Used to specify which requests are filtered, the
- default is all requests. </para>
- </listitem>
</itemizedlist>
</sect3>
@@ -294,19 +291,8 @@
<web:logging-filter url-pattern="*.seam"/>
</components>]]></programlisting>
- <itemizedlist>
- <listitem>
- <para>
- <literal>url-pattern</literal> — Used to specify which requests the filter is active for. The
- default is all requests. </para>
- </listitem>
- </itemizedlist>
-
</sect3>
-
-
-
<sect3>
<title>Context management for custom servlets</title>
<para> Requests sent direct to some servlet other than the JSF servlet are not processed through the JSF
@@ -324,15 +310,6 @@
<programlisting><![CDATA[<web:context-filter url-pattern="/media/*"/>]]></programlisting>
- <itemizedlist>
- <listitem>
- <para>
- <literal>url-pattern</literal> — Used to specify which requests are filtered, the
- default is all requests. If the url-pattern is specified for the context filter, then the
- filter will be enabled (unless explicitly disabled). </para>
- </listitem>
- </itemizedlist>
-
<para> The context filter expects to find the conversation id of any conversation context in a request
parameter named <literal>conversationId</literal>. You are responsible for ensuring that it gets
sent in the request. </para>
More information about the jboss-cvs-commits
mailing list