org.objectweb.jonathan.apis.stub_factories
Interface StubFactory

All Known Subinterfaces:

JRMIStubFactory

All Known Implementing Classes:

JStubFactory, EventChannelFactory

public interface StubFactory

A Stub factory is a factory for stubs...

Method Summary

Object

newStub(SessionIdentifier session_id, Identifier[] ids, Context hints) Creates a new stub.

Method Detail

newStub

public Object newStub(SessionIdentifier session_id,
                      Identifier[] ids,
                      Context hints)
               throws 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:

JonathanException - if something goes wrong.