org.safs.rmi.engine

Interface SubItemsAgent

All Superinterfaces:

java.rmi.Remote

All Known Implementing Classes:

AgentImpl

public interface SubItemsAgent
extends java.rmi.Remote

Defines the interface necessary to extract items out of referenced objects by some qualifying factor like index or text. This interface represents the remote agent side of the implementation and is intended to match the server SubItemsServer interface.

Since:

Apr 7, 2005

Author:

Carl Nagle

See Also:

org.safs.jvmagent.SubItemsServer

Method Summary

Modifier and Type	Method and Description
java.lang.Object	getMatchingPathObject(java.lang.Object object, java.lang.String path) Return the subitem at the specified string path from the given object.
java.lang.Object	getSubItemAtIndex(java.lang.Object object, int index) Return the subitem at the specified index from the given object.
boolean	isMatchingPath(java.lang.Object object, java.lang.String path) Determine if the object contains a subitem/object identified by the provided Path.

Method Detail

getSubItemAtIndex

java.lang.Object getSubItemAtIndex(java.lang.Object object,
                                   int index)
                            throws java.rmi.RemoteException,
                                   java.lang.Exception

Return the subitem at the specified index from the given object. This may be a ComboBox item, a List item, or a Tree node, etc... The returned item may be a component object or perhaps a String representing the text of the item. The return type is object specific.

Parameters:

object - reference from which to locate the subitem.

index - of the subitem to retrieve.

Returns:

subitem object or String

Throws:

an - Exception if the subitem index is invalid or subitem is unobtainable.

java.rmi.RemoteException

java.lang.Exception

getMatchingPathObject

java.lang.Object getMatchingPathObject(java.lang.Object object,
                                       java.lang.String path)
                                throws java.rmi.RemoteException,
                                       java.lang.Exception

Return the subitem at the specified string path from the given object. This is a hierarchical path of parent->child relationships separated by "->". The returned item may be a component object or perhaps a String representing the text of the item. The return type is object specific.

Parameters:

child -

path - to desired subitem using item->subitem->subitem format.

Returns:

subitem object or String

Throws:

java.rmi.RemoteException

java.lang.Exception

isMatchingPath

boolean isMatchingPath(java.lang.Object object,
                       java.lang.String path)
                throws java.rmi.RemoteException,
                       java.lang.Exception

Determine if the object contains a subitem/object identified by the provided Path. Path is hierarchical information showing parent->child relationships separated by '->'. This is often used in Menus and Trees.

Ex:

File->Exit
Root->Branch->Leaf

Parameters:

object--Object - proxy for the object to be evaluated.

path - information to locate another object or subitem relative to object. this is usually something like a menuitem or tree node where supported.

Returns:

true if the child sub-object was found relative to object.

Throws:

java.rmi.RemoteException

java.lang.Exception