tomee-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From andygumbre...@apache.org
Subject svn commit: r1489333 - /tomee/site/trunk/content/application-discovery-via-the-classpath.mdtext
Date Tue, 04 Jun 2013 08:32:18 GMT
Author: andygumbrecht
Date: Tue Jun  4 08:32:18 2013
New Revision: 1489333

URL: http://svn.apache.org/r1489333
Log:
Document 'openejb.exclude-include.order'

Modified:
    tomee/site/trunk/content/application-discovery-via-the-classpath.mdtext

Modified: tomee/site/trunk/content/application-discovery-via-the-classpath.mdtext
URL: http://svn.apache.org/viewvc/tomee/site/trunk/content/application-discovery-via-the-classpath.mdtext?rev=1489333&r1=1489332&r2=1489333&view=diff
==============================================================================
--- tomee/site/trunk/content/application-discovery-via-the-classpath.mdtext (original)
+++ tomee/site/trunk/content/application-discovery-via-the-classpath.mdtext Tue Jun  4 08:32:18
2013
@@ -1,6 +1,6 @@
 Title: Application discovery via the classpath
-This document details the various ways to get OpenEJB to pickup
-applications you'd like deployed while in an embedded mode.
+This document details the various ways to get OpenEJB to detect
+applications you would like deployed while in an embedded mode.
 
 <a name="Applicationdiscoveryviatheclasspath-Emptyejb-jar.xmlapproach(recommended)"></a>
 # Empty ejb-jar.xml approach (recommended)
@@ -44,32 +44,38 @@ the class files of an application you wi
 of the following values to the "openejb.deployments.classpath.include"
 property:
     
-* "file:///Users/dblevins/work/swizzle/swizzle-stream/target/classes/" _(an absolute path)
+* "file:///Users/dblevins/work/swizzle/swizzle-stream/target/classes/" _(an absolute path)_
 * "file:///Users/dblevins/work/swizzle/.*" _(relative)_
 * ".\*swizzle-stream.\*" _(very relative)_
 * ".\*(swizzle-stream|swizzle-jira|acme-rocket-app).\*" _(including several paths)_
+* ".\*(swizzle-stream^|swizzle-jira^|acme-rocket-app).\*" _(including several paths with
Win specific escapes)_
     
 Note the filtering is done on URLs in the classpath, so forward slashes
 should always be used even on OSs using backslash ("\").
     
-There is an *openejb.deployments.classpath.exclude* property if you wish to
-work in the opposite direction.  The default values for both properties are
-as follows:
+There are also the *openejb.deployments.classpath.exclude* and *openejb.exclude-include.order*
+properties if you wish to work in the opposite direction or change the processing order.
+The default values for the properties are as follows:
+    
+      openejb.exclude-include.order=include-exclude //Defines the processing order
+	   openejb.deployments.classpath.include=""      //Include nothing
+       openejb.deployments.classpath.exclude=".*"    //Exclude everything
     
-      openejb.deployments.classpath.include=""  //include nothing
-      openejb.deployments.classpath.exclude=".*"  //exclude everything
-    
-The exclude and the include is applied separately and the results of each
+The exclude and the include are applied separately and the results of each
 are combined together to create the list of paths OpenEJB will scrape for
 annotations.
     
-    *Note* by default these settings will only affect which jars OpenEJB will
-scan for annotated components when no descriptor is found.  If you would
-like to use these settings to also filter out jars that do contain
-descriptors, set the *openejb.deployments.classpath.filter.descriptors*
-property to _true_.  The default is _false_.
+    *Note:* by default these settings will only affect which jars OpenEJB will
+	 scan for annotated components when no descriptor is found.  If you would
+	 like to use these settings to also filter out jars that do contain
+	 descriptors, set the *openejb.deployments.classpath.filter.descriptors*
+	 property to _true_.  The default is _false_.
     
 # Troubleshooting
+
+If the include/exclude is not being processed as you expect first try
+reversing the order to *openejb.exclude-include.order*=exclude-include
+There are a number internal filters that may result in an unexpected exclusion.
     
 If you're having trouble determining if the META-INF/ejb-jar.xml file for
 your ejb module is in the classpath, a little debug code like this in your



Mime
View raw message