com.sapportals.portal.navigation

Interface INavigationNode

All Known Subinterfaces:

ICacheNavigationNode

public interface INavigationNode

 Represents a single node in the Navigation module.
 

Method Summary

boolean	contains(INavigationNode node) Check if node contains the node recieved as an argument (if merged using merge ID) or if similar to it.
boolean	contains(String nodeName) Check if node contains the node recieved as an argument (if merged using merge ID) or if similar to it.
Object	getAttributeValue(String attributeName) Retrieves an attribute value from the connector node.
Object	getAttributeValue(String attributeName, Locale locale) Retrieves an attribute value from the connector node, according to the given locale.
NavigationNodes	getChildren() Retrieves a list of node's children.
NavigationNodes	getChildrenBeforeMerge() Retrieves a list of the node's children, without merging them.
NavigationNodes	getChildrenWithInivisible() Retrieves a list of node's children, including nodes that are invisible.
String	getDescription(Locale locale) Retrieves the Description of the node (to be displayed in the navigation UI, if needed).
int	getDragRelate() Retrieves a value defining whether the node is Drag & Relate target.
String	getDropJScript() Retrieves the script that needs to be executed when droping a link on the node.
String	getDropJScriptId() Retrieves the ID of the JavaScript code returned in getDragJScript() (for optimizations).
String	getDropPRTEvent() Retrieves the PRT event that should be added to the iView's URL in case of a drop event.
int	getExtWindowHeight() Retrieves the height of the external window if node is defined to launch externally.
int	getExtWindowWidth() Retrieves the width of the external window if node is defined to launch externally.
INavigationNode	getFirstChild() Retrieves only the first child of the node.
String	getHashedName() Retrieves the hash representation of the full name of the node.
String	getLaunchURL() Retrieves the URL for launching the node.
String	getMergeID() Retrieves the id for merging the node with other siblings
String	getName() Retrieves the name of the node.
String	getNavConnectorNamePrefix() Retrieves the node's navigation connector name prefix.
double	getPriority() Retrieves the priority of the node that allows sorting tabs etc.
NamingEnumeration	getRelatedNavigationEntities() Retrieves a list of nodes having NAVIGATION_GET_RELATED_NAV_ENTITIES relation with the node.
NavigationNodes	getRelatedNavigationEntitiesNodes() Retrieves a list of nodes having NAVIGATION_GET_RELATED_NAV_ENTITIES relation with the node.
NavigationNodes	getRelatedSeeAlsoNodes() Retrieves a list of nodes having NAVIGATION_GET_RELATED_SEE_ALSO relation with the node.
NavigationNodes	getRelatedTargetNodes() Retrieves a list of nodes having NAVIGATION_GET_RELATED_DR_TARGETS relation with the node.
int	getShowType() Retrieves a value indicating whether the node is to be launched in external window (SHOW_EXTERNAL) or in the portal framework page (SHOW_INPLACE).
String	getTitle(Locale locale) Retrieves the title of the node (to be displayed in the navigation UI).
int	getVisualizationType() Retrieves the visualization type for this Node.
String	getWindowName() Retrieves the window Name in which the node will be launched if launched externally.
boolean	hasChildren() Return true is this navigation node has children and false otherwise.
boolean	isLaunchable() Retrieves flag indicating whether the node can be launched.
boolean	isMergible() Retrieves flag indicating whether the node can be merged.
NamingEnumeration	listBindings(String name, String mode) Enumerates the names bound in the named context, along with the objects bound to them.

Method Detail

getAttributeValue

public Object getAttributeValue(String attributeName)
                         throws NoSuchAttributeException

Retrieves an attribute value from the connector node.

Parameters:

attributeName - the attribute name for retrieval.

Returns:

the value of the attribute that was requested.

Throws:

NoSuchAttributeException

getAttributeValue

public Object getAttributeValue(String attributeName,
                                Locale locale)
                         throws NoSuchAttributeException

Retrieves an attribute value from the connector node, according to the given locale.

Parameters:

attributeName - the attribute name for retrieval.

locale - locale requested for the attribute.

Returns:

the value of the attribute that was requested.

Throws:

NoSuchAttributeException

getTitle

public String getTitle(Locale locale)

Retrieves the title of the node (to be displayed in the navigation UI).

Parameters:

locale - locale requested for the title.

Returns:

title of the node.

getDescription

public String getDescription(Locale locale)

Retrieves the Description of the node (to be displayed in the navigation UI, if needed).

Parameters:

locale - locale requested for the Description.

Returns:

description of the node.

getName

public String getName()

Retrieves the name of the node. The name include a navigation connector key prefix and the internal URL of the navigation connector.

Returns:

the name of the node.

getHashedName

public String getHashedName()

Retrieves the hash representation of the full name of the node. The hash name include the hash prefix.

Returns:

the hashed name of the node.

listBindings

public NamingEnumeration listBindings(String name,
                                      String mode)
                               throws NamingException

Enumerates the names bound in the named context, along with the objects bound to them.

Parameters:

name - the name of the context to list.

mode - defining the relation between the node and the requested nodes list.

Returns:

enumeration of names and objects of nodes related to the node in the mode argument value.

Throws:

NamingException

getChildren

public NavigationNodes getChildren()
                            throws NamingException

Retrieves a list of node's children.

Returns:

children list of node's children.

Throws:

NamingException - If naming operation while looking for children throws exception.

getChildrenWithInivisible

public NavigationNodes getChildrenWithInivisible()
                                          throws NamingException

Retrieves a list of node's children, including nodes that are invisible.

Returns:

children list of node's children.

Throws:

NamingException - If naming operation while looking for children throws exception.

getChildrenBeforeMerge

public NavigationNodes getChildrenBeforeMerge()
                                       throws NamingException

Retrieves a list of the node's children, without merging them.

Returns:

children list of node's children.

Throws:

NamingException - If naming operation while looking for children throws exception.

hasChildren

public boolean hasChildren()
                    throws NamingException

Return true is this navigation node has children and false otherwise.

Returns:

boolean indicates whether this node has children.

Throws:

NamingException - If naming operation while looking for children throws exception.

getFirstChild

public INavigationNode getFirstChild()
                              throws NamingException

Retrieves only the first child of the node.

Returns:

INavigationNode the first child of the node.

Throws:

NamingException - If naming operation while looking for children throws exception.

getRelatedSeeAlsoNodes

public NavigationNodes getRelatedSeeAlsoNodes()
                                       throws NamingException

Retrieves a list of nodes having NAVIGATION_GET_RELATED_SEE_ALSO relation with the node.

Returns:

list of nodes having NAVIGATION_GET_RELATED_SEE_ALSO relation with the node.

Throws:

NamingException - If naming operation while looking for nodes throws exception.

getRelatedTargetNodes

public NavigationNodes getRelatedTargetNodes()
                                      throws NamingException

Retrieves a list of nodes having NAVIGATION_GET_RELATED_DR_TARGETS relation with the node.

Returns:

list of nodes having NAVIGATION_GET_RELATED_DR_TARGETS relation with the node.

Throws:

NamingException - If naming operation while looking for nodes throws exception.

getRelatedNavigationEntities

public NamingEnumeration getRelatedNavigationEntities()
                                               throws NamingException

Retrieves a list of nodes having NAVIGATION_GET_RELATED_NAV_ENTITIES relation with the node.

Returns:

list of units having NAVIGATION_GET_RELATED_NAV_ENTITIES relation with the code.

Throws:

NamingException - If naming operation while looking for nodes throws exception.

getRelatedNavigationEntitiesNodes

public NavigationNodes getRelatedNavigationEntitiesNodes()
                                                  throws NamingException

Retrieves a list of nodes having NAVIGATION_GET_RELATED_NAV_ENTITIES relation with the node.

Returns:

list of units having NAVIGATION_GET_RELATED_NAV_ENTITIES relation with the code.

Throws:

NamingException - If naming operation while looking for nodes throws exception.

getPriority

public double getPriority()

Retrieves the priority of the node that allows sorting tabs etc.

Returns:

the priority of the node.

getVisualizationType

public int getVisualizationType()

Retrieves the visualization type for this Node. Types are defined in the INAvigationConstants interface.

Returns:

constant representing the default visualization for displaying the node.

isLaunchable

public boolean isLaunchable()

Retrieves flag indicating whether the node can be launched.

Returns:

whether the node can be launched.

getLaunchURL

public String getLaunchURL()

Retrieves the URL for launching the node.

Returns:

URL for launching the node.

getDragRelate

public int getDragRelate()

Retrieves a value defining whether the node is Drag & Relate target. Returns either REGULAR_TARGET or DRAGANDRELATE_TARGET. Constants defined in the INavigationConstants interface.

Returns:

value defining whether the node is Drag & Relate target.

getDropJScript

public String getDropJScript()
                      throws UnsupportedOperationException

Retrieves the script that needs to be executed when droping a link on the node. This script would run on the JavaScript onDrop event.

Returns:

the Java script defined for the dragging event. null if no Jscript has been defined.

Throws:

UnsupportedOperationException - if node does not support scripts for drop events.

getDropJScriptId

public String getDropJScriptId()
                        throws UnsupportedOperationException

Retrieves the ID of the JavaScript code returned in getDragJScript() (for optimizations).

Returns:

the Java script id defined for the dragging event. null if no JScript has been defined.

Throws:

UnsupportedOperationException - if node does not support scripts for drop events.

getDropPRTEvent

public String getDropPRTEvent()
                       throws UnsupportedOperationException

Retrieves the PRT event that should be added to the iView's URL in case of a drop event.

Returns:

the PRT event that should be added to the iView's URL in case of a drop event.

Throws:

UnsupportedOperationException - if node does not support scripts for drop events.

getShowType

public int getShowType()

Retrieves a value indicating whether the node is to be launched in external window (SHOW_EXTERNAL) or in the portal framework page (SHOW_INPLACE). The constants are located in the INavigationConstants interafce.

Returns:

whether the node is to be launched in external window or in the portal framework page.

isMergible

public boolean isMergible()

Retrieves flag indicating whether the node can be merged.

Returns:

whether the node can be merged.

getMergeID

public String getMergeID()
                  throws UnsupportedOperationException

Retrieves the id for merging the node with other siblings

Returns:

the id for merging the node with other siblings.

Throws:

UnsupportedOperationException - if node does not support merging.

getWindowName

public String getWindowName()
                     throws UnsupportedOperationException

Retrieves the window Name in which the node will be launched if launched externally.

Returns:

the window Name in which the node will be launched.

Throws:

UnsupportedOperationException - Window name is not supported or node defined to be launched in portal framework page.

getExtWindowHeight

public int getExtWindowHeight()
                       throws UnsupportedOperationException

Retrieves the height of the external window if node is defined to launch externally. The measurment unit is pixel.

Returns:

the height of the external window if launched externally.

Throws:

UnsupportedOperationException - width is not supported or node defined to be launched in place.

getExtWindowWidth

public int getExtWindowWidth()
                      throws UnsupportedOperationException

Retrieves the width of the external window if node is defined to launch externally. The measurment unit is pixel.

Returns:

the width of the external window if launched externally.

Throws:

UnsupportedOperationException - width is not supported or node defined to be launched in place.

getNavConnectorNamePrefix

public String getNavConnectorNamePrefix()

Retrieves the node's navigation connector name prefix.

Returns:

node's navigation connector name prefix.

contains

public boolean contains(INavigationNode node)

Check if node contains the node recieved as an argument (if merged using merge ID) or if similar to it.

Parameters:

node - navigation node for checking (result of merging operation done using the merge ID of the nodes).

Returns:

true if the node is contained in the object or similar to it and false otherwise.

contains

public boolean contains(String nodeName)

Check if node contains the node recieved as an argument (if merged using merge ID) or if similar to it.

Returns:

true if the node is contained in the object or similar to it and false otherwise.