oracle.jbo
Interface JboContext

All Superinterfaces:

javax.naming.Context

All Known Implementing Classes:

ColoInitialContext, InitialContextImpl, InitialContextImpl, JboInitialContext, WLEJBInitialContext

public interface JboContext
extends javax.naming.Context

Defines additional properties (or environment variables) for the initial context. The following table describes the properties, their possible values, and the platforms for which they are required.

Context Property	Description	Required on Platforms
DEPLOY_PLATFORM	Platform to which an Application Module is deployed. One of PLATFORM_LOCAL, PLATFORM_VB, PLATFORM_EJB, or PLATFORM_ORACLE8I.	ALL
INITIAL_CONTEXT_FACTORY	Must be JBO_CONTEXT_FACTORY.	ALL
HOST_NAME	Host on which the Application Module server is deployed. Required on Visibroker for USE_BIND mode only.	Oracle8i, Visibroker
CONNECTION_PORT	Port number where the ORB listens for IIOP requests	Oracle8i
CONNECTION_MODE	Specifies how to connect to Application Module server. Clients can connect to an Application Module server started on a remote host (USE_BIND mode), find the server using the Visibroker naming service (REMOTE mode), or load the server in the client's VM (COLOCATED mode).	Visibroker
ORACLE_SID	Oracle8i service ID to identify the ORB service.	Oracle8i
APPLICATION_PATH	JNDI path under which an Application Module is registered. Full path under which an Application Module is published.	Oracle8i
USE_APPLET	Must be used whenever the client is an applet.	Visibroker, Oracle8i
SECURITY_PRINCIPAL	User name. Required for connecting to an Application Module deployed as CORBA server or an EJB session bean.	Oracle8i
SECURITY_CREDENTIALS	Password. Required for connecting to an Application Module deployed as CORBA server or an EJB session bean.	Oracle8i

Using the Context Properties

You first create a hashtable to store the properties:

 static Hashtable env = new Hashtable(10);
 

Your code must also include a definition of the Application Module home:

 static ApplicationModuleHome mHome ;
 

You must include code to connect to the database. Then set the properties for deploying.

Setting Properties for Deploying Locally

The following code snippet illustrates how to set the properties to run an Application Module deployed locally.

  // Component running locally
     {
     public static void setLocalEnv()  {
     env.put(JboContext.INITIAL_CONTEXT_FACTORY,
                        JboContext.JBO_CONTEXT_FACTORY);
     env.put(JboContext.DEPLOY_PLATFORM, JboContext.PLATFORM_LOCAL);
     }
   }
 

Setting Properties for Deploying on Oracle8i as a CORBA Server Object

The following code snippet illustrates how to set the properties for loading an Application Module deployed on Oracle8i as a CORBA object.

 // Component deployed to Oracle8i CORBA Server.
 // Set up the 8i environment
    public static void set8iEnv()   {
    env.put(JboContext.INITIAL_CONTEXT_FACTORY,
                      JboContext.JBO_CONTEXT_FACTORY);
    env.put(JboContext.DEPLOY_PLATFORM, JboContext.PLATFORM_ORACLE8I);
    env.put(JboContext.SECURITY_PRINCIPAL, "scott");
    env.put(JboContext.SECURITY_CREDENTIALS, "tiger");
    env.put(JboContext.HOST_NAME, "localhost");
    env.put(JboContext.CONNECTION_PORT, "2481");
    env.put(JboContext.ORACLE_SID, "ORA815");
    env.put(JboContext.APPLICATION_PATH, "test");
  }
 

Setting the Environment for Deploying on Oracle8i as an EJB

The following code snippet illustrates how to use the properties to set the environment for loading an Application Module deployed on Oracle8i as an EJB.

  // Component deployed to Oracle8i as EJB.
  // Set up the 8i environment
     public static void set8iEnv()  {
     env.put(JboContext.INITIAL_CONTEXT_FACTORY,
                       JboContext.JBO_CONTEXT_FACTORY);
     env.put(JboContext.DEPLOY_PLATFORM, JboContext.PLATFORM_EJB);
     env.put(JboContext.SECURITY_PRINCIPAL, "scott");
     env.put(JboContext.SECURITY_CREDENTIALS, "tiger");
     env.put(JboContext.HOST_NAME, "localhost");
     env.put(JboContext.CONNECTION_PORT, "2481");
     env.put(JboContext.ORACLE_SID, "ORA815");
     env.put(JboContext.APPLICATION_PATH, "test");
  }
 

Setting the Environment for Visibroker Servers

For examples of setting the environment for Visibroker Servers, see ConnectionModeConstants

Setting the Initial Context and Loading the Application Module

The following code snippet illustrates creating an initial context for the environment and creating the Application Module d2e.D2eModule in the database. This Application Module was created at design time.

 // Load the Application Module
    ApplicationModule appMod = null;
      try
        {
          Context ic = new InitialContext(env);
          String theAMDefName = "d2e.D2eModule";
          ApplicationModuleHome home =
                              (ApplicationModuleHome)ic.lookup(theAMDefName);
          ApplicationModule appMod = home.create();
          appMod.getTransaction().connect("jdbc:oracle:thin:scott/tiger@pc3:1521:ORCL");
          return appMod;
        }
        catch(Exception e) {
      e.printStackTrace();
   }
 

See Also:

Context

Field Summary

static java.lang.String	APPLICATION_PACKAGES Reserved for future use.
static java.lang.String	APPLICATION_PATH JNDI path under which an Application Module is registered.
static java.lang.String	CONNECTION_MODE Specifies how to connect to Application Module server.
static java.lang.String	CONNECTION_PORT Port number where the ORB listens for IIOP requests.
static java.lang.String	DEPLOY_PLATFORM Platform to which an Application Module is deployed.
static java.lang.String	HOST_NAME Host on which the Application Module server is started.
static java.lang.String	JBO_CONTEXT_FACTORY
static java.lang.String	JBO_PROJECT Used to pass the Project substitution name for Oracle8i.
static java.lang.String	ORACLE_SID Oracle8i CORBA Server service ID to identify the ORB service.
static java.lang.String	PLATFORM_COLO Colocated platform.
static java.lang.String	PLATFORM_EJB EJB on the Oracle8i platform.
static java.lang.String	PLATFORM_EJB_IAS Oracle Application Server platform.
static java.lang.String	PLATFORM_LOCAL Local platform.
static java.lang.String	PLATFORM_ORACLE8I Oracle8i platform.
static java.lang.String	PLATFORM_SDO SDO Service Interface platform.
static java.lang.String	PLATFORM_VB Visibroker platform.
static java.lang.String	PLATFORM_WLS EJB on the Oracle Application Server platform.
static java.lang.String	USE_APPLET Must be used whenever the client is an applet.
static java.lang.String	USE_DEFAULT_CONTEXT

Fields inherited from interface javax.naming.Context

APPLET, AUTHORITATIVE, BATCHSIZE, DNS_URL, INITIAL_CONTEXT_FACTORY, LANGUAGE, OBJECT_FACTORIES, PROVIDER_URL, REFERRAL, SECURITY_AUTHENTICATION, SECURITY_CREDENTIALS, SECURITY_PRINCIPAL, SECURITY_PROTOCOL, STATE_FACTORIES, URL_PKG_PREFIXES

Method Summary

Methods inherited from interface javax.naming.Context

addToEnvironment, bind, bind, close, composeName, composeName, createSubcontext, createSubcontext, destroySubcontext, destroySubcontext, getEnvironment, getNameInNamespace, getNameParser, getNameParser, list, list, listBindings, listBindings, lookup, lookup, lookupLink, lookupLink, rebind, rebind, removeFromEnvironment, rename, rename, unbind, unbind

Field Detail

DEPLOY_PLATFORM

static final java.lang.String DEPLOY_PLATFORM

Platform to which an Application Module is deployed. One of PLATFORM_VB, PLATFORM_LOCAL, or PLATFORM_ORACLE8I.

Required for all platforms.

See Also:

Constant Field Values

HOST_NAME

static final java.lang.String HOST_NAME

Host on which the Application Module server is started.

Required on Visibroker for USE_BIND mode only. Also required for PLATFORM_ORACLE8I.

See Also:

Constant Field Values

CONNECTION_PORT

static final java.lang.String CONNECTION_PORT

Port number where the ORB listens for IIOP requests.

Required for PLATFORM_ORACLE8I.

See Also:

Constant Field Values

CONNECTION_MODE

static final java.lang.String CONNECTION_MODE

Specifies how to connect to Application Module server. Clients can connect to an Application Module server started on a remote host (USE_BIND mode), find the server using the Visibroker naming service (REMOTE mode), or load the server in the client's VM (COLOCATED mode).

Required for PLATFORM_VB.

See Also:

Constant Field Values

ORACLE_SID

static final java.lang.String ORACLE_SID

Oracle8i CORBA Server service ID to identify the ORB service.

Required for PLATFORM_ORACLE8I.

See Also:

Constant Field Values

APPLICATION_PATH

static final java.lang.String APPLICATION_PATH

JNDI path under which an Application Module is registered. Full path under which an Application Module is published.

Required for PLATFORM_VB.

See Also:

Constant Field Values

PLATFORM_VB

static final java.lang.String PLATFORM_VB

Visibroker platform.

See Also:

Constant Field Values

PLATFORM_LOCAL

static final java.lang.String PLATFORM_LOCAL

Local platform.

See Also:

Constant Field Values

PLATFORM_COLO

static final java.lang.String PLATFORM_COLO

Colocated platform.

See Also:

Constant Field Values

PLATFORM_EJB_IAS

static final java.lang.String PLATFORM_EJB_IAS

Oracle Application Server platform.

See Also:

Constant Field Values

PLATFORM_ORACLE8I

static final java.lang.String PLATFORM_ORACLE8I

Oracle8i platform.

See Also:

Constant Field Values

PLATFORM_EJB

static final java.lang.String PLATFORM_EJB

EJB on the Oracle8i platform.

See Also:

Constant Field Values

PLATFORM_WLS

static final java.lang.String PLATFORM_WLS

EJB on the Oracle Application Server platform.

See Also:

Constant Field Values

JBO_CONTEXT_FACTORY

static final java.lang.String JBO_CONTEXT_FACTORY

See Also:

Constant Field Values

PLATFORM_SDO

static final java.lang.String PLATFORM_SDO

SDO Service Interface platform.

See Also:

Constant Field Values

APPLICATION_PACKAGES

static final java.lang.String APPLICATION_PACKAGES

Reserved for future use.

See Also:

Constant Field Values

USE_APPLET

static final java.lang.String USE_APPLET

Must be used whenever the client is an applet.

Required for PLATFORM_ORACLE8I and PLATFORM_VB.

See Also:

Constant Field Values

JBO_PROJECT

static final java.lang.String JBO_PROJECT

Used to pass the Project substitution name for Oracle8i.

See Also:

Constant Field Values

USE_DEFAULT_CONTEXT

static final java.lang.String USE_DEFAULT_CONTEXT

See Also:

Constant Field Values