Oracle8i Enterprise JavaBeans Developer's Guide and Reference Release 3 (8.1.7) Part Number A83725-01 |
|
Overview ======== This is the most basic program that you can create for the Orcale8i EJB server. One bean, HelloBean, is implemented. The bean and associated classes are loaded into the database, and the bean home interface is published as /test/myHello, as specified in the bean deployment descriptor hello.ejb. The bean contains a single method: helloWorld, which simply returns a String containing the JavaVM version number to the client that invokes it. This example shows the minimum number of files that you must provide to implement an EJB application: five. The five are: (1) the bean implementation: helloServer/HelloBean.java in this example (2) the bean remote interface: hello/Hello.java (3) the bean home interface: hello/HelloHome.java (4) the deployment descriptor: hello.ejb (5) a client app or applet: Client.java is the application in this example Source Files ============ Client.java ----------- You invoke the client program from a command prompt, and pass it four arguments, the - service URL (service ID, hostname, port, and SID if port is a listener) - name of the published bean to lookup and instantiate - username - password that authenticates the client to the Oracle8i database server For example: % java -classpath LIBs Client sess_iiop://localhost:2222 /test/myHello scott tiger where LIBs is the classpath that must include $ORACLE_HOME/lib/aurora_client.jar #If using Java 2, use classes12.zip instead of classes111.zip $ORACLE_HOME/jdbc/lib/classes111.zip $ORACLE_HOME/lib/vbjorb.jar $ORACLE_HOME/lib/vbjapp.jar $JAVA_HOME/lib/classes.zip (Note: for NT users, the environment variables would be %ORACLE_HOME% and %JAVA_HOME%.) The client code performs the following steps: - gets the arguments passed on the command line - creates a new JNDI Context (InitialContext()) - looks up the published bean to find and activate its home interface - using the home interface, instantiates through its create() method a new bean object, hello - invokes the helloWorld() method on the hello object and prints the results The printed output is: Hello client, your javavm version is 8.1.5. hello.ejb --------- The bean deployment descriptor. This source file does the following: - shows the class name of the bean implementation in the deployment name: helloServer.HelloBean - names the published bean "/test/myHello" - declares the remote interface implementation: hello.Hello - declares the home interface: hello.HelloHome - sets RunAsMode to the client's identity (SCOTT in this case) - allows all members of the group PUBLIC to run the bean - sets the transaction attribute to TX_SUPPORTS The deployement descriptor is read by the deployejb tool, which uses it to load the required classes, and publish the bean home interface. (Deployejb does much else also. See the Tools chapter in the Oracle8i EJB and CORBA Developer's Guide for more information.) helloServer/HelloBean.java -------------------------- This is the EJB implementation. Note that the bean class is public, and that it implements the SessionBean interface, as required by the EJB specification. The bean implements the one method specified in the remote interface: helloWorld(). This method gets the system property associated with "oracle.server.version" as a String, and returns a greeting plus the version number as a String to the invoking client. The bean implementation also implements ejbCreate() with no parameters, following the specification of the create() method in hello/HelloHome.java. Finally, the methods ejbRemove(), setSessionContext(), ejbActivate(), and ejbPassivate() are implemented as required by the SessionBean interface. In this simple case, the methods are implemented with null bodies. (Note that ejbActivate() and ejbPassivate() are never called in the 8.1.5 release of the EJB server, but they must be implemented as required by the interface.) hello/Hello.java ---------------- This is the bean remote interface. In this example, it specifies only one method: helloWorld(), which returns a String object. Note the two import statements, which are required, and that the helloWorld() method must be declared as throwing RemoteException. All bean methods must be capable of throwing this exception. If you omit the declaration, the deployejb tool will catch it and error when you try to deploy the bean. hello/HelloHome.java -------------------- This is the bean home interface. In this example, a single create() method is declared. It returns a Hello object, as you saw in the Client.java code. Note especially that the create() method must be declared as able to throw RemoteException and CreateException. These are required. If you do not declare these, the deployejb tool will catch it and error when you try to deploy the bean. Compiling and Running the Example ================================= UNIX ---- Enter the command 'make all' or simply 'make' in the shell to compile, load, and deploy the objects, and run the client program. Other targets are 'run' and 'clean'. Make sure that a shell environment variable ORACLE_HOME is set to point to the home location of the Oracle installation. This is operating system dependent, so see the Installation documentation that came with your system for the location. Also, review the README file for the Oracle database, and the README file for the CORBA/EJB server (the Oracle8i ORB), for additional up-to-date information. Windows NT ---------- On Windows NT, run the batch file makeit.bat from a DOS command prompt to compile, load, and deploy the objects. Run the batch file runit.bat to run the client program, and see the results. Make sure that the environment variables %ORACLE_HOME%, %CLASSPATH%, and %SERVICE% are set appropriately for the DOS command window. You can set these as either user or system environment variables from the Control Panel. Double click on System in the Control Panel then on the Environment tab to set these variables. Start a new DOS window after setting environment variable values. See the Installation documentation that came with your Oracle8i system for the values of these variables. Also, review the README file for the Oracle database, and the README file for the CORBA/EJB server (the Oracle8i ORB), for additional up-to-date information. You can also set an environment variable %JAVA_HOME% to point to the root of your Java JDK. For example, SET JAVA_HOME=C:\JDK1.1.6.
import hello.Hello; import hello.HelloHome; import oracle.aurora.jndi.sess_iiop.ServiceCtx; import javax.naming.Context; import javax.naming.InitialContext; import java.util.Hashtable; public class Client { public static void main (String[] args) throws Exception { if (args.length != 4) { System.out.println ("usage: Client serviceURL objectName user password"); System.exit (1); } String serviceURL = args [0]; String objectName = args [1]; String user = args [2]; String password = args [3]; Hashtable env = new Hashtable (); env.put (Context.URL_PKG_PREFIXES, "oracle.aurora.jndi"); env.put (Context.SECURITY_PRINCIPAL, user); env.put (Context.SECURITY_CREDENTIALS, password); env.put (Context.SECURITY_AUTHENTICATION, ServiceCtx.NON_SSL_LOGIN); Context ic = new InitialContext (env); HelloHome hello_home = (HelloHome)ic.lookup (serviceURL + objectName); Hello hello = hello_home.create (); System.out.println (hello.helloWorld ()); } }
package hello; import javax.ejb.EJBHome; import javax.ejb.CreateException; import java.rmi.RemoteException; public interface HelloHome extends EJBHome { public Hello create () throws RemoteException, CreateException; }
package hello; import javax.ejb.EJBObject; import java.rmi.RemoteException; public interface Hello extends EJBObject { public String helloWorld () throws RemoteException; }
package helloServer; import javax.ejb.SessionBean; import javax.ejb.CreateException; import javax.ejb.SessionContext; import java.rmi.RemoteException; public class HelloBean implements SessionBean { // Methods of the Hello interface public String helloWorld () throws RemoteException { String v = System.getProperty("oracle.server.version"); return "Hello client, your javavm version is " + v + "."; } // Methods of the SessionBean public void ejbCreate () throws RemoteException, CreateException {} public void ejbRemove() {} public void setSessionContext (SessionContext ctx) {} public void ejbActivate () {} public void ejbPassivate () {} }
|
Copyright © 1996-2000, Oracle Corporation. All Rights Reserved. |
|