org.jboss.iiop: public class: CorbaORB

org.jboss.iiop
public class: CorbaORB [javadoc | source]

java.lang.Object
   org.jboss.iiop.CorbaORB

Singleton class to ensure that all code running in the JBoss VM uses the same ORB instance. The CorbaORBService MBean calls CorbaORB.setInstance() at service creation time, after it creates an ORB instance. Code that runs both in the server VM and in client VM calls CorbaORB.getInstance() to get an ORB.

author: < - a href="mailto:reverbel@ime.usp.br">Francisco Reverbel

version: $ - Revision: 67381 $

Method from org.jboss.iiop.CorbaORB Summary:
getInstance, setInstance

Methods from java.lang.Object:
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from org.jboss.iiop.CorbaORB Detail:
public static ORB getInstance() { // No instance established, we must be on the client // Use the orb consistent with java:comp/ORB (if any). if (instance == null) { try { InitialContext ctx = new InitialContext(); instance = (ORB) ctx.lookup("java:comp/ORB"); } catch (Exception ignored) { } if (instance == null) instance = ORBFactory.getORB(); } return instance; } This method is called by classes that are used both at the server and at the client side: the handle impl (org.jboss.proxy.ejb.HandleImplIIOP), the home handle impl (org.jboss.proxy.ejb.HomeHandleImplIIOP), and the home factory (org.jboss.proxy.ejb.IIOPHomeFactory). When called by code running in the same VM as the the JBoss server, getInstance() returns the ORB instance used by the CorbaORBService MBean (which previously issued a setInstance() call). Otherwise getInstance() returns an ORB instance obtained with an ORB.init() call.
static void setInstance(ORB orb) { if (instance == null) instance = orb; else throw new RuntimeException(CorbaORB.class.getName() + ".setInstance() called more than once"); } This method is called only by the CorbaORBService MBean, so it has package visibility.

Method from org.jboss.iiop.CorbaORB Detail:

 public static ORB getInstance() {
      // No instance established, we must be on the client
      // Use the orb consistent with java:comp/ORB (if any).
      if (instance == null) 
      {
         try
         {
            InitialContext ctx = new InitialContext();
            instance = (ORB) ctx.lookup("java:comp/ORB");
         }
         catch (Exception ignored)
         {
         }
         if (instance == null)
            instance = ORBFactory.getORB();
      }
      return instance;
}

This method is called by classes that are used both at the server and at the client side: the handle impl (org.jboss.proxy.ejb.HandleImplIIOP), the home handle impl (org.jboss.proxy.ejb.HomeHandleImplIIOP), and the home factory (org.jboss.proxy.ejb.IIOPHomeFactory). When called by code running in the same VM as the the JBoss server, getInstance() returns the ORB instance used by the CorbaORBService MBean (which previously issued a setInstance() call). Otherwise getInstance() returns an ORB instance obtained with an ORB.init() call.

 static  void setInstance(ORB orb) {
      if (instance == null)
         instance = orb;
      else
         throw new RuntimeException(CorbaORB.class.getName() 
                                    + ".setInstance() called more than once");
}

This method is called only by the CorbaORBService MBean, so it has package visibility.