org.objectweb.jonathan.apis.stub_factories
Interface StubFactory

All Known Subinterfaces:

JRMIStubFactory

All Known Implementing Classes:

EventChannelFactory, JStubFactory, StdStubFactory

public interface StubFactory

A Stub factory is a factory for stubs...

Method Summary

java.lang.Object

newStub(SessionIdentifier session_id, Identifier[] ids, org.objectweb.jonathan.apis.kernel.Context hints) Creates a new stub.

Method Detail

newStub

public java.lang.Object newStub(SessionIdentifier session_id,
                                Identifier[] ids,
                                org.objectweb.jonathan.apis.kernel.Context hints)
                         throws org.objectweb.jonathan.apis.kernel.JonathanException

Creates a new stub.

A stub plays two roles:

• It is the local representative of a (remote) object, and thus should bear a set of identifiers for that remote object;
• It is part of the binding between the client and the server, and is thus related to a given protocol. The session identifier provided as an argument is the manifestation of this relation. It can be used to obtain a session allowing the stub to send data to the remote object.

Parameters:

session_id - a 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 - other data possibly used to create the stub.

Returns:

a stub

Throws:

org.objectweb.jonathan.apis.kernel.JonathanException - if something goes wrong.