You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tomee.apache.org by jg...@apache.org on 2015/04/16 12:45:57 UTC
[1/2] tomee git commit: Remove table
Repository: tomee
Updated Branches:
refs/heads/master 9a5920e1b -> e76456cab
Remove table
Project: http://git-wip-us.apache.org/repos/asf/tomee/repo
Commit: http://git-wip-us.apache.org/repos/asf/tomee/commit/f72c89a1
Tree: http://git-wip-us.apache.org/repos/asf/tomee/tree/f72c89a1
Diff: http://git-wip-us.apache.org/repos/asf/tomee/diff/f72c89a1
Branch: refs/heads/master
Commit: f72c89a123ec6650f3f992cd58bb6ae7e46b09d8
Parents: 9a5920e
Author: Jonathan Gallimore <jo...@jrg.me.uk>
Authored: Wed Apr 15 22:39:10 2015 +0100
Committer: Jonathan Gallimore <jo...@jrg.me.uk>
Committed: Thu Apr 16 11:05:17 2015 +0100
----------------------------------------------------------------------
examples/resources-jmx-example/README.md | 18 +++++++++++++-----
1 file changed, 13 insertions(+), 5 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/tomee/blob/f72c89a1/examples/resources-jmx-example/README.md
----------------------------------------------------------------------
diff --git a/examples/resources-jmx-example/README.md b/examples/resources-jmx-example/README.md
index 9a76cd2..595d331 100644
--- a/examples/resources-jmx-example/README.md
+++ b/examples/resources-jmx-example/README.md
@@ -241,11 +241,19 @@ Resources are typically discovered, created, and bound to JNDI very early on in
The following properties can be used to change this behavior.
-| Property | Values | Description |
-| -------------------------- | ---------------- | ----------- |
-| Lazy | true/false | Creates a proxy that defers the actual instantiation of the resource until the first time it is looked up from JNDI. |
-| UseAppClassLoader | true/false | Forces a lazily instantiated resource to use the application classloader, instead of the classloader available when the resources were first processed. |
-| InitializeAfterDeployment | true/false | Forces a resource created with the Lazy property to be instantiated once the application has started, as opposed to waiting for it to be looked up. |
+* Lazy
+
+This is a boolean value, which when true, creates a proxy that defers the actual instantiation of the resource until the first time it is looked up from JNDI. This can be useful if the resource's classpath until the application is started (see below), or to improve startup time by not fully initializing resources that might not be used.
+
+* UseAppClassLoader
+
+This boolean value forces a lazily instantiated resource to use the application classloader, instead of the classloader available when the resources were first processed.
+
+* InitializeAfterDeployment
+
+This boolean setting forces a resource created with the Lazy property to be instantiated once the application has started, as opposed to waiting for it to be looked up. Use this flag if you require the resource to be loaded, irrespective of whether it is injected into a managed component or manually looked up.
+
+By default, all of these settings are `false`, unless TomEE encounters a custom application resource that cannot be instantiated until the application has started. In this case, it will set these three flags to `true`, unless the `Lazy` flag has been explicitly set.
By default, if TomEE encounters a custom application resource that cannot be instantiated until the application has started, it will set these three flags to `true`, unless the `Lazy` flag has been explicitly set.
[2/2] tomee git commit: Grammar corrections
Posted by jg...@apache.org.
Grammar corrections
Project: http://git-wip-us.apache.org/repos/asf/tomee/repo
Commit: http://git-wip-us.apache.org/repos/asf/tomee/commit/e76456ca
Tree: http://git-wip-us.apache.org/repos/asf/tomee/tree/e76456ca
Diff: http://git-wip-us.apache.org/repos/asf/tomee/diff/e76456ca
Branch: refs/heads/master
Commit: e76456cabf14d4d4a943c5dd0e5791fdd3a9192c
Parents: f72c89a
Author: Jonathan Gallimore <jo...@jrg.me.uk>
Authored: Thu Apr 16 00:02:44 2015 +0100
Committer: Jonathan Gallimore <jo...@jrg.me.uk>
Committed: Thu Apr 16 11:05:28 2015 +0100
----------------------------------------------------------------------
examples/resources-jmx-example/README.md | 6 ++----
1 file changed, 2 insertions(+), 4 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/tomee/blob/e76456ca/examples/resources-jmx-example/README.md
----------------------------------------------------------------------
diff --git a/examples/resources-jmx-example/README.md b/examples/resources-jmx-example/README.md
index 595d331..b49678b 100644
--- a/examples/resources-jmx-example/README.md
+++ b/examples/resources-jmx-example/README.md
@@ -6,7 +6,7 @@ In addition to this, you can also define a `create` method on either the resourc
## Resource
-Custom resource can be defined using very simple Java classes. In this particular instance, as the application also wants to register this resource as an MBean, the resource class needs to follow the MBean specification.
+Custom resources can be defined using very simple Java classes. In this particular instance, as the application also wants to register this resource as an MBean, the resource class needs to follow the MBean specification.
public class Hello implements HelloMBean {
@@ -243,7 +243,7 @@ The following properties can be used to change this behavior.
* Lazy
-This is a boolean value, which when true, creates a proxy that defers the actual instantiation of the resource until the first time it is looked up from JNDI. This can be useful if the resource's classpath until the application is started (see below), or to improve startup time by not fully initializing resources that might not be used.
+This is a boolean value, which when true, creates a proxy that defers the actual instantiation of the resource until the first time it is looked up from JNDI. This can be useful if the resource requires the application classpath, or to improve startup time by not fully initializing resources that might not be used.
* UseAppClassLoader
@@ -255,8 +255,6 @@ This boolean setting forces a resource created with the Lazy property to be inst
By default, all of these settings are `false`, unless TomEE encounters a custom application resource that cannot be instantiated until the application has started. In this case, it will set these three flags to `true`, unless the `Lazy` flag has been explicitly set.
-By default, if TomEE encounters a custom application resource that cannot be instantiated until the application has started, it will set these three flags to `true`, unless the `Lazy` flag has been explicitly set.
-
# PostConstruct / PreDestroy
As an alternative to using a factory method, you can use @PostConstruct and @PreDestroy methods within your resource class (note that you cannot use this within a factory class) to manage any additional creation or cleanup activities. TomEE will automatically call these methods when the application is started and destroyed. Using @PostConstruct will effectively force a lazily loaded resource to be instantiated when the application is starting - in the same way that the `InitializeAfterDeployment` property does.