2:18 a.m.
Author: norman.richards(a)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>