Author: dblevins
Date: Tue Jun 26 22:08:43 2012
New Revision: 1354261
URL: http://svn.apache.org/viewvc?rev=1354261&view=rev
Log:
clarification on properties based overriding
Modified:
openejb/site/trunk/content/changing-jms-implementations.mdtext
Modified: openejb/site/trunk/content/changing-jms-implementations.mdtext
URL:
http://svn.apache.org/viewvc/openejb/site/trunk/content/changing-jms-implementations.mdtext?rev=1354261&r1=1354260&r2=1354261&view=diff
==============================================================================
--- openejb/site/trunk/content/changing-jms-implementations.mdtext (original)
+++ openejb/site/trunk/content/changing-jms-implementations.mdtext Tue Jun 26
22:08:43 2012
@@ -102,6 +102,9 @@ Let's say that the following file lives
</ServiceProvider>
</ServiceJar>
+It is strongly recommended to not leave the values in the service-jar.xml file
blank as shown above. It is
+possible to setup several sets of defaults in a `service-jar.xml` or via
several `service-jar.xml` files.
+
Once this file is packed in a jar and added to the `<tomee.home>/lib` or
`<openejb.home>/lib` directory, you can
then declare and configure "instances" of these things in your `tomee.xml` or
`openejb.xml` config file as follows:
@@ -111,15 +114,20 @@ then declare and configure "instances" o
...
</Resource>
-This is basically the same to all configuration in TomEE/OpenEJB, but with the
addition that you must specify the
-`provider` attribute so the server knows where to look for the
`service-jar.xml` file that defines the resource and all its defaults.
-
-In this example the file is in `META-INF/org.superbiz/service-jar.xml`, so the
`provider` attribute should specify `org.superbiz`. You can use whatever
prefix you like for the `provider` id, though for obvious reasons we'd advise
not using `org.apache.openejb` or `org.apache.tomee` in the prefix.
-
+Or in properties like so:
+ myGenericAdapter = new://Resource?type=GenericJMSRA&provider=org.superbiz
+ myGenericAdapter.AdapterProperty1 = PropertyValue1
+ myGenericAdapter.AdapterProperty2 = PropertyValue2
+This is basically the same as all configuration in TomEE/OpenEJB, but with the
addition that you must
+specify the `provider` attribute so the server knows where to look for the
`service-jar.xml` file that
+defines the resource and all its defaults.
-http://osdir.com/ml/users.openejb.apache.org/2010-01/msg00086.html
+In this example:
+ - the file is `META-INF/org.superbiz/service-jar.xml`
+ - so the `provider` attribute is `org.superbiz`
+You can use whatever prefix you like for the `provider` id, though for obvious
reasons we'd advise not using `org.apache.openejb` or `org.apache.tomee` in the
prefix.
