Return-Path: 
 <click-commits-return-595-apmail-incubator-click-commits-archive=incubator.apache.org@incubator.apache.org>
Delivered-To: apmail-incubator-click-commits-archive@minotaur.apache.org
Received: (qmail 24094 invoked from network); 7 Jun 2009 12:55:51 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.3)
  by minotaur.apache.org with SMTP; 7 Jun 2009 12:55:51 -0000
Received: (qmail 8442 invoked by uid 500); 7 Jun 2009 12:56:02 -0000
Delivered-To: apmail-incubator-click-commits-archive@incubator.apache.org
Received: (qmail 8429 invoked by uid 500); 7 Jun 2009 12:56:02 -0000
Mailing-List: contact click-commits-help@incubator.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:click-commits-help@incubator.apache.org>
List-Unsubscribe: <mailto:click-commits-unsubscribe@incubator.apache.org>
List-Post: <mailto:click-commits@incubator.apache.org>
List-Id: <click-commits.incubator.apache.org>
Reply-To: click-dev@incubator.apache.org
Delivered-To: mailing list click-commits@incubator.apache.org
Received: (qmail 8419 invoked by uid 99); 7 Jun 2009 12:56:02 -0000
Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136)
    by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 07 Jun 2009 12:56:02 +0000
X-ASF-Spam-Status: No, hits=-2000.0 required=10.0
	tests=ALL_TRUSTED
X-Spam-Check-By: apache.org
Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4)
    by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 07 Jun 2009 12:56:00 +0000
Received: by eris.apache.org (Postfix, from userid 65534)
	id 8D59D238888F; Sun,  7 Jun 2009 12:55:40 +0000 (UTC)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r782382 -
 /incubator/click/trunk/tools/docbook/src/docbook/click/chapter-configuration.xml
Date: Sun, 07 Jun 2009 12:55:40 -0000
To: click-commits@incubator.apache.org
From: medgar@apache.org
X-Mailer: svnmailer-1.0.8
Message-Id: <20090607125540.8D59D238888F@eris.apache.org>
X-Virus-Checked: Checked by ClamAV on apache.org

Author: medgar
Date: Sun Jun  7 12:55:40 2009
New Revision: 782382

URL: http://svn.apache.org/viewvc?rev=782382&view=rev
Log:
updated doco

Modified:
    incubator/click/trunk/tools/docbook/src/docbook/click/chapter-configuration.xml

Modified: incubator/click/trunk/tools/docbook/src/docbook/click/chapter-configuration.xml
URL: http://svn.apache.org/viewvc/incubator/click/trunk/tools/docbook/src/docbook/click/chapter-configuration.xml?rev=782382&r1=782381&r2=782382&view=diff
==============================================================================
--- incubator/click/trunk/tools/docbook/src/docbook/click/chapter-configuration.xml (original)
+++ incubator/click/trunk/tools/docbook/src/docbook/click/chapter-configuration.xml Sun Jun  7 12:55:40 2009
@@ -133,8 +133,72 @@
       strategy is configured with the Click application mode element in the
       "<filename>click.xml</filename>" config file, covered next.
       </para>
+    </sect2>
+    
+    
+    <sect2 id="type-converter-class" remap="h3">
+      <title>Type Converter Class</title>
+
+      <para>
+      The ClickServlet uses the OGNL library for type coercion when binding
+      request parameters to bindable fields. The default type converter class 
+      use is <ulink url="click-api/org/apache/click/util/RequestTypeConverter.html">RequestTypeConverter</ulink>.
+      To specify your own type converter configure a <literal>type-converter-class</literal>
+      init parameter with the ClickServlet. For example:
+      </para>
+      
+        <programlisting language="xml">
+  &lt;servlet&gt;
+    &lt;servlet-name&gt;ClickServlet&lt;/servlet-name&gt;
+    &lt;servlet-class&gt;org.apache.click.ClickServlet&lt;/servlet-class&gt;
+    &lt;load-on-startup&gt;0&lt;/load-on-startup&gt;
+    &lt;init-param&gt;
+	    &lt;param-name&gt;type-converter-class&lt;/param-name&gt;
+	    &lt;param-value&gt;com.mycorp.util.CustomTypeConverter&lt;/param-value&gt;
+    &lt;/init-param&gt;
+  &lt;/servlet&gt;
+		</programlisting>
+
+    </sect2>    
+    
+    <sect2 id="config-service-class" remap="h3">
+      <title>Config Service Classs</title>
 
+      <para>
+      Click uses a single application configuration service which is
+      instantiated by the ClickServlet at startup. This service defines the 
+      applications configuration and is used the ClickServlet to map request
+      to pages amongst other things.
+      </para>
+ 		
+ 	  <para>
+      Once the ConfigService has been initialized it is stored in the
+      ServletContext using the key  <ulink url="click-api/org/apache/click/service/ConfigService.html">ConfigService</ulink>
+      The default ConfigService is <ulink url="click-api/org/apache/click/service/XmlConfigService.html">XmlConfigService</ulink>.     
+      To us an alternative configuration service specify a <literal>config-service-class</literal> 
+      context parameter. For example:
+ 	  </para>
+      
+        <programlisting language="xml">
+&lt;web-app xmlns="http://java.sun.com/xml/ns/j2ee"
+   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+   xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
+   version="2.4"&gt;
+
+ ...
+
+     &lt;context-param&gt;
+         &lt;param-name&gt;config-service-class&lt;/param-name&gt;
+          &lt;param-value&gt;com.mycorp.service.CustomConfigSerivce&lt;/param-value&gt;
+      &lt;/context-param&gt;
+ 
+  ...
+ 
+ &lt;/web-app&gt;
+		</programlisting>
+      
     </sect2>
+    
   </sect1>
 
   <sect1 id="application-configuration" remap="h2">