org.objectweb.david.libs.stub_factories.std
Class JStubFactory

java.lang.Object
  |
  +--org.objectweb.david.libs.stub_factories.std.JStubFactory

All Implemented Interfaces:

Constants, StubFactory

public class JStubFactory

extends Object

implements StubFactory, Constants

Stub factories are factories for client and server stubs. This interface is used by binders to require the construction of stubs.

Inner Class Summary

class

JStubFactory.ClientDelegate Type of the client-side delegates.

Field Summary

protected static Hashtable

smart_output_table Hashtable containing the smart stubs.

Fields inherited from interface org.objectweb.david.libs.stub_factories.std.Constants

_bad_operation, _corba_object_id, _corba_prefix, _just_corba_object

Constructor Summary

JStubFactory(ORB orb, ClassLoader loader)
Constructs a new stub factory.

Method Summary

protected Class	createClass(String str) Loads the class of name str using the class loader of the target stub factory
protected ObjectImpl	newSmartStub(String s_type, Delegate delegate) Returns a stub of type s_type, initialized with the provided delegate.
Object	newStub(SessionIdentifier session_id, Identifier[] ids, Context hints) Creates a new stub.
static ObjectImpl	newStub(String s_type, Delegate delegate) Returns a new stub of type s_type initialized with the provided delegate.
static void	registerSmartStub(String std_stub_type, Class smart_stub_class) Registers a class for smart output stubs as a replacement of a standard stub type.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

smart_output_table

protected static Hashtable smart_output_table

Hashtable containing the smart stubs.

Constructor Detail

JStubFactory

public JStubFactory(ORB orb,
                    ClassLoader loader)

Constructs a new stub factory.

Parameters:

orb - the ORB asking for the construction of the stub factory;

loader - the class loader used to initialize orb.

Method Detail

newStub

public Object newStub(SessionIdentifier session_id,
                      Identifier[] ids,
                      Context hints)
               throws JonathanException

Creates a new stub.

Specified by:

newStub in interface StubFactory

Parameters:

session_id - a protocol session identifier, to be used to send marshalled data to the object represented by the stub;

ids - the set of identifiers of the stub;

hints - hints

Returns:

a stub

Throws:

JonathanException - if something goes wrong.

newStub

public static ObjectImpl newStub(String s_type,
                                 Delegate delegate)
                          throws JonathanException

Returns a new stub of type s_type initialized with the provided delegate.

The provided delegate must be of type ClientDelegate otherwise this method returns null.

Parameters:

s_type - the expected stub type;

delegate - a CORBA delegate.

Returns:

a stub of the expected type.

Throws:

JonathanException - if something goes wrong.

registerSmartStub

public static void registerSmartStub(String std_stub_type,
                                     Class smart_stub_class)

Registers a class for smart output stubs as a replacement of a standard stub type.

If smart_stub_class is null, the previous class registered for std_stub_type is un-registered. std_stub_type must not be null.

Parameters:

stub_type - the scoped name of the the standard stub class;

stub_class - the smart stub class.

createClass

protected Class createClass(String str)
                     throws ClassNotFoundException

Loads the class of name str using the class loader of the target stub factory

Parameters:

str - the name of a class to load;

Returns:

the corresponding class object.

Throws:

ClassNotFoundException - if the class can't be found.

newSmartStub

protected ObjectImpl newSmartStub(String s_type,
                                  Delegate delegate)
                           throws JonathanException

Returns a stub of type s_type, initialized with the provided delegate.

If a smart stub type has been registered for s_type, it is used. Otherwise, the regular stub type is used.

Parameters:

s_type - the stub type;

delegate - the delegate for the created stub (may be null).

Returns:

a (smart) stub

Throws:

JonathanException - if something goes wrong.