Interface COM.ibm.jaws.motk.ObjectResolver
All Packages  Class Hierarchy  This Package  Previous  Next  Index

Interface COM.ibm.jaws.motk.ObjectResolver

public interface ObjectResolver
extends Object
This interface defines the two methods needed by method-call serialization to deal with object references.

Method Index

 o findObject(String, String)
Returns the object named by the sequence of keys in the specified String.
 o getKeyPath(Object)
Returns the keyPath as a string for this object.

Methods

 o findObject
  public abstract Object findObject(String keyPath,
                                    String interfaceName) throws MOFWException
Returns the object named by the sequence of keys in the specified String. Keys are delimited by the '/' character. Keys may contain any characters except slash. If the first character in a keyPath is slash then the keyPath is relative to root on the current execution environment. If it does not begin with slash then it is relative to the relative context of the current execution environment. Concrete implementations of this interface will specifiy how the relative context is determined.
Parameters:
keyPath - a String with '/' separated tokens that identifies an object, keyPaths that start with the character '/' are root keyPaths, ones that do not are relative keyPaths. Not all ObjectResolvers support relative keyPaths.
interfaceName - the returned object needs to support this interface, however findObject is not required to test this.
Returns:
the Object
Throws: MOFWException
raised if the object cannot be located for any reason.
 o getKeyPath
  public abstract String getKeyPath(Object obj)
Returns the keyPath as a string for this object. The key may be relative to the relative context of this execution environment or it may be an absolute key. ObjectResolver implementations may choose to only return absolute keys.
Parameters:
the - target object
Returns:
a keyPath String that can be used to find the target object if given to the findObject method of this same object resolver.

All Packages  Class Hierarchy  This Package  Previous  Next  Index