Sirius.server.middleware.interfaces.proxy

Interface CatalogueService

All Superinterfaces:

Remote

All Known Subinterfaces:

CallServerService

All Known Implementing Classes:

CatalogueServiceImpl, DomainServerCallServerService, ProxyImpl, RESTfulInterfaceConnector, RESTfulSerialInterfaceConnector

public interface CatalogueService
extends Remote

Interface for operations on the systems catalogue.

Version:

$Revision$, $Date$

Method Summary

Modifier and Type	Method and Description
boolean	addLink(Node from, Node to, User user) Deprecated.
boolean	addLink(Node from, Node to, User user, de.cismet.connectioncontext.ConnectionContext context) links 2 existing nodes.
Node	addNode(Node node, Link parent, User user) Deprecated.
Node	addNode(Node node, Link parent, User user, de.cismet.connectioncontext.ConnectionContext context) enables User to add a node to the catalogue if User has sufficient permissions the new node will inherit all permissions from the parent node referenced by the parent parameter.
boolean	deleteLink(Node from, Node to, User user) Deprecated.
boolean	deleteLink(Node from, Node to, User user, de.cismet.connectioncontext.ConnectionContext context) removes the link between a parent and a child node.
boolean	deleteNode(Node node, User user) Deprecated.
boolean	deleteNode(Node node, User user, de.cismet.connectioncontext.ConnectionContext context) deletes a certain node and all the references to it on the domain where the node is hosted.
Node[]	getChildren(Node node, User usr) Deprecated.
Node[]	getChildren(Node node, User usr, de.cismet.connectioncontext.ConnectionContext context) delivers all nodes referenced from nodeId visible for usr.
Node[]	getRoots(User user) Deprecated.
Node[]	getRoots(User user, de.cismet.connectioncontext.ConnectionContext context) delivers root nodes of all servers online, if a server knows this user.
Node[]	getRoots(User user, String domainName) Deprecated.
Node[]	getRoots(User user, String domainName, de.cismet.connectioncontext.ConnectionContext context) delivers root nodes of this server, if the server knows this user.

Method Detail

getRoots

@Deprecated
Node[] getRoots(User user,
                            String domainName)
                     throws RemoteException

Deprecated.

retrieves all by this user accessible rootNodes of one localserver.

Parameters:

user - DOCUMENT ME!

domainName - DOCUMENT ME!

Returns:

DOCUMENT ME!

Throws:

RemoteException - DOCUMENT ME!

getRoots

Node[] getRoots(User user,
                String domainName,
                de.cismet.connectioncontext.ConnectionContext context)
         throws RemoteException

delivers root nodes of this server, if the server knows this user.

Parameters:

user - Usertoken 2 b checked by server, if the user exists on this server the roots are returned

domainName - server name

context - DOCUMENT ME!

Returns:

all root nodes of a certain server

Throws:

RemoteException - server failure or wrong user token

getRoots

@Deprecated
Node[] getRoots(User user)
                     throws RemoteException

Deprecated.

retrieves all by this user accessible rootNodes.

Parameters:

user - DOCUMENT ME!

Returns:

DOCUMENT ME!

Throws:

RemoteException - DOCUMENT ME!

getRoots

Node[] getRoots(User user,
                de.cismet.connectioncontext.ConnectionContext context)
         throws RemoteException

delivers root nodes of all servers online, if a server knows this user.

Parameters:

user - user token

context - DOCUMENT ME!

Returns:

all rootnodes available from servers online

Throws:

RemoteException - server error or wrong user token

getChildren

@Deprecated
Node[] getChildren(Node node,
                               User usr)
                        throws RemoteException

Deprecated.

DOCUMENT ME!

Parameters:

node - DOCUMENT ME!

usr - DOCUMENT ME!

Returns:

DOCUMENT ME!

Throws:

RemoteException - DOCUMENT ME!

getChildren

Node[] getChildren(Node node,
                   User usr,
                   de.cismet.connectioncontext.ConnectionContext context)
            throws RemoteException

delivers all nodes referenced from nodeId visible for usr.

Parameters:

node - id of the parent node

usr - user token to be able to check permission and deliver user tailored views

context - DOCUMENT ME!

Returns:

all children of this parent visible for this user

Throws:

RemoteException - server error

addNode

@Deprecated
Node addNode(Node node,
                         Link parent,
                         User user)
                  throws RemoteException

Deprecated.

delivers a list of all nodes referencing this child node on this server.

Parameters:

node - usr user token

parent - nodeID child node

user - domain domain that hosts this child

Returns:

a list of all nodes referencing this child node on this server

Throws:

RemoteException - server error

addNode

Node addNode(Node node,
             Link parent,
             User user,
             de.cismet.connectioncontext.ConnectionContext context)
      throws RemoteException

enables User to add a node to the catalogue if User has sufficient permissions the new node will inherit all permissions from the parent node referenced by the parent parameter.

Parameters:

node - new node

parent - reference to the parent node in the catalogue

user - user adding this node,

context - DOCUMENT ME!

Returns:

returns the node succesfully added

Throws:

RemoteException - server error

deleteNode

@Deprecated
boolean deleteNode(Node node,
                               User user)
                        throws RemoteException

Deprecated.

DOCUMENT ME!

Parameters:

node - DOCUMENT ME!

user - DOCUMENT ME!

Returns:

DOCUMENT ME!

Throws:

RemoteException - DOCUMENT ME!

deleteNode

boolean deleteNode(Node node,
                   User user,
                   de.cismet.connectioncontext.ConnectionContext context)
            throws RemoteException

deletes a certain node and all the references to it on the domain where the node is hosted.

Parameters:

node - node to be deleted

user - the user deleting this node

context - DOCUMENT ME!

Returns:

whether the node was succesfully deleted

Throws:

RemoteException - server error eg unsufficient permissions

addLink

@Deprecated
boolean addLink(Node from,
                            Node to,
                            User user)
                     throws RemoteException

Deprecated.

DOCUMENT ME!

Parameters:

from - DOCUMENT ME!

to - DOCUMENT ME!

user - DOCUMENT ME!

Returns:

DOCUMENT ME!

Throws:

RemoteException - DOCUMENT ME!

addLink

boolean addLink(Node from,
                Node to,
                User user,
                de.cismet.connectioncontext.ConnectionContext context)
         throws RemoteException

links 2 existing nodes.

Parameters:

from - parent

to - child

user - user token 2 b checked for sufficient permissions for this action

context - DOCUMENT ME!

Returns:

whether the linking of the nodes worked

Throws:

RemoteException - server error eg one node does not exist

deleteLink

@Deprecated
boolean deleteLink(Node from,
                               Node to,
                               User user)
                        throws RemoteException

Deprecated.

DOCUMENT ME!

Parameters:

from - DOCUMENT ME!

to - DOCUMENT ME!

user - DOCUMENT ME!

Returns:

DOCUMENT ME!

Throws:

RemoteException - DOCUMENT ME!

deleteLink

boolean deleteLink(Node from,
                   Node to,
                   User user,
                   de.cismet.connectioncontext.ConnectionContext context)
            throws RemoteException

removes the link between a parent and a child node.

Parameters:

from - parent

to - child

user - user token 2 b checked for sufficient permissions for this action

context - DOCUMENT ME!

Returns:

whether the action was completed successfully

Throws:

RemoteException - server error eg the link and/or the corresponding nodes do not exist