![]() |
![]() |
![]() |
![]() |
![]() |
||||||||
![]() |
Home | Download | Lists | Issues |
![]() |
||||||||||
![]() |
![]() |
![]() |
![]() |
![]() |
||||||||
OverviewThis example shows how to use OpenEJB3's remoting capabilities in an embedded scenario. By remoting we mean that you wish to allow clients in other vms access your ejbs. Note, you do not need to go to this extreme to unit test ejbs with remote interfaces. The basic recipe is the same for a standard embedded scenario but with these added ingreditents:
While creating the InitialContext, pass in the openejb.embedded.remotable property with the value of "true". When this is seen by the LocalInitialContextFactory, it will boot up the Server ServiceManager in the VM which will in turn look for ServerServices in the classpath. Provided you have the openejb-ejbd jar in your classpath along with it's dependencies (openejb-server, openejb-client, openejb-core), then those services will be brought online and remote clients will be able to connect into your vm and invoke beans. If you want to add more ServerServices such as the http version of the ejbd protocol you'd simply add the openejb-httpejbd jar to your classpath. A number of ServerServices are available currently:
The source for this example is in the "telephone-stateful" directory located in the openejb-examples.zip available on the download page.
The CodeFor this example we have a simple Stateful bean called TelephoneBean as defined below. As a simple way of demonstrating the state we have to methods: speak and listen. You call speak and pass in some text, then you call listen to get your answer. beanpackage org.superbiz.telephone; import javax.ejb.Remote; import javax.ejb.Stateful; import java.util.ArrayList; import java.util.List; @Remote @Stateful public class TelephoneBean implements Telephone { private static final String[] answers = { "How nice.", "Oh, of course.", "Interesting.", "Really?", "No.", "Definitely.", "I wondered about that.", "Good idea.", "You don't say!", }; private List<String> conversation = new ArrayList<String>(); public void speak(String words) { conversation.add(words); } public String listen() { if (conversation.size() == 0) { return "Nothing has been said"; } String lastThingSaid = conversation.get(conversation.size() - 1); return answers[Math.abs(lastThingSaid.hashCode()) % answers.length]; } } business interfacepackage org.superbiz.telephone; public interface Telephone { void speak(String words); String listen(); }
EmbeddingWe're going to embed OpenEJB3 into a plain JUnit TestCase as a simple means of demonstrating the remote capabilities. We'll do the embedding in our test setUp method, then will make two test methods:
setUpprotected void setUp() throws Exception { Properties properties = new Properties(); properties.setProperty(Context.INITIAL_CONTEXT_FACTORY, "org.apache.openejb.client.LocalInitialContextFactory"); properties.setProperty("openejb.embedded.remotable", "true"); // Uncomment these properties to change the defaults //properties.setProperty("ejbd.port", "4202"); //properties.setProperty("ejbd.bind", "localhost"); //properties.setProperty("ejbd.threads", "200"); //properties.setProperty("ejbd.disabled", "false"); //properties.setProperty("ejbd.only_from", "127.0.0.1,192.168.1.1"); new InitialContext(properties); } LocalInitialContextFactory: making in-vm calls to a remote business interfacepublic void testTalkOverLocalNetwork() throws Exception { Properties properties = new Properties(); properties.setProperty(Context.INITIAL_CONTEXT_FACTORY, "org.apache.openejb.client.LocalInitialContextFactory"); InitialContext localContext = new InitialContext(properties); Telephone telephone = (Telephone) localContext.lookup("TelephoneBeanRemote"); telephone.speak("Did you know I am talking directly through the embedded container?"); assertEquals("Interesting.", telephone.listen()); telephone.speak("Yep, I'm using the bean's remote interface but since the ejb container is embedded " + "in the same vm I'm just using the LocalInitialContextFactory."); assertEquals("Really?", telephone.listen()); telephone.speak("Right, you really only have to use the RemoteInitialContextFactory if you're in a different vm."); assertEquals("Oh, of course.", telephone.listen()); } RemoteInitialContextFactory: making networked calls to a remote business interfaceThis is the part you would want to do in apps that are running a different VM than the one in which the ejb container is embedded. These "client" VMs need only have the the openejb-client jar in their classpath and connect to OpenEJB via the RemoteInitialContextFactory like any other remote EJB client. public void testTalkOverRemoteNetwork() throws Exception { Properties properties = new Properties(); properties.setProperty(Context.INITIAL_CONTEXT_FACTORY, "org.apache.openejb.client.RemoteInitialContextFactory"); properties.setProperty(Context.PROVIDER_URL, "ejbd://localhost:4201"); InitialContext remoteContext = new InitialContext(properties); Telephone telephone = (Telephone) remoteContext.lookup("TelephoneBeanRemote"); telephone.speak("Is this a local call?"); assertEquals("No.", telephone.listen()); telephone.speak("This would be a lot cooler if I was connecting from another VM then, huh?"); assertEquals("I wondered about that.", telephone.listen()); telephone.speak("I suppose I should hangup and call back over the LocalInitialContextFactory."); assertEquals("Good idea.", telephone.listen()); telephone.speak("I'll remember this though in case I ever have to call you accross a network."); assertEquals("Definitely.", telephone.listen()); } Maven setupNice thing about maven2 is it has test-only dependencies. This guarantees that non of your runtime code is dependent on any OpenEJB classes. You need this dep or no clients will be able to connect over the ejbd protocol to the embedded ejb container. Notice the other examples use 'openejb-core' and this one uses 'openejb-ejbd'. If you wanted to make more protocols available, you simply have to add deps to them and they'll get picked up in the classpath automatically. <dependency> <groupId>org.apache.openejb</groupId> <artifactId>openejb-ejbd</artifactId> <version>3.1-SNAPSHOT</version> <scope>test</scope> </dependency> RunningRunning the example is fairly simple. In the "telephone-stateful" directory of the examples zip, just run: $ mvn clean install Which should create output like the following. ------------------------------------------------------- T E S T S ------------------------------------------------------- Running org.superbiz.telephone.TelephoneTest Apache OpenEJB 3.0 build: 20080408-04:13 http://openejb.apache.org/ INFO - openejb.home = /Users/dblevins/work/openejb-3.0/examples/telephone-stateful INFO - openejb.base = /Users/dblevins/work/openejb-3.0/examples/telephone-stateful 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 - Configuring Service(id=Default JDK 1.3 ProxyFactory, type=ProxyFactory, provider-id=Default JDK 1.3 ProxyFactory) INFO - Found EjbModule in classpath: /Users/dblevins/work/openejb-3.0/examples/telephone-stateful/target/classes INFO - Configuring app: /Users/dblevins/work/openejb-3.0/examples/telephone-stateful/target/classes INFO - Configuring Service(id=Default Stateful Container, type=Container, provider-id=Default Stateful Container) INFO - Auto-creating a container for bean TelephoneBean: Container(type=STATEFUL, id=Default Stateful Container) INFO - Loaded Module: /Users/dblevins/work/openejb-3.0/examples/telephone-stateful/target/classes INFO - Assembling app: /Users/dblevins/work/openejb-3.0/examples/telephone-stateful/target/classes INFO - Jndi(name=TelephoneBeanRemote) --> Ejb(deployment-id=TelephoneBean) INFO - Created Ejb(deployment-id=TelephoneBean, ejb-name=TelephoneBean, container=Default Stateful Container) INFO - Deployed Application(path=/Users/dblevins/work/openejb-3.0/examples/telephone-stateful/target/classes) ** Starting Services ** NAME IP PORT ejbd 127.0.0.1 4201 admin thread 127.0.0.1 4200 ------- Ready! Tests run: 2, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.89 sec Results : Tests run: 2, Failures: 0, Errors: 0, Skipped: 0 |
![]() |
|||||||||||
|
![]() |