[seam-commits] Seam SVN: r10781 - branches/community/Seam_2_1/doc/Seam_Reference_Guide/en-US.

[seam-commits at lists.jboss.org]

Author: norman.richards at jboss.com
Date: 2009-05-05 03:18:12 -0400 (Tue, 05 May 2009)
New Revision: 10781

Modified:
   branches/community/Seam_2_1/doc/Seam_Reference_Guide/en-US/Configuration.xml
Log:
JBSEAM-3824

Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/en-US/Configuration.xml
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/en-US/Configuration.xml	2009-05-05 06:47:47 UTC (rev 10780)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/en-US/Configuration.xml	2009-05-05 07:18:12 UTC (rev 10781)
@@ -1230,13 +1230,17 @@
 
    @Create
    public void create() {
-      for (Class clazz : fooClasses) {
+      for (Class clazz: fooClasses) {
          handleClass(clazz);
       }
-      for (Class clazz : hotFooClasses) {
+      for (Class clazz: hotFooClasses) {
          handleClass(clazz);
       }
    }
+   
+   public void handleClass(Class clazz) {
+       // ...
+   }
 
 }]]></programlisting>
 
@@ -1247,22 +1251,21 @@
         </para>
         
         <programlisting><![CDATA[public class FooDeploymentHandler implements DeploymentHandler {
-        
-   private Set<InputStream> files = new HashSet<InputStream>();
-        
+    private static DeploymentMetadata FOO_METADATA = new DeploymentMetadata()
+    {
+
+        public String getFileNameSuffix() {
+            return ".foo.xml";
+        }
+    };
+    
    public String getName() {
       return "fooDeploymentHandler";
    }
-   
-   public Set<InputStream> getFiles() {
-      return files;
-   }
-   
-   public void handle(String name, ClassLoader classLoader) {
-      if (name.endsWith(".foo.xml")) {
-         files.add(classLoader.getResourceAsStream(name));
-      }
-   }
+
+    public DeploymentMetadata getMetadata() {
+        return FOO_METADATA;
+    }
 }]]></programlisting>
 
         <para>
@@ -1271,8 +1274,10 @@
         </para>
         
         <para>
-            Then, we need to register the deployment handler with Seam. In
-            <literal>/META-INF/seam-deployment.properties</literal>:
+            Then, we need to register the deployment handler with Seam in
+            <literal>/META-INF/seam-deployment.properties</literal>.  
+            You can register multiple deployment handler using a comma 
+            separated list.
         </para>
         
         <programlisting><![CDATA[# For standard deployment
@@ -1281,15 +1286,12 @@
 org.jboss.seam.deployment.hotDeploymentHandlers=com.acme.FooDeploymentHandler]]></programlisting>
 
          <para>
-             You can register multiple deployment handler using a comma 
-             separated list.
+
          </para>
          
          <para>
              Seam uses deployment handlers internally to install components and
-             namespaces, therefore the <literal>handle()</literal> is called too
-             early in inside Seam bootstrap to normally be useful. However, you
-             can easily access the deployment handler during an 
+             namespaces. You can easily access the deployment handler during an 
              <literal>APPLICATION</literal> scoped component's startup: 
          </para>
          
@@ -1298,22 +1300,26 @@
 @Startup
 public class FooStartup {
 
-   @In("#{deploymentStrategy['fooDeploymentHandler']}")
-   private MyDeploymentHandler myDeploymentHandler;
+   @In("#{deploymentStrategy.deploymentHandlers['fooDeploymentHandler']}")
+   private FooDeploymentHandler myDeploymentHandler;
    
-   @In("#{hotDeploymentStrategy['fooDeploymentHandler']}")
-   private MyDeploymentHandler myHotDeploymentHandler;
+   @In("#{hotDeploymentStrategy.deploymentHandlers['fooDeploymentHandler']}")
+   private FooDeploymentHandler myHotDeploymentHandler;
 
    @Create
    public void create() {
-      for (InputStream is : myDeploymentHandler.getFiles()) {
-         handleFooXml(is);
+      for (FileDescriptor fd: myDeploymentHandler.getResources()) {
+           handleFooXml(fd);
       }
-      for (InputStream is : myHotDeploymentHandler.getFiles()) {
-         handleFooXml(is);
+      
+      for (FileDescriptor f: myHotDeploymentHandler.getResources()) {
+           handleFooXml(fd);
       }
    }
 
+   public void handleFooXml(FileDescriptor fd) {
+       // ...
+   }
 }]]></programlisting>
 
     </sect1>