org.odpi.openmetadata.commonservices.ocf.metadatamanagement.server

Class OCFMetadataRESTServices

java.lang.Object

org.odpi.openmetadata.commonservices.ocf.metadatamanagement.server.OCFMetadataRESTServices

public class OCFMetadataRESTServices
extends Object

The OCFMetadataRESTServices is the server-side implementation of the Connected Asset REST interface used by connectors.

Constructor Summary

Constructors

Constructor and Description
OCFMetadataRESTServices() Default constructor

Method Summary

Modifier and Type	Method and Description
CommentsResponse	getAssetCommentReplies(String serverName, String serviceURLName, String userId, String assetGUID, String commentGUID, int elementStart, int maxElements) Returns the list of replies to a comment.
CommentsResponse	getAssetComments(String serverName, String serviceURLName, String userId, String assetGUID, int elementStart, int maxElements) Returns the list of comments for the asset.
GUIDResponse	getAssetForConnectionGUID(String serverName, String serviceURLName, String userId, String connectionGUID) Returns the unique identifier for the asset connected to the connection.
AssetResponse	getAssetSummary(String serverName, String serviceURLName, String userId, String assetGUID) Returns the basic information about the asset.
CertificationsResponse	getCertifications(String serverName, String serviceURLName, String userId, String assetGUID, int elementStart, int maxElements) Returns the list of certifications for the asset.
AssetResponse	getConnectedAssetSummary(String serverName, String serviceURLName, String userId, String assetGUID, String connectionGUID) Returns the basic information about the asset.
ConnectionResponse	getConnectionByGUID(String serverName, String serviceURLName, String userId, String guid) Returns the connection object corresponding to the supplied connection GUID.
ConnectionResponse	getConnectionByName(String serverName, String serviceURLName, String userId, String name) Returns the connection object corresponding to the supplied connection name.
ConnectionResponse	getConnectionForAsset(String serverName, String serviceURLName, String userId, String assetGUID) Returns the connection corresponding to the supplied asset GUID.
ConnectionsResponse	getConnections(String serverName, String serviceURLName, String userId, String assetGUID, int elementStart, int maxElements) Returns the list of connections for the asset.
ExternalIdentifiersResponse	getExternalIdentifiers(String serverName, String serviceURLName, String userId, String assetGUID, int elementStart, int maxElements) Returns the list of external identifiers for the asset.
ExternalReferencesResponse	getExternalReferences(String serverName, String serviceURLName, String userId, String assetGUID, int elementStart, int maxElements) Returns the list of external references for the asset.
InformalTagsResponse	getInformalTags(String serverName, String serviceURLName, String userId, String assetGUID, int elementStart, int maxElements) Returns the list of informal tags for the asset.
LocationsResponse	getKnownLocations(String serverName, String serviceURLName, String userId, String assetGUID, int elementStart, int maxElements) Returns the list of known locations for the asset.
LicensesResponse	getLicenses(String serverName, String serviceURLName, String userId, String assetGUID, int elementStart, int maxElements) Returns the list of licenses for the asset.
LikesResponse	getLikes(String serverName, String serviceURLName, String userId, String assetGUID, int elementStart, int maxElements) Returns the list of likes for the asset.
MoreInformationResponse	getMoreInformation(String serverName, String serviceURLName, String userId, String elementGUID, int elementStart, int maxElements) Returns the list of related Referenceables that provide more information for this asset, schema, ...
NoteLogsResponse	getNoteLogs(String serverName, String serviceURLName, String userId, String assetGUID, int elementStart, int maxElements) Returns the list of note logs for the asset.
NotesResponse	getNotes(String serverName, String serviceURLName, String userId, String noteLogGUID, int elementStart, int maxElements) Returns the list of notes for a note log.
RatingsResponse	getRatings(String serverName, String serviceURLName, String userId, String assetGUID, int elementStart, int maxElements) Returns the list of ratings for the asset.
RelatedAssetsResponse	getRelatedAssets(String serverName, String serviceURLName, String userId, String assetGUID, int elementStart, int maxElements) Returns the list of related assets for the asset.
RelatedMediaReferencesResponse	getRelatedMediaReferences(String serverName, String serviceURLName, String userId, String assetGUID, int elementStart, int maxElements) Returns the list of related media references for the asset.
SchemaAttributesResponse	getSchemaAttributes(String serverName, String serviceURLName, String userId, String schemaTypeGUID, int elementStart, int maxElements) Returns a list of schema attributes for a schema type.

Methods inherited from class java.lang.Object

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

Constructor Detail

OCFMetadataRESTServices

public OCFMetadataRESTServices()

Default constructor

Method Detail

getConnectionByGUID

public ConnectionResponse getConnectionByGUID(String serverName,
                                              String serviceURLName,
                                              String userId,
                                              String guid)

Returns the connection object corresponding to the supplied connection GUID.

Parameters:

serverName - name of the server instances for this request

serviceURLName - String name of the service that created the connector that issued this request.

userId - userId of user making request.

guid - the unique id for the connection within the property server.

Returns:

connection object or InvalidParameterException - one of the parameters is null or invalid or UnrecognizedConnectionGUIDException - the supplied GUID is not recognized by the metadata repository or PropertyServerException - there is a problem retrieving information from the property (metadata) server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getConnectionByName

public ConnectionResponse getConnectionByName(String serverName,
                                              String serviceURLName,
                                              String userId,
                                              String name)

Returns the connection object corresponding to the supplied connection name.

Parameters:

serverName - name of the server instances for this request

serviceURLName - String name of the service that created the connector that issued this request.

userId - userId of user making request.

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

Returns:

connection object or InvalidParameterException - one of the parameters is null or invalid or UnrecognizedConnectionNameException - there is no connection defined for this name or AmbiguousConnectionNameException - there is more than one connection defined for this name or PropertyServerException - there is a problem retrieving information from the property (metadata) server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getAssetForConnectionGUID

public GUIDResponse getAssetForConnectionGUID(String serverName,
                                              String serviceURLName,
                                              String userId,
                                              String connectionGUID)

Returns the unique identifier for the asset connected to the connection.

Parameters:

serverName - name of the server instances for this request

serviceURLName - String name of the service that created the connector that issued this request.

userId - the userId of the requesting user.

connectionGUID - uniqueId for the connection.

Returns:

unique identifier of asset or InvalidParameterException - one of the parameters is null or invalid or PropertyServerException - there is a problem retrieving the connected asset properties from the property server or UnrecognizedConnectionGUIDException - the supplied GUID is not recognized by the property server or NoConnectedAssetException - there is no asset associated with this connection or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getConnectionForAsset

public ConnectionResponse getConnectionForAsset(String serverName,
                                                String serviceURLName,
                                                String userId,
                                                String assetGUID)

Returns the connection corresponding to the supplied asset GUID.

Parameters:

serverName - name of the server instances for this request

serviceURLName - String name of the service that created the connector that issued this request.

userId - userId of user making request.

assetGUID - the unique id for the asset within the metadata repository.

Returns:

connection object or InvalidParameterException one of the parameters is null or invalid or UnrecognizedConnectionNameException there is no connection defined for this name or PropertyServerException there is a problem retrieving information from the property (metadata) server or UserNotAuthorizedException the requesting user is not authorized to issue this request.

getConnectedAssetSummary

public AssetResponse getConnectedAssetSummary(String serverName,
                                              String serviceURLName,
                                              String userId,
                                              String assetGUID,
                                              String connectionGUID)

Returns the basic information about the asset. The connection guid allows the short description for the asset to be filled out.

Parameters:

serverName - name of the server.

serviceURLName - String name of the service that created the connector that issued this request.

userId - String userId of user making request.

assetGUID - String unique id for asset.

connectionGUID - unique id for connection used to access asset.

Returns:

a bean with the basic properties about the asset or InvalidParameterException - the asset GUID is null or invalid or UnrecognizedAssetGUIDException - the asset GUID is not recognized by the property server or UnrecognizedConnectionGUIDException - the connection GUID is not recognized by the property server or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException the requesting user is not authorized to issue this request.

getAssetSummary

public AssetResponse getAssetSummary(String serverName,
                                     String serviceURLName,
                                     String userId,
                                     String assetGUID)

Returns the basic information about the asset.

Parameters:

serverName - String name of server instance to call.

serviceURLName - String name of the service that created the connector that issued this request.

userId - String userId of user making request.

assetGUID - String unique id for asset.

Returns:

a bean with the basic properties about the asset or InvalidParameterException - the userId is null or invalid or UnrecognizedAssetGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getCertifications

public CertificationsResponse getCertifications(String serverName,
                                                String serviceURLName,
                                                String userId,
                                                String assetGUID,
                                                int elementStart,
                                                int maxElements)

Returns the list of certifications for the asset.

Parameters:

serverName - String name of server instance to call.

serviceURLName - String name of the service that created the connector that issued this request.

userId - String userId of user making request.

assetGUID - String unique id for asset.

elementStart - int starting position for fist returned element.

maxElements - int maximum number of elements to return on the call.

Returns:

a list of certifications or InvalidParameterException - the GUID is not recognized or the paging values are invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getAssetComments

public CommentsResponse getAssetComments(String serverName,
                                         String serviceURLName,
                                         String userId,
                                         String assetGUID,
                                         int elementStart,
                                         int maxElements)

Returns the list of comments for the asset.

Parameters:

serverName - String name of server instance to call.

serviceURLName - String name of the service that created the connector that issued this request.

userId - String userId of user making request.

assetGUID - String unique id for asset.

elementStart - int starting position for fist returned element.

maxElements - int maximum number of elements to return on the call.

Returns:

a list of comments or InvalidParameterException - the GUID is not recognized or the paging values are invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getAssetCommentReplies

public CommentsResponse getAssetCommentReplies(String serverName,
                                               String serviceURLName,
                                               String userId,
                                               String assetGUID,
                                               String commentGUID,
                                               int elementStart,
                                               int maxElements)

Returns the list of replies to a comment.

Parameters:

serverName - String name of server instance to call.

serviceURLName - String name of the service that created the connector that issued this request.

userId - String userId of user making request.

assetGUID - String unique id for asset.

commentGUID - String unique id for root comment.

elementStart - int starting position for fist returned element.

maxElements - int maximum number of elements to return on the call.

Returns:

a list of comments or InvalidParameterException - the GUID is not recognized or the paging values are invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getConnections

public ConnectionsResponse getConnections(String serverName,
                                          String serviceURLName,
                                          String userId,
                                          String assetGUID,
                                          int elementStart,
                                          int maxElements)

Returns the list of connections for the asset.

Parameters:

serverName - String name of server instance to call.

serviceURLName - String name of the service that created the connector that issued this request.

userId - String userId of user making request.

assetGUID - String unique id for asset.

elementStart - int starting position for fist returned element.

maxElements - int maximum number of elements to return on the call.

Returns:

a list of connections or InvalidParameterException - the GUID is not recognized or the paging values are invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getExternalIdentifiers

public ExternalIdentifiersResponse getExternalIdentifiers(String serverName,
                                                          String serviceURLName,
                                                          String userId,
                                                          String assetGUID,
                                                          int elementStart,
                                                          int maxElements)

Returns the list of external identifiers for the asset.

Parameters:

serverName - String name of server instance to call.

serviceURLName - String name of the service that created the connector that issued this request.

userId - String userId of user making request.

assetGUID - String unique id for asset.

elementStart - int starting position for fist returned element.

maxElements - int maximum number of elements to return on the call.

Returns:

a list of external identifiers or InvalidParameterException - the GUID is not recognized or the paging values are invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getExternalReferences

public ExternalReferencesResponse getExternalReferences(String serverName,
                                                        String serviceURLName,
                                                        String userId,
                                                        String assetGUID,
                                                        int elementStart,
                                                        int maxElements)

Returns the list of external references for the asset.

Parameters:

serverName - String name of server instance to call.

serviceURLName - String name of the service that created the connector that issued this request.

userId - String userId of user making request.

assetGUID - String unique id for asset.

elementStart - int starting position for fist returned element.

maxElements - int maximum number of elements to return on the call.

Returns:

a list of external references or InvalidParameterException - the GUID is not recognized or the paging values are invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getInformalTags

public InformalTagsResponse getInformalTags(String serverName,
                                            String serviceURLName,
                                            String userId,
                                            String assetGUID,
                                            int elementStart,
                                            int maxElements)

Returns the list of informal tags for the asset.

Parameters:

serverName - String name of server instance to call.

serviceURLName - String name of the service that created the connector that issued this request.

userId - String userId of user making request.

assetGUID - String unique id for asset.

elementStart - int starting position for fist returned element.

maxElements - int maximum number of elements to return on the call.

Returns:

a list of informal tags or InvalidParameterException - the GUID is not recognized or the paging values are invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getLicenses

public LicensesResponse getLicenses(String serverName,
                                    String serviceURLName,
                                    String userId,
                                    String assetGUID,
                                    int elementStart,
                                    int maxElements)

Returns the list of licenses for the asset.

Parameters:

serverName - String name of server instance to call.

serviceURLName - String name of the service that created the connector that issued this request.

userId - String userId of user making request.

assetGUID - String unique id for asset.

elementStart - int starting position for fist returned element.

maxElements - int maximum number of elements to return on the call.

Returns:

a list of licenses or InvalidParameterException - the GUID is not recognized or the paging values are invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getLikes

public LikesResponse getLikes(String serverName,
                              String serviceURLName,
                              String userId,
                              String assetGUID,
                              int elementStart,
                              int maxElements)

Returns the list of likes for the asset.

Parameters:

serverName - String name of server instance to call.

serviceURLName - String name of the service that created the connector that issued this request.

userId - String userId of user making request.

assetGUID - String unique id for asset.

elementStart - int starting position for fist returned element.

maxElements - int maximum number of elements to return on the call.

Returns:

a list of likes or InvalidParameterException - the GUID is not recognized or the paging values are invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getKnownLocations

public LocationsResponse getKnownLocations(String serverName,
                                           String serviceURLName,
                                           String userId,
                                           String assetGUID,
                                           int elementStart,
                                           int maxElements)

Returns the list of known locations for the asset.

Parameters:

serverName - String name of server instance to call.

serviceURLName - String name of the service that created the connector that issued this request.

userId - String userId of user making request.

assetGUID - String unique id for asset.

elementStart - int starting position for fist returned element.

maxElements - int maximum number of elements to return on the call.

Returns:

a list of known locations or InvalidParameterException - the GUID is not recognized or the paging values are invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getNoteLogs

public NoteLogsResponse getNoteLogs(String serverName,
                                    String serviceURLName,
                                    String userId,
                                    String assetGUID,
                                    int elementStart,
                                    int maxElements)

Returns the list of note logs for the asset.

Parameters:

serverName - String name of server instance to call.

serviceURLName - String name of the service that created the connector that issued this request.

userId - String userId of user making request.

assetGUID - String unique id for asset.

elementStart - int starting position for fist returned element.

maxElements - int maximum number of elements to return on the call.

Returns:

a list of note logs or InvalidParameterException - the GUID is not recognized or the paging values are invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getNotes

public NotesResponse getNotes(String serverName,
                              String serviceURLName,
                              String userId,
                              String noteLogGUID,
                              int elementStart,
                              int maxElements)

Returns the list of notes for a note log.

Parameters:

serverName - String name of server instance to call.

serviceURLName - String name of the service that created the connector that issued this request.

userId - String userId of user making request.

noteLogGUID - String unique id for the note log.

elementStart - int starting position for fist returned element.

maxElements - int maximum number of elements to return on the call.

Returns:

a list of notes or InvalidParameterException - the GUID is not recognized or the paging values are invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getRatings

public RatingsResponse getRatings(String serverName,
                                  String serviceURLName,
                                  String userId,
                                  String assetGUID,
                                  int elementStart,
                                  int maxElements)

Returns the list of ratings for the asset.

Parameters:

serverName - String name of server instance to call.

serviceURLName - String name of the service that created the connector that issued this request.

userId - String userId of user making request.

assetGUID - String unique id for asset.

elementStart - int starting position for fist returned element.

maxElements - int maximum number of elements to return on the call.

Returns:

a list of ratings or InvalidParameterException - the GUID is not recognized or the paging values are invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getRelatedAssets

public RelatedAssetsResponse getRelatedAssets(String serverName,
                                              String serviceURLName,
                                              String userId,
                                              String assetGUID,
                                              int elementStart,
                                              int maxElements)

Returns the list of related assets for the asset.

Parameters:

serverName - String name of server instance to call.

serviceURLName - String name of the service that created the connector that issued this request.

userId - String userId of user making request.

assetGUID - String unique id for asset.

elementStart - int starting position for fist returned element.

maxElements - int maximum number of elements to return on the call.

Returns:

a list of assets or InvalidParameterException - the GUID is not recognized or the paging values are invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getMoreInformation

public MoreInformationResponse getMoreInformation(String serverName,
                                                  String serviceURLName,
                                                  String userId,
                                                  String elementGUID,
                                                  int elementStart,
                                                  int maxElements)

Returns the list of related Referenceables that provide more information for this asset, schema, ...

Parameters:

serverName - String name of server instance to call.

serviceURLName - String name of the service that created the connector that issued this request.

userId - String userId of user making request.

elementGUID - String unique id for the element.

elementStart - int starting position for fist returned element.

maxElements - int maximum number of elements to return on the call.

Returns:

a list of related assets or InvalidParameterException - the GUID is not recognized or the paging values are invalid or UnrecognizedAssetGUIDException - the GUID is null or invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getRelatedMediaReferences

public RelatedMediaReferencesResponse getRelatedMediaReferences(String serverName,
                                                                String serviceURLName,
                                                                String userId,
                                                                String assetGUID,
                                                                int elementStart,
                                                                int maxElements)

Returns the list of related media references for the asset.

Parameters:

serverName - String name of server instance to call.

serviceURLName - String name of the service that created the connector that issued this request.

userId - String userId of user making request.

assetGUID - String unique id for asset.

elementStart - int starting position for fist returned element.

maxElements - int maximum number of elements to return on the call.

Returns:

a list of related media references or InvalidParameterException - the GUID is not recognized or the paging values are invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getSchemaAttributes

public SchemaAttributesResponse getSchemaAttributes(String serverName,
                                                    String serviceURLName,
                                                    String userId,
                                                    String schemaTypeGUID,
                                                    int elementStart,
                                                    int maxElements)

Returns a list of schema attributes for a schema type.

Parameters:

serverName - String name of server instance to call.

serviceURLName - String name of the service that created the connector that issued this request.

userId - String userId of user making request.

schemaTypeGUID - String unique id for containing schema type.

elementStart - int starting position for fist returned element.

maxElements - int maximum number of elements to return on the call.

Returns:

a schema attributes response or InvalidParameterException - the GUID is not recognized or the paging values are invalid or PropertyServerException - there is a problem retrieving the asset properties from the property server or UserNotAuthorizedException - the requesting user is not authorized to issue this request.