org.objectweb.jonathan.stub_factories.api
Interface StubFactory

public interface StubFactory

A Stub factory is a factory for stubs...

Method Summary

Object

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

Method Detail

newStub

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.