You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tomee.apache.org by bu...@apache.org on 2011/07/12 20:06:36 UTC
svn commit: r792601 [19/49] - /websites/staging/openejb/trunk/content/
Modified: websites/staging/openejb/trunk/content/javaagent-with-maven-surefire.html
==============================================================================
--- websites/staging/openejb/trunk/content/javaagent-with-maven-surefire.html (original)
+++ websites/staging/openejb/trunk/content/javaagent-with-maven-surefire.html Tue Jul 12 18:06:32 2011
@@ -152,12 +152,12 @@
<P>
<!-- $BODY -->
<DIV id="PageContent">
- <p><a name="JavaAgentwithMavenSurefire-Maven2"><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">a></p>
+ <p><a name="JavaAgentwithMavenSurefire-Maven2"></a></p>
<h2>Maven2</h2>
<p>In maven2 you can enable the javaagent for your tests by adding this to
-your pom.<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ml file:</p>
+your pom.xml file:</p>
<pre><code><build>
<plugins>
@@ -166,48 +166,48 @@ your pom.<IMG class="emoticon" src="http
<p>javaagent enabled -->
<plugin>
- <groupId>org.apache.maven.plugins<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">groupId>
- <artifactId>maven-surefire-plugin<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">artifactId>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
<configuration>
- <forkMode>pertest<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">forkMode></p>
+ <forkMode>pertest</forkMode></p>
-<p><argLine>-javaagent:${basedir}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">target<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-javaagent-3.0.jar<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">argLine>
- <workingDirectory>${basedir}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">target<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">workingDirectory>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">configuration>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">plugin></p>
+<p><argLine>-javaagent:${basedir}/target/openejb-javaagent-3.0.jar</argLine>
+ <workingDirectory>${basedir}/target</workingDirectory>
+ </configuration>
+ </plugin></p>
<pre><code> <!-- this tells maven to copy the openejb-javaagent jar into your
</code></pre>
-<p>target<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0"> directory -->
+<p>target/ directory -->
<!-- where surefire can see it -->
<plugin>
- <groupId>org.apache.maven.plugins<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">groupId>
- <artifactId>maven-dependency-plugin<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">artifactId>
- <e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ecutions>
- <e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ecution>
- <id>copy<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">id>
- <phase>process-resources<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">phase>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-dependency-plugin</artifactId>
+ <executions>
+ <execution>
+ <id>copy</id>
+ <phase>process-resources</phase>
<goals>
- <goal>copy<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">goal>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">goals>
+ <goal>copy</goal>
+ </goals>
<configuration>
<artifactItems>
<artifactItem>
- <groupId>org.apache.openejb<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">groupId>
- <artifactId>openejb-javaagent<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">artifactId>
- <version>3.0<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">version></p>
-
-<p><outputDirectory>${project.build.directory}<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">outputDirectory>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">artifactItem>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">artifactItems>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">configuration>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ecution>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ecutions>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">plugin></p>
+ <groupId>org.apache.openejb</groupId>
+ <artifactId>openejb-javaagent</artifactId>
+ <version>3.0</version></p>
+
+<p><outputDirectory>${project.build.directory}</outputDirectory>
+ </artifactItem>
+ </artifactItems>
+ </configuration>
+ </execution>
+ </executions>
+ </plugin></p>
-<pre><code> <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">plugins>
-<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">build>
+<pre><code> </plugins>
+</build>
</code></pre>
</DIV>
Modified: websites/staging/openejb/trunk/content/javaagent.html
==============================================================================
--- websites/staging/openejb/trunk/content/javaagent.html (original)
+++ websites/staging/openejb/trunk/content/javaagent.html Tue Jul 12 18:06:32 2011
@@ -152,7 +152,7 @@
<P>
<!-- $BODY -->
<DIV id="PageContent">
- <p><a name="JavaAgent-AddingaJavaAgent"><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">a></p>
+ <p><a name="JavaAgent-AddingaJavaAgent"></a></p>
<h1>Adding a JavaAgent</h1>
@@ -167,54 +167,54 @@ _
The java agent is only required if using OpenJPA as your persistence
provider or if using CMP.
{note}
-<a name="JavaAgent-Maven2"><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">a></p>
+<a name="JavaAgent-Maven2"></a></p>
<h2>Maven2</h2>
<p>In maven2 you can enable the javaagent for your tests by adding this to
-your pom.<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ml file:</p>
+your pom.xml file:</p>
<pre><code><build>
<plugins>
<!-- this configures the surefire plugin to run your tests with the javaagent enabled -->
<plugin>
- <groupId>org.apache.maven.plugins<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">groupId>
- <artifactId>maven-surefire-plugin<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">artifactId>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
<configuration>
- <forkMode>pertest<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">forkMode>
- <argLine>-javaagent:${basedir}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">target<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-javaagent-3.0-beta-2.jar<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">argLine>
- <workingDirectory>${basedir}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">target<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">workingDirectory>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">configuration>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">plugin>
+ <forkMode>pertest</forkMode>
+ <argLine>-javaagent:${basedir}/target/openejb-javaagent-3.0-beta-2.jar</argLine>
+ <workingDirectory>${basedir}/target</workingDirectory>
+ </configuration>
+ </plugin>
- <!-- this tells maven to copy the openejb-javaagent jar into your target<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0"> directory -->
+ <!-- this tells maven to copy the openejb-javaagent jar into your target/ directory -->
<!-- where surefire can see it -->
<plugin>
- <groupId>org.apache.maven.plugins<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">groupId>
- <artifactId>maven-dependency-plugin<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">artifactId>
- <e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ecutions>
- <e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ecution>
- <id>copy<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">id>
- <phase>process-resources<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">phase>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-dependency-plugin</artifactId>
+ <executions>
+ <execution>
+ <id>copy</id>
+ <phase>process-resources</phase>
<goals>
- <goal>copy<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">goal>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">goals>
+ <goal>copy</goal>
+ </goals>
<configuration>
<artifactItems>
<artifactItem>
- <groupId>org.apache.openejb<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">groupId>
- <artifactId>openejb-javaagent<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">artifactId>
- <version>3.0-beta-2<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">version>
- <outputDirectory>${project.build.directory}<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">outputDirectory>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">artifactItem>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">artifactItems>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">configuration>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ecution>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ecutions>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">plugin>
+ <groupId>org.apache.openejb</groupId>
+ <artifactId>openejb-javaagent</artifactId>
+ <version>3.0-beta-2</version>
+ <outputDirectory>${project.build.directory}</outputDirectory>
+ </artifactItem>
+ </artifactItems>
+ </configuration>
+ </execution>
+ </executions>
+ </plugin>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">plugins>
-<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">build>
+ </plugins>
+</build>
</code></pre>
</DIV>
Modified: websites/staging/openejb/trunk/content/jms-resources-and-mdb-container.html
==============================================================================
--- websites/staging/openejb/trunk/content/jms-resources-and-mdb-container.html (original)
+++ websites/staging/openejb/trunk/content/jms-resources-and-mdb-container.html Tue Jul 12 18:06:32 2011
@@ -152,28 +152,28 @@
<P>
<!-- $BODY -->
<DIV id="PageContent">
- <p><a name="JMSResourcesandMDBContainer-E<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ternalActiveMQBroker"><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">a></p>
+ <p><a name="JMSResourcesandMDBContainer-ExternalActiveMQBroker"></a></p>
-<h1>E<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ternal ActiveMQ Broker</h1>
+<h1>External ActiveMQ Broker</h1>
<pre><code><openejb>
<Resource id="MyJmsResourceAdapter" type="ActiveMQResourceAdapter">
# Do not start the embedded ActiveMQ broker
BrokerXmlConfig
- ServerUrl tcp:<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0"><IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">someHostName:61616
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">Resource>
+ ServerUrl tcp://someHostName:61616
+ </Resource>
- <Resource id="MyJmsConnectionFactory" type="java<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">.jms.ConnectionFactory">
+ <Resource id="MyJmsConnectionFactory" type="javax.jms.ConnectionFactory">
ResourceAdapter MyJmsResourceAdapter
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">Resource>
+ </Resource>
<Container id="MyJmsMdbContainer" ctype="MESSAGE">
ResourceAdapter MyJmsResourceAdapter
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">Container>
+ </Container>
- <Resource id="FooQueue" type="java<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">.jms.Queue"<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">>
- <Resource id="BarTopic" type="java<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">.jms.Topic"<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">>
-<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb>
+ <Resource id="FooQueue" type="javax.jms.Queue"/>
+ <Resource id="BarTopic" type="javax.jms.Topic"/>
+</openejb>
</code></pre>
<p>The {{ServerUrl}} would be changed to point to the host and port of the
@@ -181,36 +181,36 @@ ActiveMQ process. The various URL forma
work, such as 'failover:'.</p>
<p>The same can be done via properties in an embedded configuration, via the
-{{conf<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">system.properties}} file or on the command line via {{-D}} flags.</p>
+{{conf/system.properties}} file or on the command line via {{-D}} flags.</p>
<pre><code>Properties p = new Properties();
-p.put(Conte<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">t.INITIAL_CONTEXT_FACTORY, LocalInitialConte<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">tFactory.class.getName());
+p.put(Context.INITIAL_CONTEXT_FACTORY, LocalInitialContextFactory.class.getName());
-p.put("MyJmsResourceAdapter", "new:<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0"><IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">Resource?type=ActiveMQResourceAdapter");
-p.put("MyJmsResourceAdapter.ServerUrl", "tcp:<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0"><IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">someHostName:61616");
-<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0"><IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0"> Do not start the ActiveMQ broker
+p.put("MyJmsResourceAdapter", "new://Resource?type=ActiveMQResourceAdapter");
+p.put("MyJmsResourceAdapter.ServerUrl", "tcp://someHostName:61616");
+// Do not start the ActiveMQ broker
p.put("MyJmsResourceAdapter.BrokerXmlConfig", "");
-p.put("MyJmsConnectionFactory", "new:<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0"><IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">Resource?type=java<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">.jms.ConnectionFactory");
+p.put("MyJmsConnectionFactory", "new://Resource?type=javax.jms.ConnectionFactory");
p.put("MyJmsConnectionFactory.ResourceAdapter", "MyJmsResourceAdapter");
-p.put("MyJmsMdbContainer", "new:<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0"><IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">Container?type=MESSAGE");
+p.put("MyJmsMdbContainer", "new://Container?type=MESSAGE");
p.put("MyJmsMdbContainer.ResourceAdapter", "MyJmsResourceAdapter");
-p.put("FooQueue", "new:<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0"><IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">Resource?type=java<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">.jms.Queue");
-p.put("BarTopic", "new:<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0"><IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">Resource?type=java<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">.jms.Topic");
+p.put("FooQueue", "new://Resource?type=javax.jms.Queue");
+p.put("BarTopic", "new://Resource?type=javax.jms.Topic");
-InitialConte<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">t conte<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">t = new InitialConte<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">t(p);
+InitialContext context = new InitialContext(p);
</code></pre>
<p>From anywhere in the same VM as the EJB Container you could lookup the
above resources like so:</p>
-<pre><code>java<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">.jms.ConnectionFactory cf = (ConnectionFactory)
- conte<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">t.lookup("openejb:Resource<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">MyJmsConnectionFactory");
+<pre><code>javax.jms.ConnectionFactory cf = (ConnectionFactory)
+ context.lookup("openejb:Resource/MyJmsConnectionFactory");
-java<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">.jms.Queue queue = (Queue) conte<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">t.lookup("openejb:Resource<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">FooQueue");
-java<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">.jms.Topic topic = (Topic) conte<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">t.lookup("openejb:Resource<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">BarTopic");
+javax.jms.Queue queue = (Queue) context.lookup("openejb:Resource/FooQueue");
+javax.jms.Topic topic = (Topic) context.lookup("openejb:Resource/BarTopic");
</code></pre>
<h1>Internal ActiveMQ Broker</h1>
Modified: websites/staging/openejb/trunk/content/jndi-names.html
==============================================================================
--- websites/staging/openejb/trunk/content/jndi-names.html (original)
+++ websites/staging/openejb/trunk/content/jndi-names.html Tue Jul 12 18:06:32 2011
@@ -152,7 +152,7 @@
<P>
<!-- $BODY -->
<DIV id="PageContent">
- <p><a name="JNDINames-What'sMyBean'sJNDIName?"><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">a></p>
+ <p><a name="JNDINames-What'sMyBean'sJNDIName?"></a></p>
<h1>What's My Bean's JNDI Name?</h1>
@@ -160,7 +160,7 @@
1. OpenEJB provides a default JNDI name to your EJB.
1. You can customize the JNDI name.</p>
-<p><a name="JNDINames-DefaultJNDIname"><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">a></p>
+<p><a name="JNDINames-DefaultJNDIname"></a></p>
<h2>Default JNDI name</h2>
@@ -174,11 +174,11 @@
pre-defined variables available which you could use to customize the JNDI
name format.</p>
-<p><a name="JNDINames-JNDINameFormatting"><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">a></p>
+<p><a name="JNDINames-JNDINameFormatting"></a></p>
<h1>JNDI Name Formatting</h1>
-<p>{e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">cerpt}
+<p>{excerpt}
The <em>openejb.jndiname.format</em> property allows you to supply a template for
the global JNDI names of all your EJBs. With it, you have complete control
over the structure of the JNDI layout can institute a design pattern just
@@ -197,10 +197,10 @@ MESSAGE_DRIVEN |
results in <em>WidgetBean</em> |
| ejbClass.packageName | for a class named <em>org.acme.superfun.WidgetBean</em>
results in <em>org.acme.superfun</em> |
- | ejbName | The ejb-name as specified in <IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ml or via the 'name' attribute
+ | ejbName | The ejb-name as specified in xml or via the 'name' attribute
in an @Stateful, @Stateless, or @MessageDriven annotation |
| deploymentId | The unique system id for the ejb. Typically the ejbName
-unless specified in the openejb-jar.<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ml or via changing the
+unless specified in the openejb-jar.xml or via changing the
openejb.deploymentId.format |
| interfaceType | see interfaceType.annotationName |
| interfaceType.annotationName | Following the EJB 3 annotations
@@ -209,15 +209,16 @@ openejb.deploymentId.format |
- <em>LocalHome</em> <em>(EJB 2 EJBLocalHome)</em>
- <em>Remote</em> <em>(EJB 3 Business Remote)</em>
- <em>Local</em> <em>(EJB 3 Business Local)</em>
-- <em>Endpoint</em> <em>(EJB webservice endpoint)</em>
+- <em>Endpoint</em> <em>(EJB webservice endpoint)</em></p>
+
<table>
-<tr><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">tr>
+<tr></tr>
| interfaceType.annotationNameLC | This is the same as
interfaceType.annotationName, but all in lower case.
-<tr><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">tr>
-<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">table></p>
+<tr></tr>
+</table>
-<p>| interfaceType.<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">mlName | Following the ejb-jar.<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ml descriptor elements
+<p>| interfaceType.xmlName | Following the ejb-jar.xml descriptor elements
<home>, <local-home>, <business-remote>, <business-local>, and
<service-endpoint>:
- <em>home</em> <em>(EJB 2 EJBHome)</em>
@@ -226,7 +227,7 @@ interfaceType.annotationName, but all in
- <em>business-local</em> <em>(EJB 3 Business Local)</em>
- <em>service-endpoint</em> <em>(EJB webservice endpoint)</em>
|
- | interfaceType.<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">mlNameCc | Camel-case version of interfaceType.<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">mlName:
+ | interfaceType.xmlNameCc | Camel-case version of interfaceType.xmlName:
- <em>Home</em> <em>(EJB 2 EJBHome)</em>
- <em>LocalHome</em> <em>(EJB 2 EJBLocalHome)</em>
- <em>BusinessRemote</em> <em>(EJB 3 Business Remote)</em>
@@ -243,63 +244,64 @@ format:
<em>org.acme.superfun.WidgetRemote</em> results in
<em>org.acme.superfun.WidgetRemote</em>
- <em>(home)</em> for a class named <em>org.acme.superfun.WidgetHome</em> results in
-<em>org.acme.superfun.WidgetHome</em>
+<em>org.acme.superfun.WidgetHome</em></p>
+
<table>
-<tr><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">tr>
- | interfaceClass.simpleName | - <em>(business)</em> for a class named
-<em>org.acme.superfun.WidgetRemote</em> results in <em>WidgetRemote</em>
-- <em>(home)</em> for a class named <em>org.acme.superfun.WidgetHome</em> results in
-<em>WidgetHome</em> |
+<tr></tr>
+ | interfaceClass.simpleName | - _(business)_ for a class named
+_org.acme.superfun.WidgetRemote_ results in *WidgetRemote*
+- _(home)_ for a class named _org.acme.superfun.WidgetHome_ results in
+*WidgetHome* |
| interfaceClass.packageName | for a class named
-<em>org.acme.superfun.WidgetRemote</em> results in <em>org.acme.superfun</em> |
-{e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">cerpt}
-<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">table></p>
+_org.acme.superfun.WidgetRemote_ results in *org.acme.superfun* |
+{excerpt}
+</table>
-<p><a name="JNDINames-SettingtheJNDIname"><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">a></p>
+<p><a name="JNDINames-SettingtheJNDIname"></a></p>
<h1>Setting the JNDI name</h1>
<p>It's possible to set the desired jndi name format for the whole server
level, an ejb-jar, an ejb, an ejb's "local" interface
-(local<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">remote<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">local-home<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">home), and for an individual interface the ejb
+(local/remote/local-home/home), and for an individual interface the ejb
implements. More specific jndi name formats act as an override to any more
general formats. The most specific format dictates the jndi name that will
be used for any given interface of an ejb. It's possible to specify a
general format for your server, override it at an ejb level and override
that further for a specific interface of that ejb.</p>
-<p><a name="JNDINames-ViaSystemproperty"><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">a></p>
+<p><a name="JNDINames-ViaSystemproperty"></a></p>
<h2>Via System property</h2>
<p>The jndi name format can be set on a server level via a <em>system property</em>,
-for e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ample:</p>
+for example:</p>
<p>{panel:border=dotted}
-$ .<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">bin<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb start
-"-Dopenejb.jndiname.format={ejbName}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{interfaceClass}"
+$ ./bin/openejb start
+"-Dopenejb.jndiname.format={ejbName}/{interfaceClass}"
{panel}</p>
<p>As usual, other ways of specifying system properties are via the
-conf<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">system.properties file in a standalone server, or via the
-InitialConte<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">t properties when embedded.</p>
+conf/system.properties file in a standalone server, or via the
+InitialContext properties when embedded.</p>
-<p><a name="JNDINames-Viapropertiesintheopenejb-jar.<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ml"><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">a></p>
+<p><a name="JNDINames-Viapropertiesintheopenejb-jar.xml"></a></p>
-<h2>Via properties in the openejb-jar.<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ml</h2>
+<h2>Via properties in the openejb-jar.xml</h2>
<p>It's possible to set the openejb.jndiname.format for an ejb-jar jar in a
-META-INF<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-jar.<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ml file as follows:</p>
+META-INF/openejb-jar.xml file as follows:</p>
<pre><code><openejb-jar>
<properties>
openejb.deploymentId.format = {ejbName}
openejb.jndiname.format = {deploymentId}{interfaceType.annotationName}
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">properties>
-<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-jar>
+ </properties>
+</openejb-jar>
</code></pre>
-<p><a name="JNDINames-Viathe<jndi>tagforaspecificejb"><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">a></p>
+<p><a name="JNDINames-Viathe<jndi>tagforaspecificejb"></a></p>
<h2>Via the <jndi> tag for a specific ejb</h2>
@@ -308,41 +310,41 @@ org.superbiz.Foo.</p>
<pre><code><openejb-jar>
<ejb-deployment ejb-name="FooBean">
- <jndi name="foo" interface="org.superbiz.Foo"<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">ejb-deployment>
-<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-jar>
+ <jndi name="foo" interface="org.superbiz.Foo"/>
+ </ejb-deployment>
+</openejb-jar>
</code></pre>
<p>Or more generally...</p>
<pre><code><openejb-jar>
<ejb-deployment ejb-name="FooBean">
- <jndi name="foo" interface="Remote"<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">ejb-deployment>
-<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-jar>
+ <jndi name="foo" interface="Remote"/>
+ </ejb-deployment>
+</openejb-jar>
</code></pre>
<p>Or more generally still...</p>
<pre><code><openejb-jar>
<ejb-deployment ejb-name="FooBean">
- <jndi name="foo"<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">ejb-deployment>
-<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-jar>
+ <jndi name="foo"/>
+ </ejb-deployment>
+</openejb-jar>
</code></pre>
<p>The 'name' attribute can still use templates if it likes, such as: </p>
<pre><code><openejb-jar>
<ejb-deployment ejb-name="FooBean">
- <jndi name="ejb<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{interfaceClass.simpleName}"
+ <jndi name="ejb/{interfaceClass.simpleName}"
</code></pre>
-<p>interface="org.superbiz.Foo"<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">ejb-deployment>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-jar></p>
+<p>interface="org.superbiz.Foo"/>
+ </ejb-deployment>
+ </openejb-jar></p>
-<p><a name="JNDINames-Multiple<jndi>tags"><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">a></p>
+<p><a name="JNDINames-Multiple<jndi>tags"></a></p>
<h3>Multiple <jndi> tags</h3>
@@ -358,21 +360,21 @@ group of iterfaces (Local, Remote, Local
- home: org.superbiz.FooHome
- local-home: org.superbiz.FooLocalHome</p>
-<p>The following four e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">amples would yield the same jndi names. The intention
-with these e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">amples is to show the various ways you can isolate specific
+<p>The following four examples would yield the same jndi names. The intention
+with these examples is to show the various ways you can isolate specific
interfaces or types of interfaces to gain more specific control on how they
are named.</p>
<pre><code><openejb-jar>
<ejb-deployment ejb-name="FooBean">
- <jndi name="LocalOne" interface="org.superbiz.LocalOne"<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">>
- <jndi name="LocalTwo" interface="org.superbiz.LocalTwo"<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">>
- <jndi name="RemoteOne" interface="org.superbiz.RemoteOne"<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">>
- <jndi name="RemoteTwo" interface="org.superbiz.RemoteTwo"<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">>
- <jndi name="FooHome" interface="org.superbiz.FooHome"<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">>
- <jndi name="FooLocalHome" interface="org.superbiz.FooLocalHome"<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">ejb-deployment>
-<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-jar>
+ <jndi name="LocalOne" interface="org.superbiz.LocalOne"/>
+ <jndi name="LocalTwo" interface="org.superbiz.LocalTwo"/>
+ <jndi name="RemoteOne" interface="org.superbiz.RemoteOne"/>
+ <jndi name="RemoteTwo" interface="org.superbiz.RemoteTwo"/>
+ <jndi name="FooHome" interface="org.superbiz.FooHome"/>
+ <jndi name="FooLocalHome" interface="org.superbiz.FooLocalHome"/>
+ </ejb-deployment>
+</openejb-jar>
</code></pre>
<p>Or</p>
@@ -380,18 +382,18 @@ are named.</p>
<pre><code><openejb-jar>
<ejb-deployment ejb-name="FooBean">
<!-- applies to LocalOne and LocalTwo -->
- <jndi name="{interfaceClass.simpleName}" interface="Local"<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">>
+ <jndi name="{interfaceClass.simpleName}" interface="Local"/>
<!-- applies to RemoteOne and RemoteTwo -->
- <jndi name="{interfaceClass.simpleName}" interface="Remote"<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">>
+ <jndi name="{interfaceClass.simpleName}" interface="Remote"/>
<!-- applies to FooHome -->
- <jndi name="{interfaceClass.simpleName}" interface="RemoteHome"<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">>
+ <jndi name="{interfaceClass.simpleName}" interface="RemoteHome"/>
<!-- applies to FooLocalHome -->
- <jndi name="{interfaceClass.simpleName}" interface="LocalHome"<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">ejb-deployment>
-<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-jar>
+ <jndi name="{interfaceClass.simpleName}" interface="LocalHome"/>
+ </ejb-deployment>
+</openejb-jar>
</code></pre>
<p>Or</p>
@@ -399,13 +401,13 @@ are named.</p>
<pre><code><openejb-jar>
<ejb-deployment ejb-name="FooBean">
<!-- applies to RemoteOne, RemoteTwo, FooHome, and FooLocalHome -->
- <jndi name="{interfaceClass.simpleName}"<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">>
+ <jndi name="{interfaceClass.simpleName}"/>
<!-- these two would count as an override on the above format -->
- <jndi name="LocalOne" interface="org.superbiz.LocalOne"<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">>
- <jndi name="LocalTwo" interface="org.superbiz.LocalTwo"<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">ejb-deployment>
-<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-jar>
+ <jndi name="LocalOne" interface="org.superbiz.LocalOne"/>
+ <jndi name="LocalTwo" interface="org.superbiz.LocalTwo"/>
+ </ejb-deployment>
+</openejb-jar>
</code></pre>
<p>or</p>
@@ -413,80 +415,80 @@ are named.</p>
<pre><code><openejb-jar>
<ejb-deployment ejb-name="FooBean">
<!-- applies to LocalOne, LocalTwo, RemoteOne, RemoteTwo, FooHome, and FooLocalHome -->
- <jndi name="{interfaceClass.simpleName}"<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">>
- <<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">ejb-deployment>
-<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-jar>
+ <jndi name="{interfaceClass.simpleName}"/>
+ </ejb-deployment>
+</openejb-jar>
</code></pre>
-<p><a name="JNDINames-ChangingtheDefaultSetting"><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">a></p>
+<p><a name="JNDINames-ChangingtheDefaultSetting"></a></p>
<h1>Changing the Default Setting</h1>
<p><em>You are responsible for ensuring the names don't conflict.</em> </p>
-<p><a name="JNDINames-Conservativesettings"><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">a></p>
+<p><a name="JNDINames-Conservativesettings"></a></p>
<h3>Conservative settings</h3>
-<p>A very conservative setting such as "<em>{deploymentId}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{interfaceClass}</em>"
+<p>A very conservative setting such as "<em>{deploymentId}/{interfaceClass}</em>"
would guarantee that each and every single interface is bound to JNDI. If
your bean had a legacy EJBObject interface, three business remote
interfaces, and two business local interfaces, this pattern would result in
-<em>si<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0"></em> pro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ies bound into JNDI.</p>
+<em>six</em> proxies bound into JNDI.</p>
<p>Similarly conservative settings would be:
- - <em>{deploymentId}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{interfaceClass.simpleName}</em>
- - <em>{moduleId}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{ejbName}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{interfaceClass}</em>
- - <em>{ejbName}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{interfaceClass}</em>
- - <em>{moduleId}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{ejbClass}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{interfaceClass}</em>
- - <em>{ejbClass}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{interfaceClass}</em>
- - <em>{ejbClass}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{interfaceClass.simpleName}</em>
- - <em>{ejbClass.simpleName}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{interfaceClass.simpleName}</em>
- - <em>{interfaceClass}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{ejbName}</em></p>
+ - <em>{deploymentId}/{interfaceClass.simpleName}</em>
+ - <em>{moduleId}/{ejbName}/{interfaceClass}</em>
+ - <em>{ejbName}/{interfaceClass}</em>
+ - <em>{moduleId}/{ejbClass}/{interfaceClass}</em>
+ - <em>{ejbClass}/{interfaceClass}</em>
+ - <em>{ejbClass}/{interfaceClass.simpleName}</em>
+ - <em>{ejbClass.simpleName}/{interfaceClass.simpleName}</em>
+ - <em>{interfaceClass}/{ejbName}</em></p>
<p>Bordeline optimistic:
- - <em>{moduleId}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{interfaceClass}</em>
+ - <em>{moduleId}/{interfaceClass}</em>
- <em>{interfaceClass}</em></p>
<p>The above two settings would work if you the interface wasn't shared by
other beans.</p>
-<p><a name="JNDINames-Pragmaticsettings"><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">a></p>
+<p><a name="JNDINames-Pragmaticsettings"></a></p>
<h3>Pragmatic settings</h3>
<p>A more middle ground setting such as
"<em>{deploymentId}{interfaceType.annotationName}</em>" would guarantee that at
-least one pro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">y of each interface type is bound to JNDI. If your bean had
+least one proxy of each interface type is bound to JNDI. If your bean had
a legacy EJBObject interface, three business remote interfaces, and two
-business local interfaces, this pattern would result in <em>three</em> pro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ies
-bound into JNDI: one pro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">y dedicated to your EJBObject interface; one pro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">y
-implementing all three business remote interfaces; one pro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">y implementing
+business local interfaces, this pattern would result in <em>three</em> proxies
+bound into JNDI: one proxy dedicated to your EJBObject interface; one proxy
+implementing all three business remote interfaces; one proxy implementing
the two business local interfaces.</p>
<p>Similarly pragmatic settings would be:
- - <em>{moduleId}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{ejbClass}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{interfaceType.annotationName}</em>
- - <em>{ejbClass}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{interfaceType.<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">mlName}</em>
- - <em>{ejbClass.simpleName}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{interfaceType.<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">mlNameCc}</em>
- - <em>{interfaceType}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{ejbName}</em>
- - <em>{interfaceType}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{ejbClass}</em></p>
+ - <em>{moduleId}/{ejbClass}/{interfaceType.annotationName}</em>
+ - <em>{ejbClass}/{interfaceType.xmlName}</em>
+ - <em>{ejbClass.simpleName}/{interfaceType.xmlNameCc}</em>
+ - <em>{interfaceType}/{ejbName}</em>
+ - <em>{interfaceType}/{ejbClass}</em></p>
-<p><a name="JNDINames-Optimisticsettings"><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">a></p>
+<p><a name="JNDINames-Optimisticsettings"></a></p>
<h3>Optimistic settings</h3>
<p>A very optimistic setting such as "<em>{deploymentId}</em>" would guarantee only
-one pro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">y for the bean will be bound to JNDI. This would be fine if you
-knew you only had one type of interface in your beans. For e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ample, only
+one proxy for the bean will be bound to JNDI. This would be fine if you
+knew you only had one type of interface in your beans. For example, only
business remote interfaces, or only business local interfaces, or only an
EJBObject interface, or only an EJBLocalObject interface.</p>
<p>If a bean in the app did have more than one interface type, one business
-local and one business remote for e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ample, by default OpenEJB will reject
+local and one business remote for example, by default OpenEJB will reject
the app when it detects that it cannot bind the second interface. This
strict behavior can be disabled by setting the
<em>openejb.jndiname.failoncollision</em> system property to <em>false</em>. When this
-property is set to false, we will simply log an error that the second pro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">y
+property is set to false, we will simply log an error that the second proxy
cannot be bound to JNDI, tell you which ejb is using that name, and
continue loading your app.</p>
@@ -494,73 +496,73 @@ continue loading your app.</p>
- <em>{ejbName}</em>
- <em>{ejbClass}</em>
- <em>{ejbClass.simpleName}</em>
- - <em>{moduleId}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{ejbClass.simpleName}</em>
- - <em>{moduleId}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{ejbName}</em></p>
+ - <em>{moduleId}/{ejbClass.simpleName}</em>
+ - <em>{moduleId}/{ejbName}</em></p>
-<p><a name="JNDINames-AdvancedDetailsonEJB3.0BusinessPro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ies(thesimplepart)"><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">a></p>
+<p><a name="JNDINames-AdvancedDetailsonEJB3.0BusinessProxies(thesimplepart)"></a></p>
-<h1>Advanced Details on EJB 3.0 Business Pro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ies (the simple part)</h1>
+<h1>Advanced Details on EJB 3.0 Business Proxies (the simple part)</h1>
<p>If you implement your business interfaces, your life is simple as your
-pro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ies will also implement your business interfaces of the same type.
-Meaning any pro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">y OpenEJB creates for a business local interface will also
-implement your other business local interfaces. Similarly, any pro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">y
+proxies will also implement your business interfaces of the same type.
+Meaning any proxy OpenEJB creates for a business local interface will also
+implement your other business local interfaces. Similarly, any proxy
OpenEJB creates for a business remote interface will also implement your
other business remote interfaces.</p>
-<p><a name="JNDINames-AdvancedDetailsonEJB3.0BusinessPro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ies(thecomplicatedpart)"><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">a></p>
+<p><a name="JNDINames-AdvancedDetailsonEJB3.0BusinessProxies(thecomplicatedpart)"></a></p>
-<h1>Advanced Details on EJB 3.0 Business Pro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ies (the complicated part)</h1>
+<h1>Advanced Details on EJB 3.0 Business Proxies (the complicated part)</h1>
<p>{info:Who should read?}
Read this section of either of these two apply to you:
- You do not implement your business interfaces in your bean class
- - One or more of your business remote interfaces e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">tend from
-java<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">.rmi.Remote</p>
+ - One or more of your business remote interfaces extend from
+javax.rmi.Remote</p>
<p>If neither of these two items describe your apps, then there is no need to
read further. Go have fun.
{info}
-<a name="JNDINames-Notimplementingbusinessinterfaces"><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">a></p>
+<a name="JNDINames-Notimplementingbusinessinterfaces"></a></p>
<h3>Not implementing business interfaces</h3>
<p>If you do not implement your business interfaces it may not be possible for
us to implement all your business interfaces in a single interface.
Conflicts in the throws clauses and the return values can occur as detailed <a href="openejb:multiple-business-interface-hazzards.html">here</a>
-. When creating a pro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">y for an interface we will detect and remove any
+. When creating a proxy for an interface we will detect and remove any
other business interfaces that would conflict with the main interface.</p>
-<p><a name="JNDINames-Businessinterfacese<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">tendingjava<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">.rmi.Remote"><<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">a></p>
+<p><a name="JNDINames-Businessinterfacesextendingjavax.rmi.Remote"></a></p>
-<h3>Business interfaces e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">tending java<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">.rmi.Remote</h3>
+<h3>Business interfaces extending javax.rmi.Remote</h3>
-<p>Per spec rules many runtime e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ceptions (container or connection related)
-are thrown from java<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">.rmi.Remote pro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ies as java.rmi.RemoteE<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ception which
-is not a runtime e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ception and must be throwable via the pro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">y as a checked
-e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ception. The issue is that conflicting throws clauses are actually
-removed for two interfaces sharing the same method signature. For e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ample
+<p>Per spec rules many runtime exceptions (container or connection related)
+are thrown from javax.rmi.Remote proxies as java.rmi.RemoteException which
+is not a runtime exception and must be throwable via the proxy as a checked
+exception. The issue is that conflicting throws clauses are actually
+removed for two interfaces sharing the same method signature. For example
two methods such as these:
- InterfaceA: void doIt() throws Foo;
- - InterfaceB: void doIt() throws RemoteE<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ception;</p>
+ - InterfaceB: void doIt() throws RemoteException;</p>
<p>can be implemented by trimming out the conflicting throws clauses as
follows:
- Implementation: void doIt(){}</p>
<p>This is fine for a bean class as it does not need to throw the RMI required
-java<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">.rmi.RemoteE<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ception. However if we create a pro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">y from these two
+javax.rmi.RemoteException. However if we create a proxy from these two
interfaces it will also wind up with a 'doIt(){}' method that cannot throw
-java<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">.rmi.RemoteE<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ception. This is very bad as the container does need to
-throw RemoteE<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ception to any business interfaces e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">tending java.rmi.Remote
+javax.rmi.RemoteException. This is very bad as the container does need to
+throw RemoteException to any business interfaces extending java.rmi.Remote
for any container related issues or connection issues. If the container
-attempts to throw a RemoteE<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ception from the pro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ies 'doIt(){}' method, it
-will result in an UndeclaredThrowableE<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ception thrown by the VM.</p>
+attempts to throw a RemoteException from the proxies 'doIt(){}' method, it
+will result in an UndeclaredThrowableException thrown by the VM.</p>
-<p>The only way to guarantee the pro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">y has the 'doIt() throws RemoteE<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ception
-{}' method of InterfaceB is to cut out InterfaceA when we create the pro<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">y
+<p>The only way to guarantee the proxy has the 'doIt() throws RemoteException
+{}' method of InterfaceB is to cut out InterfaceA when we create the proxy
dedicated to InterfaceB.
-{e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">cerpt}</p>
+{excerpt}</p>
</DIV>
</P>