|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface Grail
This class defines a Generic Standard Java Interface for a Distributed Computing Library. It could be implemented by any reasonably sophisticated framework.
Four fundamental constraints are imposed:
The specific package in which this class resides, and that of its implementing class, can be framework specific.
Method Summary | |
---|---|
void |
export(java.lang.Object object)
This method makes an object's public methods, whether instance or static, remotely invocable. |
java.lang.Object[] |
lookup(java.lang.Class methodSetInterface)
This method finds all remotely invocable objects, supporting the specified method set. |
java.lang.Object |
proxy(java.lang.Object reference,
java.lang.Class methodSetInterface)
This method instantiates a Dynamic Proxy at the client, which implements the method set specified. |
Method Detail |
---|
void export(java.lang.Object object) throws java.lang.Exception
Note: There is no silly requirement that the object being exported implement a no-arg constructor; any syntactically valid class definition will work.
object
- The
POJO to be made remotely invocable, i.e. there is no requirement
for it to implement any special interfaces, nor to be derived from any
particular class
java.lang.Exception
- For any network or framework specific reasonsjava.lang.Object[] lookup(java.lang.Class methodSetInterface) throws java.lang.Exception
Four levels of remote object covariance must be supported here:
Notes: If the client interface has superinterfaces, their methods must also be matched similarly. Method arguments, and returns, are alowed to be primitive types as well. Argument names are not matched, to allow them to be whatever is meaningful to the client.
methodSetInterface
- The interface of methods that remote objects
are required to support
java.lang.Exception
- For any network or framework specific reasonsjava.lang.Object proxy(java.lang.Object reference, java.lang.Class methodSetInterface)
reference
- A reference to a remote object returned by the
lookup method of this interfacemethodSetInterface
- The set (or subset) of client methods,
static or instance, that the remote object implements
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |