Author: dblevins
Date: Fri May 27 21:49:19 2011
New Revision: 1128476
URL: http://svn.apache.org/viewvc?rev=1128476&view=rev
Log:
Experimenting with markdown use. Should show up on the github mirror formatted
Added:
openejb/trunk/openejb3/examples/simple-stateless/README.md (contents,
props changed)
- copied, changed from r1124536,
openejb/trunk/openejb3/examples/simple-stateless/README.txt
Removed:
openejb/trunk/openejb3/examples/simple-stateless/README.txt
Copied: openejb/trunk/openejb3/examples/simple-stateless/README.md (from
r1124536, openejb/trunk/openejb3/examples/simple-stateless/README.txt)
URL:
http://svn.apache.org/viewvc/openejb/trunk/openejb3/examples/simple-stateless/README.md?p2=openejb/trunk/openejb3/examples/simple-stateless/README.md&p1=openejb/trunk/openejb3/examples/simple-stateless/README.txt&r1=1124536&r2=1128476&rev=1128476&view=diff
==============================================================================
--- openejb/trunk/openejb3/examples/simple-stateless/README.txt (original)
+++ openejb/trunk/openejb3/examples/simple-stateless/README.md Fri May 27
21:49:19 2011
@@ -1,18 +1,111 @@
-This example shows how to create a session stateless EJB using annotations.
+# Simple @Stateless bean
-As stated in the "JSR 220: Enterprise JavaBeansTM,Version 3.0 - EJB Core
Contracts and Requirements",
+This example shows how to create a Stateless session EJB using annotations. As
stated in the
+"JSR 220: Enterprise JavaBeansTM,Version 3.0 - EJB Core Contracts and
Requirements",
-"Stateless session beans are session beans whose instances have no
conversational state. This means that
-all bean instances are equivalent when they are not involved in servicing a
client-invoked method.
-The term 'stateless' signifies that an instance has no state for a specific
client."
-
-With EJB 3.0, it's now possible to write stateless session bean without
specifying a deployment descriptor; you basically have to write just
-
- * a remote or local business interface, which is a plain-old-java-interface,
annotated with the @Remote or @Local annotation
- * the stateless session bean implementation, a plain-old-java-object which
implements the remote or the local business interface and is annotated with the
@Stateless annotation
-
-To run the example simply type:
-
- $ mvn clean install
+>"Stateless session beans are session beans whose instances have no
conversational state.
+This means that all bean instances are equivalent when they are not involved
in servicing
+a client-invoked method. The term 'stateless' signifies that an instance has
no state for a
+specific client."
+
+What this means is quite simply that stateless beans are shared. They do in
fact have state
+as you can assign values to the variables, etc. in the bean instance. The only
catch is there
+are a pool of identical instances and you are not guaranteed to get the exact
same instance on
+every call. For each call, you get whatever instance happens to be available.
This is identical
+to checking out a book from the library or renting a movie from the video
store. You are essentially
+checking out or renting a new bean instance on each method call.
+
+# The code
+
+ @Stateless
+ public class CalculatorBean {
+
+ public int add(int a, int b) {
+ return a + b;
+ }
+
+ public int subtract(int a, int b) {
+ return a - b;
+ }
+
+ public int multiply(int a, int b) {
+ return a * b;
+ }
+
+ public int divide(int a, int b) {
+ return a / b;
+ }
+
+ public int remainder(int a, int b) {
+ return a % b;
+ }
+
+ }
+
+
+# Testing
+
+Our `CalculatorBean` can be easily tested using the `EJBContainer` API in EJB
3.1
+
+ public class CalculatorTest extends TestCase {
+
+ private CalculatorBean calculator;
+
+ /**
+ * Bootstrap the Embedded EJB Container
+ *
+ * @throws Exception
+ */
+ protected void setUp() throws Exception {
+
+ EJBContainer ejbContainer = EJBContainer.createEJBContainer();
+
+ Object object =
ejbContainer.getContext().lookup("java:global/simple-stateless/CalculatorBean");
+
+ assertTrue(object instanceof CalculatorBean);
+
+ calculator = (CalculatorBean) object;
+ }
+
+# Running
+
+Running the example should generate output similar to the following
+
+ -------------------------------------------------------
+ T E S T S
+ -------------------------------------------------------
+ Running org.superbiz.stateless.basic.CalculatorTest
+ Apache OpenEJB 4.0.0-SNAPSHOT build: 20110523-12:19
+ http://openejb.apache.org/
+ INFO - openejb.home =
/Users/dblevins/work/uber/openejb/examples/simple-stateless
+ INFO - openejb.base =
/Users/dblevins/work/uber/openejb/examples/simple-stateless
+ INFO - Using 'javax.ejb.embeddable.EJBContainer=true'
+ INFO - Configuring Service(id=Default Security Service,
type=SecurityService, provider-id=Default Security Service)
+ INFO - Configuring Service(id=Default Transaction Manager,
type=TransactionManager, provider-id=Default Transaction Manager)
+ INFO - Found EjbModule in classpath:
/Users/dblevins/work/uber/openejb/examples/simple-stateless/target/classes
+ INFO - Beginning load:
/Users/dblevins/work/uber/openejb/examples/simple-stateless/target/classes
+ INFO - Configuring enterprise application:
/Users/dblevins/work/uber/openejb/examples/simple-stateless
+ INFO - Configuring Service(id=Default Stateless Container, type=Container,
provider-id=Default Stateless Container)
+ INFO - Auto-creating a container for bean CalculatorBean:
Container(type=STATELESS, id=Default Stateless Container)
+ INFO - Configuring Service(id=Default Managed Container, type=Container,
provider-id=Default Managed Container)
+ INFO - Auto-creating a container for bean
org.superbiz.stateless.basic.CalculatorTest: Container(type=MANAGED, id=Default
Managed Container)
+ INFO - Enterprise application
"/Users/dblevins/work/uber/openejb/examples/simple-stateless" loaded.
+ INFO - Assembling app:
/Users/dblevins/work/uber/openejb/examples/simple-stateless
+ INFO -
Jndi(name="java:global/simple-stateless/CalculatorBean!org.superbiz.stateless.basic.CalculatorBean")
+ INFO - Jndi(name="java:global/simple-stateless/CalculatorBean")
+ INFO -
Jndi(name="java:global/EjbModule1670109169/org.superbiz.stateless.basic.CalculatorTest!org.superbiz.stateless.basic.CalculatorTest")
+ INFO -
Jndi(name="java:global/EjbModule1670109169/org.superbiz.stateless.basic.CalculatorTest")
+ INFO - Created Ejb(deployment-id=CalculatorBean, ejb-name=CalculatorBean,
container=Default Stateless Container)
+ INFO - Created
Ejb(deployment-id=org.superbiz.stateless.basic.CalculatorTest,
ejb-name=org.superbiz.stateless.basic.CalculatorTest, container=Default Managed
Container)
+ INFO - Started Ejb(deployment-id=CalculatorBean, ejb-name=CalculatorBean,
container=Default Stateless Container)
+ INFO - Started
Ejb(deployment-id=org.superbiz.stateless.basic.CalculatorTest,
ejb-name=org.superbiz.stateless.basic.CalculatorTest, container=Default Managed
Container)
+ INFO - Deployed
Application(path=/Users/dblevins/work/uber/openejb/examples/simple-stateless)
+ INFO - EJBContainer already initialized. Call ejbContainer.close() to
allow reinitialization
+ INFO - EJBContainer already initialized. Call ejbContainer.close() to
allow reinitialization
+ INFO - EJBContainer already initialized. Call ejbContainer.close() to
allow reinitialization
+ INFO - EJBContainer already initialized. Call ejbContainer.close() to
allow reinitialization
+ Tests run: 5, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 2.197 sec
+ Results :
+ Tests run: 5, Failures: 0, Errors: 0, Skipped: 0
Propchange: openejb/trunk/openejb3/examples/simple-stateless/README.md
------------------------------------------------------------------------------
svn:keywords = Date Rev Author Id Revision HeadURL
