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 [48/49] - /websites/staging/openejb/trunk/content/
Modified: websites/staging/openejb/trunk/content/validation-tool.html
==============================================================================
--- websites/staging/openejb/trunk/content/validation-tool.html (original)
+++ websites/staging/openejb/trunk/content/validation-tool.html Tue Jul 12 18:06:32 2011
@@ -152,60 +152,60 @@
<P>
<!-- $BODY -->
<DIV id="PageContent">
- <p><a name="ValidationTool-NAME"><<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="ValidationTool-NAME"></a></p>
<h1>NAME</h1>
<p>openejb validate - OpenEJB Validation Tool</p>
-<p><a name="ValidationTool-SYNOPSIS"><<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="ValidationTool-SYNOPSIS"></a></p>
<h1>SYNOPSIS</h1>
<p>openejb validate <a href="options.html">options</a>
jarfiles</p>
-<p><a name="ValidationTool-NOTE"><<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="ValidationTool-NOTE"></a></p>
<h1>NOTE</h1>
-<p>The OpenEJB Validation tool must be e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ecuted from the OPENEJB_HOME
+<p>The OpenEJB Validation tool must be executed from the OPENEJB_HOME
directory. This is the directory where OpenEJB was installed or unpacked.
For for the remainder of this document we will assume you unpacked OpenEJB
into the directory C:\openejb.</p>
-<p>In Windows, the validation tool can be e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ecuted as follows:</p>
+<p>In Windows, the validation tool can be executed as follows:</p>
<p><em>C:\openejb> openejb validate -help</em></p>
<p>{warning}
There is a bug in the openejb.bat script of OpenEJB 0.9.0 that doesn't
-allow you to e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ecute the validate command as above. For that release,
-Windows users can e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ecute the following command:
+allow you to execute the validate command as above. For that release,
+Windows users can execute the following command:
<em>C:\openejb> bin\validate.bat -help</em></p>
<p>{warning}</p>
-<p>In UNIX, Linu<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">, or Mac OS X, the deploy tool can be e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ecuted as follows:</p>
+<p>In UNIX, Linux, or Mac OS X, the deploy tool can be executed as follows:</p>
<p>{{<a href="user@host-openejb.html">user@host openejb</a></p>
-<h1>.<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb.sh validate -help}}</h1>
+<h1>./openejb.sh validate -help}}</h1>
-<p>Depending on your OpenEJB version, you may need to change 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 bits to
-make the scripts e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ecutable. You can do this with the following command.</p>
+<p>Depending on your OpenEJB version, you may need to change execution bits to
+make the scripts executable. You can do this with the following command.</p>
<p>{{<a href="user@host-openejb.html">user@host openejb</a></p>
-<h1>chmod 755 openejb.sh bin<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">*.sh}}</h1>
+<h1>chmod 755 openejb.sh bin/*.sh}}</h1>
-<p>From here on out, it will be assumed that you know how to e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ecute the right
+<p>From here on out, it will be assumed that you know how to execute the right
openejb script for your operating system and commands will appear in
shorthand as show below.</p>
<p><em>openejb validate -help</em></p>
-<p><a name="ValidationTool-DESCRIPTION"><<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="ValidationTool-DESCRIPTION"></a></p>
<h1>DESCRIPTION</h1>
@@ -225,46 +225,46 @@ interface</p>
<p>More checks will be added in the future.</p>
-<p><a name="ValidationTool-OPTIONS"><<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="ValidationTool-OPTIONS"></a></p>
<h1>OPTIONS</h1>
-<p><table>
-<tr><td>-v<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">td><td>Sets the output level to 1. This will output just the minumum details
-on each failure.<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">td><<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><td>-vv<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">td><td>Default. Sets the output level to 2. Outputs one line summaries of
-each failure. This is the default output level.<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">td><<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><td>-vvv<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">td><td>Sets the output level to 3. Outputs verbose details on each failure,
-usually with details on how to correct the failures.<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">td><<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><td>-<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">td><td>Outputs information in well-formed XML.<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">td><<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><td>-nowarn<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">td><td>Suppresses warnings.<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">td><<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><td>-version<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">td><td>Print the version.<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">td><<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><td>-help<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">td><td>Print this help message.<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">td><<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><td>-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<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">td><td>Show 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 of how to use the options.<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">td><<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>
+<table>
+<tr><td>-v</td><td>Sets the output level to 1. This will output just the minumum details
+on each failure.</td></tr>
+<tr><td>-vv</td><td>Default. Sets the output level to 2. Outputs one line summaries of
+each failure. This is the default output level.</td></tr>
+<tr><td>-vvv</td><td>Sets the output level to 3. Outputs verbose details on each failure,
+usually with details on how to correct the failures.</td></tr>
+<tr><td>-xml</td><td>Outputs information in well-formed XML.</td></tr>
+<tr><td>-nowarn</td><td>Suppresses warnings.</td></tr>
+<tr><td>-version</td><td>Print the version.</td></tr>
+<tr><td>-help</td><td>Print this help message.</td></tr>
+<tr><td>-examples</td><td>Show examples of how to use the options.</td></tr>
+</table>
-<p><a name="ValidationTool-COMMONISSUES"><<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="ValidationTool-COMMONISSUES"></a></p>
<h1>COMMON ISSUES</h1>
-<p><a name="ValidationTool-MisslocatedclassorNoClassDefFoundError"><<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="ValidationTool-MisslocatedclassorNoClassDefFoundError"></a></p>
<h2>Misslocated class or NoClassDefFoundError</h2>
-<p>The short e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">planation is that the parent doesn't have all the classes it
+<p>The short explanation is that the parent doesn't have all the classes it
needs as some of them are only in the child classloader, where the parent
can't see them.</p>
-<p>This would occur, 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, if a class was loaded by the parent
+<p>This would occur, for example, if a class was loaded by the parent
classloader, but that class' superclass wasn't visible to the parent
classloader, perhaps because it is only in the child classloader.</p>
-<p>Here is a more concrete 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>
+<p>Here is a more concrete example:</p>
-<pre><code>public interface Person e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">tends EJBObject {
+<pre><code>public interface Person extends EJBObject {
}
-public interface Employee e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">tends Person {
+public interface Employee extends Person {
}
</code></pre>
@@ -276,7 +276,7 @@ jar and that jar was loaded into the sys
<p>When a new classloader is create for my ejb-jar at runtime and the system
attempts to load the Employee interface, the call goes right through that
classloader and down to the system classloader. The Employee interface is
-found, because it was accidentally added to that e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">tra jar in the system
+found, because it was accidentally added to that extra jar in the system
classpath. So now the system classloader goes looking for Employee's
superinterface, Person, where it immediatly blows up and throws a
NoClassDefFoundError: Person.</p>
Modified: websites/staging/openejb/trunk/content/webadmin.html
==============================================================================
--- websites/staging/openejb/trunk/content/webadmin.html (original)
+++ websites/staging/openejb/trunk/content/webadmin.html Tue Jul 12 18:06:32 2011
@@ -156,16 +156,16 @@
it lets you plug-in your own admin beans. Here are some screenshots:</p>
<ul>
-<li>[Main](http:<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.apache.org<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">images<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">webadmin-main.png)</li>
-<li>[EJB Details](http:<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.apache.org<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">images<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">webadmin-ejbdetails.png)</li>
-<li>[List Logs](http:<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.apache.org<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">images<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">webadmin-listlogs.png)</li>
-<li>[System Properties](http:<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.apache.org<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">images<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">webadmin-properties.png)</li>
-<li>[JNDI Viewer](http:<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.apache.org<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">images<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">webadmin-viewjndi.png)</li>
-<li>[EJB Viewer](http:<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.apache.org<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">images<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">webadmin-ejbviewer.png)</li>
-<li>[Object and EJB Invoker](http:<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.apache.org<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">images<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">webadmin-objectinvoker.png)</li>
+<li><a href="http://openejb.apache.org/images/webadmin-main.png">Main</a></li>
+<li><a href="http://openejb.apache.org/images/webadmin-ejbdetails.png">EJB Details</a></li>
+<li><a href="http://openejb.apache.org/images/webadmin-listlogs.png">List Logs</a></li>
+<li><a href="http://openejb.apache.org/images/webadmin-properties.png">System Properties</a></li>
+<li><a href="http://openejb.apache.org/images/webadmin-viewjndi.png">JNDI Viewer</a></li>
+<li><a href="http://openejb.apache.org/images/webadmin-ejbviewer.png">EJB Viewer</a></li>
+<li><a href="http://openejb.apache.org/images/webadmin-objectinvoker.png">Object and EJB Invoker</a></li>
</ul>
-<p><a name="Webadmin-EnablingtheWebadminin1.0beta1"><<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="Webadmin-EnablingtheWebadminin1.0beta1"></a></p>
<h2>Enabling the Webadmin in 1.0 beta 1</h2>
@@ -174,17 +174,17 @@ move into the openejb.home directory and
openejb-webadmin-main.jar from the <em>beans</em> directory into the <em>lib</em>
directory. Then start the server.</p>
-<pre><code>mingus:~<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">
-$ cd <IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">usr<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">local<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-1.0-beta1
+<pre><code>mingus:~/
+$ cd /usr/local/openejb-1.0-beta1
-mingus:<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">usr<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">local<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-1.0-beta1 03:37:33
-$ cp beans<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-webadmin-main.jar lib<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">
+mingus:/usr/local/openejb-1.0-beta1 03:37:33
+$ cp beans/openejb-webadmin-main.jar lib/
-mingus:<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">usr<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">local<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-1.0-beta1 03:37:52
-$ .<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
-OPENEJB_HOME = <IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">usr<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">local<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-1.0-beta1
+mingus:/usr/local/openejb-1.0-beta1 03:37:52
+$ ./bin/openejb start
+OPENEJB_HOME = /usr/local/openejb-1.0-beta1
OpenEJB 1.0-beta1 build: 20050829-2233
-http:<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">www.openejb.org
+http://www.openejb.org
resources 1
OpenEJB ready.
[init]
@@ -200,61 +200,61 @@ OpenEJB ready.
-------
Ready!</p>
-<p>Now you can open your browser to go to http:<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">localhost:4203<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0"></p>
+<p>Now you can open your browser to go to http://localhost:4203/</p>
-<p><a name="Webadmin-WebAdminBeans"><<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="Webadmin-WebAdminBeans"></a></p>
<h1>WebAdmin Beans</h1>
<p>To create an EJB and have it included as part of the WebAdmin, simply
-subclass from WebAdminBean and include it in your 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 file as such:</p>
+subclass from WebAdminBean and include it in your ejb-jar.xml file as such:</p>
<pre><code><session>
- <description>A JNDI viewer<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">description>
- <ejb-name>webadmin<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">ViewJndi<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">ejb-name>
- <home>org.openejb.webadmin.HttpHome<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">home>
- <remote>org.openejb.webadmin.HttpObject<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">remote>
- <ejb-class>org.openejb.webadmin.clienttools.ViewJndiBean<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">ejb-class>
- <session-type>Stateless<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">session-type>
- <transaction-type>Bean<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">transaction-type>
-<<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">session>
+ <description>A JNDI viewer</description>
+ <ejb-name>webadmin/ViewJndi</ejb-name>
+ <home>org.openejb.webadmin.HttpHome</home>
+ <remote>org.openejb.webadmin.HttpObject</remote>
+ <ejb-class>org.openejb.webadmin.clienttools.ViewJndiBean</ejb-class>
+ <session-type>Stateless</session-type>
+ <transaction-type>Bean</transaction-type>
+</session>
</code></pre>
<p>The ejb-name is used to create the menus and should follow the format of
-'menu-section<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">menu-item'. WebAdminBeans are grouped together by the
+'menu-section/menu-item'. WebAdminBeans are grouped together by the
'menu-section' portion of their ejb-name. The 'menu-item' is the clickable
-link that causes the EJB code to be e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ecute. Very simple and makes it
+link that causes the EJB code to be execute. Very simple and makes it
possible to package administrative components with your EJB applications.</p>
<h1>WebAdmin Plugins</h1>
-<p>Here is a project that already takes advantage of the new feature. [BeanGen|http:<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">beangen.sourceforge.net]</p>
+<p>Here is a project that already takes advantage of the new feature. [BeanGen|http://beangen.sourceforge.net]</p>
<h1>Developers guide</h1>
<p>Below is David Blevins' email on how webadmin worked. Please have a look at
-the te<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">t below before you start working on porting the e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">isting WebAdmin to
+the text below before you start working on porting the existing WebAdmin to
version 3.</p>
<p>Plain old stateless beans were used as the "servlets". To make a bean that
would show up in the Webadmin Console you simply had to implement the
HttpBean interface (i think it's now called HttpListener) and give your
-bean a deploymentId following this format "webadmin<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{section}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{page}".
+bean a deploymentId following this format "webadmin/{section}/{page}".
Anyone could add to the Webadmin console by doing both of these things,
which is really cool as people developing EJB apps can also deploy beans
-for administering those apps right in the e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">act same jar. This is not only
-easy for packaging but means new sections can be added<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">removed on the fly.</p>
+for administering those apps right in the exact same jar. This is not only
+easy for packaging but means new sections can be added/removed on the fly.</p>
-<p>Using the described "webadmin<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{section}<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">{page}" deploymentId format,
+<p>Using the described "webadmin/{section}/{page}" deploymentId format,
things end up automagically grouped in the JNDI tree. There's a 'webadmin'
-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 we grab which will contain any number of "section" conte<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ts
-("ClientTools", "EJBGenerator", etc.). Each of those section subconte<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ts
+context we grab which will contain any number of "section" contexts
+("ClientTools", "EJBGenerator", etc.). Each of those section subcontexts
will contain several beans which we will use to make the pages. Making the
menu is pretty easy as we just iterate over the webadmin section of the
global jndi tree.</p>
<p>When an http request came in we just took the path part of the GET or POST
-request, prepended "webadmin<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">" and then went looking for a bean with that
+request, prepended "webadmin/" and then went looking for a bean with that
deployment id and invoked it via it's HttpBean (now called HttpListener)
interface passing in a HttpRequest and HttpResponse objects which are
trimmed down versions of similar servlet classes.
@@ -265,7 +265,7 @@ the URL space. See the openejb-http mod
<p>To implement session state, we had a stateful session bean implementing an
HttpSession interface (again, similar to the servlet equivalent) and simply
wrote the internal ID of the bean instance into a Cookie sent to the
-browser. For some reason we would write the java<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">.ejb.Handle of the
+browser. For some reason we would write the javax.ejb.Handle of the
stateful bean's EJBObject to disk and
read it back out on subsequent requests then used it to get a reference to
the EJBObject again. I'm not sure why we didn't just keep a static hashmap
@@ -297,13 +297,13 @@ requesting the same images over and over
<li>The EJB Generator was written by Jeremy Whitlock</li>
<li>Everything else was written by Tim Urberg. Tim was "WebAdmin guy" for
a good long while. Before Tim came along the webadmin was just some
-e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">perimental code I had in a branch, he did more than he realizes by putting his energy
-into it -- active people attract<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0"> create more active people. Maybe we can
+experimental code I had in a branch, he did more than he realizes by putting his energy
+into it -- active people attract/ create more active people. Maybe we can
convince him to come back and work on it ;)</li>
</ul>
<p>And of course I have to mention our own Paulo Lopes who wrote a really cool
-project out in SF.net (http:<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">beangen.sourceforge.net<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">) which was the first
+project out in SF.net (http://beangen.sourceforge.net/) which was the first
plugin for the OpenEJB Webadmin. He wrote it before we even had shipped a
release containing the Webadmin or had any docs at all on it, which in my
mind shows just how neat the idea of using ejb's and simple conventions to
@@ -318,12 +318,12 @@ database connector and <em>everything</e
protocols). Someone new to the project can look at it and understand it
without having to read any abstract specs. Something to consider. The
tree is read only in it's function, however it is possible to copy then
-edit and make new containers, etc. based on e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">isting definitions.</p>
+edit and make new containers, etc. based on existing definitions.</p>
<p>Additionally, using this same data structure it's possible to show the
-potential services available via the service-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 files in the classpath
+potential services available via the service-jar.xml files in the classpath
that detail containers, resource adapters, database connectors, etc. which
-can be configured<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">created at runtime. So we could also display a sort of
+can be configured/created at runtime. So we could also display a sort of
catalogue of components (aka. services) that someone could click and deploy
via the console.</p>
Modified: websites/staging/openejb/trunk/content/writing-validation-tests.html
==============================================================================
--- websites/staging/openejb/trunk/content/writing-validation-tests.html (original)
+++ websites/staging/openejb/trunk/content/writing-validation-tests.html Tue Jul 12 18:06:32 2011
@@ -152,17 +152,17 @@
<P>
<!-- $BODY -->
<DIV id="PageContent">
- <p><a name="WritingValidationTests-Summary"><<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="WritingValidationTests-Summary"></a></p>
<h2>Summary</h2>
<p>Validation is a critical and integral part of the project. If you are
writing some code which validates some rules, you should definitely write a
test for it. A little validation test framework is available to write tests
-specifically for Validation. This page e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">plains the details of writing such
-tests using 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 snippets.</p>
+specifically for Validation. This page explains the details of writing such
+tests using example snippets.</p>
-<p><a name="WritingValidationTests-TheValidationFramework"><<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="WritingValidationTests-TheValidationFramework"></a></p>
<h2>The Validation Framework</h2>
@@ -174,44 +174,44 @@ implementations in the <em>chain</em> is
conditionally added to the <em>chain</em> if the property
<em>openejb.validation.skip=false</em>. If this property is false, then
<em>ValidateModules</em> is used to kick off the <em>Validation Framework</em>.
-{snippet:id=code|url=openejb3<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">container<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-core<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">src<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">main<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">java<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" bor
der="0">org<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">apache<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">config<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">ConfigurationFactory.java|lang=java}</li>
+{snippet:id=code|url=openejb3/container/openejb-core/src/main/java/org/apache/openejb/config/ConfigurationFactory.java|lang=java}</li>
<li>Internally ValidateModules uses the <em>AppValidator.validate()</em> method.
-{snippet:id=code|url=openejb3<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">container<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-core<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">src<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">main<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">java<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" bor
der="0">org<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">apache<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">config<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">ValidateModules.java|lang=java}</li>
+{snippet:id=code|url=openejb3/container/openejb-core/src/main/java/org/apache/openejb/config/ValidateModules.java|lang=java}</li>
<li>This method then performs validation using a number of rules. <em>A
-validation rule<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">s is represented by a class implementing ValidationRule</em>.
-In fact, all the classes checking the validation rules , 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
+validation rule/s is represented by a class implementing ValidationRule</em>.
+In fact, all the classes checking the validation rules , extend
ValidationBase, which further implements ValidationRule.
{gliffy:name=Class Diagram|align=left|size=L|version=2}
-The <em>list of rules</em> being e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ecuted can actually be found in the following
+The <em>list of rules</em> being executed can actually be found in the following
method of AppValidator.
-{snippet:id=code1|url=openejb3<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">container<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-core<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">src<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">main<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">java<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" bo
rder="0">org<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">apache<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">config<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">AppValidator.java|lang=java}</li>
-<li>The above rules are then e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ecuted one by one
-{snippet:id=code2|url=openejb3<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">container<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-core<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">src<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">main<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">java<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" bo
rder="0">org<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">apache<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">config<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">AppValidator.java|lang=java}</li>
-<li><p>Each module has an attached ValidationConte<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">t , which maintains a list of
+{snippet:id=code1|url=openejb3/container/openejb-core/src/main/java/org/apache/openejb/config/AppValidator.java|lang=java}</li>
+<li>The above rules are then executed one by one
+{snippet:id=code2|url=openejb3/container/openejb-core/src/main/java/org/apache/openejb/config/AppValidator.java|lang=java}</li>
+<li><p>Each module has an attached ValidationContext , which maintains a list of
failures, warnings and errors. As the above rules are being invoked, the
-failure<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">errors<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">warnings for a module are being added to its
-ValidationConte<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">t. Every Validation failure has an associated message which
-can be found in <em>org<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">apache<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">config<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">rules<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">messages.properties</em>. A
-message has three levels as e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">plained below:</p>
+failure/errors/warnings for a module are being added to its
+ValidationContext. Every Validation failure has an associated message which
+can be found in <em>org/apache/openejb/config/rules/messages.properties</em>. A
+message has three levels as explained below:</p>
<p>Format for the different levels follows this spirit:</p>
<ol>
-<li><p>Should be short and fi<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ed such that someone could search<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">grep for it
-without having to know<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">use regular e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">pressions. These tend to be similar
+<li><p>Should be short and fixed such that someone could search/grep for it
+without having to know/use regular expressions. These tend to be similar
to the message key.</p></li>
-<li><p>Intended to contain the issue e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">pressed in 1 with only the essential
+<li><p>Intended to contain the issue expressed in 1 with only the essential
details, should not line wrap if possible. Be terse.</p></li>
<li><p>Teacher's assistant. A much more conversational and possibly more
detailed
-e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">planation of the issue, should tell the user what to do to fi<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0"> the
+explanation of the issue, should tell the user what to do to fix the
problem.
I.e. don't just point out what is wrong, also point out what is right. Use
several lines if needed.</p></li>
</ol></li>
</ol>
-<p>Here is an <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">ample validation message</em></p>
+<p>Here is an <em>example validation message</em></p>
<pre><code># 0 - method name
# 1 - full method
@@ -229,11 +229,11 @@ several lines if needed.</p></li>
<ol>
<li>The validation framework does not stop processing on the first validation
failure, but keeps going and checking for other validation errors and
-reports them all to the user. This allows the user to fi<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0"> all errors in one
+reports them all to the user. This allows the user to fix all errors in one
go and re-attempt deploying the application.</li>
</ol>
-<p><a name="WritingValidationTests-TheValidationTestFramework"><<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="WritingValidationTests-TheValidationTestFramework"></a></p>
<h2>The Validation Test Framework</h2>
@@ -245,35 +245,35 @@ the boiler-plate work, the test author j
info</li>
<li># It should report the test coverage i.e. the framework should
generate a report regarding which keys in messages.properties have tests
-written for them and what is the corresponding Test class<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">es which test for
+written for them and what is the corresponding Test class/es which test for
the validation rule associated with that key</li>
<li># It should ensure that if a test is being written for a specific
-message key, then that key should e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ist in the messages.properties file</li>
-<li>Lets break down the framework by using an 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:
-{snippet:id=code|url=openejb3<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">container<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb-core<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">src<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">test<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">java<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" bor
der="0">org<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">apache<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">openejb<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">config<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">rules<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">CheckInjectionTargetsTest.java|lang=java}</li>
+message key, then that key should exist in the messages.properties file</li>
+<li>Lets break down the framework by using an example:
+{snippet:id=code|url=openejb3/container/openejb-core/src/test/java/org/apache/openejb/config/rules/CheckInjectionTargetsTest.java|lang=java}</li>
<li># The first thing to note is that we are running the test using our
own custom runner i.e. @RunWith(ValidationRunner.class). This runner
-ensures that the keys we are testing, actually e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ist in the
+ensures that the keys we are testing, actually exist in the
messages.properties file. It does a lot more, as we shall see later</li>
<li># The test method</li>
<li>## Can be given any name</li>
<li>## Must be annotated with @Keys and CANNOT be annotated with @Test.
The rest of the JUnit annotations can be used</li>
-<li>## Must return one of EjbJar <IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0"> EjbModule <IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0"> AppModule. The returned
-EjbJar<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">EjbModule<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">AppModule will be specifically created to cause one or
-more validation errors<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">warnings<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">failures.</li>
+<li>## Must return one of EjbJar / EjbModule / AppModule. The returned
+EjbJar/EjbModule/AppModule will be specifically created to cause one or
+more validation errors/warnings/failures.</li>
<li># Following annotations are provided by the framework</li>
<li>## @Keys : is a collection of zero or more @Key</li>
<li><h2>@Key : represents a key for which this test is being written. A @Key</h2>
<p>can be of type FAILURE or WARNING or ERROR. Default value is FAILURE. As
-seen in the 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 above, the test() method is e<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">pecting two warnings for
+seen in the example above, the test() method is expecting two warnings for
the key injectionTarget.nameContainsSet. If count is not equal to 2 or some
-other Validation Failure<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">Warning<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" height="16" width="16" align="absmiddle" alt="" border="0">Error was also thrown from the method,
+other Validation Failure/Warning/Error was also thrown from the method,
then the test fails.
{note:title=Be Careful}
The test must cause a Validation Failure otherwise the test framework does
-not get invoked. 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, in the above code, a Key of type WARNING is
+not get invoked. For example, in the above code, a Key of type WARNING is
being tested, however the test is purposely being failed by putting an
@AroundInvoke around the method with zero arguments
{note}</p></li>
@@ -308,18 +308,18 @@ return it from the method. It should lis
1. The runner will invoke the test method and use the Assembler and
ConfigurationFactory to create the application
1. This will kick off validation and this Runner will catch
-ValidationFailureE<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 make sure that all the keys specified in the
+ValidationFailureException and make sure that all the keys specified in the
@Keys annotation show up
-in the ValidationFailureE<IMG class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/error.gif" height="16" width="16" align="absmiddle" alt="" border="0">ception
+in the ValidationFailureException
1. If the keys listed in the @Keys annotation match the keys found in the
-ValidationFailureE<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 test passes, else the test fails.
+ValidationFailureException, the test passes, else the test fails.
1. This Runner also validates that the keys specified in the @Keys
annotation are also available in the
org.apache.openejb.config.rules.Messages.properties file. If the key is not
-found, then the Runner throws and 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 resulting in your test case not
+found, then the Runner throws and exception resulting in your test case not
being allowed to run.
1. Sometimes you want to write a test where you do not want any
-ValidationFailureE<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 be thrown, in those scenarios, simply
+ValidationFailureException to be thrown, in those scenarios, simply
annotate your test with @Keys and do not specify any @Key in it
{info}</p>