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, Context hints)
Creates a new stub.

Method Details

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