org.odpi.openmetadata.commonservices.ocf.metadatamanagement.handlers

Class ConnectionHandler

java.lang.Object

org.odpi.openmetadata.commonservices.ocf.metadatamanagement.handlers.AttachmentHandlerBase

org.odpi.openmetadata.commonservices.ocf.metadatamanagement.handlers.ConnectionHandler

public class ConnectionHandler
extends AttachmentHandlerBase

ConnectionHandler retrieves Connection objects from the property server. It runs server-side in the the OMAG Server Platform and retrieves Connections through the OMRSRepositoryConnector.

Field Summary

Fields inherited from class org.odpi.openmetadata.commonservices.ocf.metadatamanagement.handlers.AttachmentHandlerBase

invalidParameterHandler, lastAttachmentHandler, repositoryHandler, repositoryHelper, serverName, serviceName

Constructor Summary

Constructors

Constructor and Description
ConnectionHandler(String serviceName, String serverName, InvalidParameterHandler invalidParameterHandler, RepositoryHandler repositoryHandler, OMRSRepositoryHelper repositoryHelper, LastAttachmentHandler lastAttachmentHandler) Construct the connection handler with information needed to work with Connection objects.

Method Summary

Modifier and Type	Method and Description
int	countAttachedConnections(String userId, String anchorGUID, String methodName) Count the number of connection attached to an anchor asset.
Connection	getConnection(String userId, String connectionGUID) Retrieve the requested connection object.
Connection	getConnectionByName(String userId, String name, String methodName) Returns the connection object corresponding to the supplied connection name.
List<Connection>	getConnections(String userId, String anchorGUID, int startingFrom, int pageSize, String methodName) Return the connections attached to an anchor entity.
void	removeConnection(String userId, String connectionGUID) Remove the requested Connection and any associated objects if they are no longer connected to anything else.
String	saveConnection(String userId, Connection connection) Determine if the Connection object is stored in the repository and create it if it is not.
void	setSecurityVerifier(OpenMetadataServerSecurityVerifier securityVerifier) Set up a new security verifier (the handler runs with a default verifier until this method is called).

Methods inherited from class org.odpi.openmetadata.commonservices.ocf.metadatamanagement.handlers.AttachmentHandlerBase

countAttachments, getAttachmentLinks, getAttachments

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ConnectionHandler

public ConnectionHandler(String serviceName,
                         String serverName,
                         InvalidParameterHandler invalidParameterHandler,
                         RepositoryHandler repositoryHandler,
                         OMRSRepositoryHelper repositoryHelper,
                         LastAttachmentHandler lastAttachmentHandler)

Construct the connection handler with information needed to work with Connection objects.

Parameters:

serviceName - name of this service

serverName - name of the local server

invalidParameterHandler - handler for managing parameter errors

repositoryHandler - handler for interfacing with the repository services

repositoryHelper - helper utilities for managing repository services objects

lastAttachmentHandler - handler for recording last attachment

Method Detail

setSecurityVerifier

public void setSecurityVerifier(OpenMetadataServerSecurityVerifier securityVerifier)

Set up a new security verifier (the handler runs with a default verifier until this method is called). The security verifier provides authorization checks for access and maintenance changes to open metadata. Authorization checks are enabled through the OpenMetadataServerSecurityConnector.

Parameters:

securityVerifier - new security verifier

countAttachedConnections

public int countAttachedConnections(String userId,
                                    String anchorGUID,
                                    String methodName)
                             throws InvalidParameterException,
                                    PropertyServerException,
                                    UserNotAuthorizedException

Count the number of connection attached to an anchor asset.

Parameters:

userId - calling user

anchorGUID - identifier for the entity that the object is attached to

methodName - calling method

Returns:

count of attached objects

Throws:

InvalidParameterException - the parameters are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

getConnections

public List<Connection> getConnections(String userId,
                                       String anchorGUID,
                                       int startingFrom,
                                       int pageSize,
                                       String methodName)
                                throws InvalidParameterException,
                                       PropertyServerException,
                                       UserNotAuthorizedException

Return the connections attached to an anchor entity.

Parameters:

userId - calling user

anchorGUID - identifier for the entity that the feedback is attached to

startingFrom - where to start from in the list

pageSize - maximum number of results that can be returned

methodName - calling method

Returns:

list of connections

Throws:

InvalidParameterException - the input properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

saveConnection

public String saveConnection(String userId,
                             Connection connection)
                      throws InvalidParameterException,
                             PropertyServerException,
                             UserNotAuthorizedException

Determine if the Connection object is stored in the repository and create it if it is not. If the connection is located, there is no check that the connection values are equal to those in the supplied object.

Parameters:

userId - calling userId

connection - object to add

Returns:

unique identifier of the connection in the repository.

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

removeConnection

public void removeConnection(String userId,
                             String connectionGUID)
                      throws InvalidParameterException,
                             PropertyServerException,
                             UserNotAuthorizedException

Remove the requested Connection and any associated objects if they are no longer connected to anything else.

Parameters:

userId - calling user

connectionGUID - object to delete

Throws:

InvalidParameterException - the entity guid is not known

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

getConnection

public Connection getConnection(String userId,
                                String connectionGUID)
                         throws InvalidParameterException,
                                PropertyServerException,
                                UserNotAuthorizedException

Retrieve the requested connection object.

Parameters:

userId - calling user

connectionGUID - unique identifier of the connection object.

Returns:

Connection bean

Throws:

InvalidParameterException - the parameters are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

getConnectionByName

public Connection getConnectionByName(String userId,
                                      String name,
                                      String methodName)
                               throws InvalidParameterException,
                                      PropertyServerException,
                                      UserNotAuthorizedException

Returns the connection object corresponding to the supplied connection name.

Parameters:

userId - String - userId of user making request.

name - this may be the qualifiedName or displayName of the connection.

methodName - calling method

Returns:

Connection retrieved from property server

Throws:

InvalidParameterException - one of the parameters is null or invalid.

PropertyServerException - there is a problem retrieving information from the property (metadata) server.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.