You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tomee.apache.org by an...@apache.org on 2013/06/04 10:32:18 UTC
svn commit: r1489333 -
/tomee/site/trunk/content/application-discovery-via-the-classpath.mdtext
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