org.objectweb.jonathan.apis.stub_factories
Interface StubFactory

All Known Implementing Classes:

MyRmiStubFactory, RmiStubFactory

public interface StubFactory

A Stub factory is a factory for stubs...

Method Summary

java.lang.Object

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

Method Detail

newStub

java.lang.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.