org.mmbase.bridge
Interface NodeManager

All Superinterfaces:
Node
All Known Subinterfaces:
RelationManager
All Known Implementing Classes:
BasicNodeManager, BasicRelationManager

public interface NodeManager
extends Node

This interface represents a node's type information object - what used to be the 'builder'. It contains all the field and attribuut information, as well as GUI data for editors and some information on deribed and deriving types. It also contains some maintenance code - code to create new nodes, en code to query objects belonging to the same manager. Since node types are normally maintained through use of config files (and not in the database), as wel as for security issues, the data of a nodetype cannot be changed except through the use of an administration module (which is why we do not include setXXX methods here).

Version:
$Id: NodeManager.java,v 1.32 2004/04/07 15:10:55 keesj Exp $
Author:
Rob Vermeulen, Pierre van Rooden

Field Summary
static int GUI_PLURAL
           
static int GUI_SINGULAR
           
static int ORDER_CREATE
           
static int ORDER_EDIT
           
static int ORDER_LIST
           
static int ORDER_NONE
           
static int ORDER_SEARCH
           
 
Method Summary
 Node createNode()
          Creates a new node.
 NodeQuery createQuery()
          Creates a query for this NodeNanager.
 RelationManagerList getAllowedRelations()
          Retrieve all relation managers that can be used to create relations for objects of this nodemanager.
 RelationManagerList getAllowedRelations(NodeManager nodeManager, java.lang.String role, java.lang.String direction)
          Retrieve all relation managers that can be used to create relations for objects from this nodemanager, to the specified manager, using the specified role and direction.
 RelationManagerList getAllowedRelations(java.lang.String nodeManager, java.lang.String role, java.lang.String direction)
          Retrieve all relation managers that can be used to create relations for objects from this nodemanager, to the specified manager, using the specified role and direction.
 Cloud getCloud()
          Returns the cloud to which this manager belongs.
 NodeManagerList getDescendants()
          Retrieve a list of descendant nodemanagers (the Nodemanager that - posisbly indirectly - extend from this nodemanager)
 java.lang.String getDescription()
          Returns the description of this node manager.
 java.lang.String getDescription(java.util.Locale locale)
          Returns the description of this node manager in a specified language.
 Field getField(java.lang.String name)
          Returns the field with the specified name.
 FieldList getFields()
          Returns a list of all fields defined for this node manager.
 FieldList getFields(int order)
          Retrieve a subset of field types of this NodeManager, depending on a given order.
 java.lang.String getGUIName()
          Returns the descriptive name of this node manager.
 java.lang.String getGUIName(int plurality)
          Returns the descriptive name of this node manager.
 java.lang.String getGUIName(int plurality, java.util.Locale locale)
          Returns the descriptive name of this node manager ina a specified language.
 java.lang.String getInfo(java.lang.String command)
          Retrieve info from a node manager based on a command string.
 java.lang.String getInfo(java.lang.String command, javax.servlet.ServletRequest req, javax.servlet.ServletResponse resp)
          Retrieve info from a node manager based on a command string Similar to the $MOD command in SCAN.
 NodeList getList(NodeQuery query)
          Executes a query and returns the result as nodes of this NodeManager (or of extensions)
 NodeList getList(java.lang.String command, java.util.Map parameters)
          Retrieve info (as a list of virtual nodes) from a node manager based on a command string.
 NodeList getList(java.lang.String command, java.util.Map parameters, javax.servlet.ServletRequest req, javax.servlet.ServletResponse resp)
          Retrieve info from a node manager based on a command string Similar to the LIST command in SCAN.
 NodeList getList(java.lang.String constraints, java.lang.String orderby, java.lang.String directions)
          Returns a list of nodes belonging to this node manager.
 java.lang.String getName()
          Returns the name of this node manager.
 NodeManager getParent()
          Retrieve the parent of this NodeManager (the Nodemanager that this nodemanager extends from)
 java.util.Map getProperties()
          Retrieve a copy of the node manager's properties
 java.lang.String getProperty(java.lang.String name)
          Retrieve a property of the node manager.
 boolean hasField(java.lang.String fieldName)
          Tests whether the field with the specified name exists in this nodemanager.
 boolean mayCreateNode()
          Check if the current user may create a new node of this type.
 
Methods inherited from interface org.mmbase.bridge.Node
cancel, commit, countRelatedNodes, countRelatedNodes, countRelations, countRelations, createAlias, createRelation, delete, delete, deleteAlias, deleteRelations, deleteRelations, getAliases, getBooleanValue, getByteValue, getContext, getDoubleValue, getFieldValue, getFieldValue, getFloatValue, getFunctionValue, getIntValue, getLongValue, getNodeManager, getNodeValue, getNumber, getObjectValue, getPossibleContexts, getRelatedNodes, getRelatedNodes, getRelatedNodes, getRelatedNodes, getRelatedNodes, getRelations, getRelations, getRelations, getRelations, getRelations, getStringValue, getValue, getXMLValue, getXMLValue, hasRelations, isNodeManager, isRelation, isRelationManager, mayChangeContext, mayDelete, mayWrite, setBooleanValue, setByteValue, setContext, setDoubleValue, setFloatValue, setIntValue, setLongValue, setNodeValue, setObjectValue, setStringValue, setValue, setXMLValue, toNodeManager, toRelation, toRelationManager, toString
 

Field Detail

ORDER_NONE

public static final int ORDER_NONE
See Also:
Constant Field Values

ORDER_CREATE

public static final int ORDER_CREATE
See Also:
Constant Field Values

ORDER_EDIT

public static final int ORDER_EDIT
See Also:
Constant Field Values

ORDER_LIST

public static final int ORDER_LIST
See Also:
Constant Field Values

ORDER_SEARCH

public static final int ORDER_SEARCH
See Also:
Constant Field Values

GUI_SINGULAR

public static final int GUI_SINGULAR
See Also:
Constant Field Values

GUI_PLURAL

public static final int GUI_PLURAL
See Also:
Constant Field Values
Method Detail

createNode

public Node createNode()
Creates a new node. The returned node will not be visible in the cloud until the commit() method is called on this node. Until then it will have a temporary node number.

Returns:
the new Node

getCloud

public Cloud getCloud()
Returns the cloud to which this manager belongs.

Specified by:
getCloud in interface Node
Returns:
the cloud to which this manager belongs

getParent

public NodeManager getParent()
                      throws NotFoundException
Retrieve the parent of this NodeManager (the Nodemanager that this nodemanager extends from)

Returns:
the NodeManager's parent
Throws:
NotFoundException - if no parent exists (i.e. this nodeManager is "object")

getDescendants

public NodeManagerList getDescendants()
Retrieve a list of descendant nodemanagers (the Nodemanager that - posisbly indirectly - extend from this nodemanager)

Returns:
a list of NodeManagers

getName

public java.lang.String getName()
Returns the name of this node manager. This name is a unique name.

Returns:
the name of this node manager.

getProperty

public java.lang.String getProperty(java.lang.String name)
Retrieve a property of the node manager.

Parameters:
name - the name of the property
Returns:
the property value (null if not given)
Since:
MMBase-1.7

getProperties

public java.util.Map getProperties()
Retrieve a copy of the node manager's properties

Returns:
a map of node manager properties
Since:
MMBase-1.7

getGUIName

public java.lang.String getGUIName()
Returns the descriptive name of this node manager. This name will be in the language of the current cloud (defined in cloud.getLocale()).

Returns:
the descriptive name of this node manager

getGUIName

public java.lang.String getGUIName(int plurality)
Returns the descriptive name of this node manager. This name will be in the language of the current cloud (defined in cloud.getLocale()).

Parameters:
plurality - the plurality (number of objects) for which to return a description (GUI_SINGULAR or GUI_PLURAL)
Returns:
the descriptive name of this node manager
Since:
MMBase-1.6

getGUIName

public java.lang.String getGUIName(int plurality,
                                   java.util.Locale locale)
Returns the descriptive name of this node manager ina a specified language.

Parameters:
plurality - the plurality (number of objects) for which to return a description (GUI_SINGULAR or GUI_PLURAL)
locale - the locale that determines the language for the GUI name
Returns:
the descriptive name of this node manager
Since:
MMBase-1.6

getDescription

public java.lang.String getDescription()
Returns the description of this node manager.

Returns:
the description of this node manager

getDescription

public java.lang.String getDescription(java.util.Locale locale)
Returns the description of this node manager in a specified language.

Parameters:
locale - the locale that determines the language for the description
Returns:
the description of this node manager

getFields

public FieldList getFields()
Returns a list of all fields defined for this node manager.

Returns:
a list of all fields defined for this node manager

getFields

public FieldList getFields(int order)
Retrieve a subset of field types of this NodeManager, depending on a given order.

Parameters:
order - the order in which to list the fields
Returns:
a List of FieldType objects

getField

public Field getField(java.lang.String name)
               throws NotFoundException
Returns the field with the specified name.

Parameters:
name - the name of the field to be returned
Returns:
the field with the requested name
Throws:
NotFoundException - is the field does not exist

hasField

public boolean hasField(java.lang.String fieldName)
Tests whether the field with the specified name exists in this nodemanager.

Returns:
true if the field with the requested name exists
Since:
MMBase-1.6

getList

public NodeList getList(java.lang.String constraints,
                        java.lang.String orderby,
                        java.lang.String directions)
Returns a list of nodes belonging to this node manager. Constraints can be given to exclude nodes from the returned list. These constraints follow the syntax of the SQL where clause. It's a good practice to use uppercase letters for the operators and lowercase letters for the fieldnames. Example constraints are:
 "number = 100" (!=, <, >, <= and >= can also be used)
 "name = 'admin'",
 "email IS NULL" (indicating the email field is empty)
 "email LIKE '%.org'" (indication the email should end with .org)
 "number BETWEEN 99 AND 101"
 "name IN ('admin', 'anonymous')"
 
The NOT operator can be used to get the opposite result like:
 "NOT (number = 100)"
 "NOT (name = 'admin')",
 "email IS NOT NULL"
 "email NOT LIKE '%.org'" (indication the email should not end with .org)
 "number NOT BETWEEN 99 AND 101"
 "name NOT IN ('admin', 'anonymous')"
 
Some special functions (not part of standard SQL, but most databases support them) can be used like:
 "LOWER(name) = 'admin'" (to also allow 'Admin' to be selected)
 "LENGTH(name) > 5" (to only select names longer then 5 characters)
 
Constraints can be linked together using AND and OR:
 "((number=100) OR (name='admin') AND email LIKE '%.org')"
 
The single quote can be escaped using it twice for every single occurence:
 "name='aaa''bbb'" (if we want to find the string aaa'bbb)
 
For more info consult a SQL tutorial like Jim Hoffman's introduction to Structured Query Language.

Parameters:
constraints - Constraints to prevent nodes from being included in the resulting list which would normally by included or null if no constraints should be applied .
orderby - A comma separated list of field names on which the returned list should be sorted or null if the order of the returned virtual nodes doesn't matter.
directions - A comma separated list of values indicating wether to sort up (ascending) or down (descending) on the corresponding field in the orderby parameter or null if sorting on all fields should be up. The value DOWN (case insensitive) indicates that sorting on the corresponding field should be down, all other values (including the empty value) indicate that sorting on the corresponding field should be up. If the number of values found in this parameter are less than the number of fields in the orderby parameter, all fields that don't have a corresponding direction value are sorted according to the last specified direction value.
Returns:
a list of nodes belonging to this node manager

createQuery

public NodeQuery createQuery()
Creates a query for this NodeNanager. The nodemanager is added as a step, and also all (non byte array) fields are added. The query can be used by getList of Cloud. You can not add steps to this NodeQuery.

Since:
MMBase-1.7
See Also:
getList(java.lang.String, java.lang.String, java.lang.String), Cloud.createNodeQuery()

getList

public NodeList getList(NodeQuery query)
Executes a query and returns the result as nodes of this NodeManager (or of extensions)

Since:
MMBase-1.7

getInfo

public java.lang.String getInfo(java.lang.String command)
Retrieve info from a node manager based on a command string. Similar to the $MOD command in SCAN.

Parameters:
command - the info to obtain, i.e. "USER-OS".

getInfo

public java.lang.String getInfo(java.lang.String command,
                                javax.servlet.ServletRequest req,
                                javax.servlet.ServletResponse resp)
Retrieve info from a node manager based on a command string Similar to the $MOD command in SCAN.

Parameters:
command - the info to obtain, i.e. "USER-OS".
req - the Request item to use for obtaining user information. For backward compatibility.
resp - the Response item to use for redirecting users. For backward compatibility.

getAllowedRelations

public RelationManagerList getAllowedRelations()
Retrieve all relation managers that can be used to create relations for objects of this nodemanager.

Returns:
the relation manager list
Since:
MMBase-1.6

getAllowedRelations

public RelationManagerList getAllowedRelations(java.lang.String nodeManager,
                                               java.lang.String role,
                                               java.lang.String direction)
Retrieve all relation managers that can be used to create relations for objects from this nodemanager, to the specified manager, using the specified role and direction.

Parameters:
nodeManager - the name of the nodemanger with which to make a relation, can be null
role - the role with which to make a relation, can be null
direction - the search direction ("source", "destination", "both"), can be null
Returns:
the relation manager list
Since:
MMBase-1.6

getAllowedRelations

public RelationManagerList getAllowedRelations(NodeManager nodeManager,
                                               java.lang.String role,
                                               java.lang.String direction)
Retrieve all relation managers that can be used to create relations for objects from this nodemanager, to the specified manager, using the specified role and direction.

Parameters:
nodeManager - the nodemanger with which to make a relation, can be null
role - the role with which to make a relation, can be null
direction - the search direction ("source", "destination", "both"), can be null
Returns:
the relation manager list
Since:
MMBase-1.6

getList

public NodeList getList(java.lang.String command,
                        java.util.Map parameters)
Retrieve info (as a list of virtual nodes) from a node manager based on a command string. Similar to the LIST command in SCAN. The values retrieved are represented as fields of a virtual node, named following the fieldnames listed in the fields paramaters..

Parameters:
command - the info to obtain, i.e. "USER-OS".
parameters - a hashtable containing the named parameters of the list.

getList

public NodeList getList(java.lang.String command,
                        java.util.Map parameters,
                        javax.servlet.ServletRequest req,
                        javax.servlet.ServletResponse resp)
Retrieve info from a node manager based on a command string Similar to the LIST command in SCAN. The values retrieved are represented as fields of a virtual node, named following the fieldnames listed in the fields paramaters..

Parameters:
command - the info to obtain, i.e. "USER-OS".
parameters - a hashtable containing the named parameters of the list.
req - the Request item to use for obtaining user information. For backward compatibility.
resp - the Response item to use for redirecting users. For backward compatibility.

mayCreateNode

public boolean mayCreateNode()
Check if the current user may create a new node of this type.

Returns:
Check if the current user may create a new node of this type.


MMBase build 1.7.1.20041002