org.odpi.openmetadata.accessservices.assetconsumer.server

Class AssetConsumerRESTServices

java.lang.Object

org.odpi.openmetadata.accessservices.assetconsumer.server.AssetConsumerRESTServices

public class AssetConsumerRESTServices
extends Object

The AssetConsumerRESTServices provides the server-side implementation of the Asset Consumer Open Metadata Assess Service (OMAS). This interface provides connections to assets and APIs for adding feedback on the asset.

Constructor Summary

Constructors

Constructor and Description
AssetConsumerRESTServices() Default constructor

Method Summary

Modifier and Type	Method and Description
GUIDResponse	addCommentReply(String serverName, String userId, String commentGUID, CommentRequestBody requestBody) Adds a reply to a comment.
GUIDResponse	addCommentToAsset(String serverName, String userId, String guid, CommentRequestBody requestBody) Adds a comment to the asset.
GUIDResponse	addLikeToAsset(String serverName, String userId, String guid, NullRequestBody requestBody) Adds a "Like" to the asset.
VoidResponse	addLogMessageToAsset(String serverName, String userId, String guid, LogRecordRequestBody requestBody) Creates an Audit log record for the asset.
GUIDResponse	addReviewToAsset(String serverName, String userId, String guid, ReviewRequestBody requestBody) Adds a star rating and optional review text to the asset.
VoidResponse	addTagToAsset(String serverName, String userId, String assetGUID, String tagGUID, NullRequestBody requestBody) Adds a tag (either private of public) to an asset.
GUIDResponse	createPrivateTag(String serverName, String userId, TagRequestBody requestBody) Creates a new private informal tag and returns the unique identifier for it.
GUIDResponse	createPublicTag(String serverName, String userId, TagRequestBody requestBody) Creates a new public informal tag and returns the unique identifier for it.
VoidResponse	deleteTag(String serverName, String userId, String tagGUID, NullRequestBody requestBody) Removes a tag from the repository.
GUIDResponse	getAssetForConnection(String serverName, String userId, String connectionGUID) Returns the unique identifier for the asset connected to the connection.
ConnectionResponse	getConnectionByGUID(String serverName, String userId, String guid) Returns the connection object corresponding to the supplied connection GUID.
ConnectionResponse	getConnectionByName(String serverName, String userId, String name) Returns the connection object corresponding to the supplied connection name.
MeaningResponse	getMeaning(String serverName, String userId, String guid) Return the full definition (meaning) of a term using the unique identifier of the glossary term.
MeaningListResponse	getMeaningByName(String serverName, String userId, String term, int startFrom, int pageSize) Return the full definition (meaning) of the terms matching the supplied name.
TagResponse	getTag(String serverName, String userId, String guid) Return the tag for the supplied unique identifier (guid).
TagListResponse	getTagsByName(String serverName, String userId, String tagName, int startFrom, int pageSize) Return the list of tags matching the supplied name.
VoidResponse	removeCommentFromAsset(String serverName, String userId, String guid, NullRequestBody requestBody) Removes a comment added to the asset by this user.
VoidResponse	removeLikeFromAsset(String serverName, String userId, String guid, NullRequestBody requestBody) Removes a "Like" added to the asset by this user.
VoidResponse	removeReviewFromAsset(String serverName, String userId, String guid, NullRequestBody requestBody) Removes a star rating that was added to the asset by this user.
VoidResponse	removeTagFromAsset(String serverName, String userId, String assetGUID, String tagGUID, NullRequestBody requestBody) Removes a tag from the asset that was added by this user.
VoidResponse	updateComment(String serverName, String userId, String guid, CommentRequestBody requestBody) Update an existing comment.
VoidResponse	updateReviewOnAsset(String serverName, String userId, String guid, ReviewRequestBody requestBody) Updates the rating and optional review text attached to the asset by this user.
VoidResponse	updateTagDescription(String serverName, String userId, String tagGUID, TagRequestBody requestBody) Updates the description of an existing tag (either private of public).

Methods inherited from class java.lang.Object

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

Constructor Detail

AssetConsumerRESTServices

public AssetConsumerRESTServices()

Default constructor

Method Detail

getAssetForConnection

public GUIDResponse getAssetForConnection(String serverName,
                                          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

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.

getConnectionByName

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

Returns the connection object corresponding to the supplied connection name.

Parameters:

serverName - name of the server instances for 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.

getConnectionByGUID

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

Returns the connection object corresponding to the supplied connection GUID.

Parameters:

serverName - name of the server instances for 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.

addReviewToAsset

public GUIDResponse addReviewToAsset(String serverName,
                                     String userId,
                                     String guid,
                                     ReviewRequestBody requestBody)

Adds a star rating and optional review text to the asset.

Parameters:

serverName - name of the server instances for this request

userId - String - userId of user making request.

guid - String - unique id for the asset.

requestBody - containing the StarRating and user review of asset.

Returns:

guid of new review object or InvalidParameterException - one of the parameters is null or invalid or PropertyServerException - there is a problem adding the asset properties to the metadata repository or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

updateReviewOnAsset

public VoidResponse updateReviewOnAsset(String serverName,
                                        String userId,
                                        String guid,
                                        ReviewRequestBody requestBody)

Updates the rating and optional review text attached to the asset by this user.

Parameters:

userId - userId of user making request.

guid - unique identifier for the review.

requestBody - provides the StarRating enumeration for none, one to five stars plus optional review test.

Returns:

void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException There is a problem updating the asset properties in the metadata repository. UserNotAuthorizedException the requesting user is not authorized to issue this request.

removeReviewFromAsset

public VoidResponse removeReviewFromAsset(String serverName,
                                          String userId,
                                          String guid,
                                          NullRequestBody requestBody)

Removes a star rating that was added to the asset by this user.

Parameters:

serverName - name of the server instances for this request

userId - String - userId of user making request.

guid - String - unique id for the rating object

requestBody - null request body needed to satisfy the HTTP Post request

Returns:

void or InvalidParameterException - one of the parameters is null or invalid or PropertyServerException - there is a problem updating the asset properties in the metadata repository or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

addLikeToAsset

public GUIDResponse addLikeToAsset(String serverName,
                                   String userId,
                                   String guid,
                                   NullRequestBody requestBody)

Adds a "Like" to the asset.

Parameters:

serverName - name of the server instances for this request

userId - String - userId of user making request.

guid - String - unique id for the asset.

requestBody - null request body to satisfy HTTP protocol.

Returns:

guid of new like or InvalidParameterException - one of the parameters is null or invalid or PropertyServerException - there is a problem adding the asset properties to the metadata repository or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

removeLikeFromAsset

public VoidResponse removeLikeFromAsset(String serverName,
                                        String userId,
                                        String guid,
                                        NullRequestBody requestBody)

Removes a "Like" added to the asset by this user.

Parameters:

serverName - name of the server instances for this request

userId - String - userId of user making request.

guid - String - unique id for the like object

requestBody - null request body needed to satisfy the HTTP Post request

Returns:

void or InvalidParameterException - one of the parameters is null or invalid or PropertyServerException - there is a problem updating the asset properties in the metadata repository or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

addCommentToAsset

public GUIDResponse addCommentToAsset(String serverName,
                                      String userId,
                                      String guid,
                                      CommentRequestBody requestBody)

Adds a comment to the asset.

Parameters:

serverName - name of the server instances for this request

userId - String - userId of user making request.

guid - String - unique id for the asset.

requestBody - containing type of comment enum and the text of the comment.

Returns:

guid for new comment object or InvalidParameterException - one of the parameters is null or invalid or PropertyServerException - there is a problem adding the asset properties to the metadata repository or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

addCommentReply

public GUIDResponse addCommentReply(String serverName,
                                    String userId,
                                    String commentGUID,
                                    CommentRequestBody requestBody)

Adds a reply to a comment.

Parameters:

serverName - name of the server instances for this request

userId - String - userId of user making request.

commentGUID - String - unique id for an existing comment. Used to add a reply to a comment.

requestBody - containing type of comment enum and the text of the comment.

Returns:

guid for new comment object or InvalidParameterException - one of the parameters is null or invalid or PropertyServerException - there is a problem adding the asset properties to the metadata repository or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

updateComment

public VoidResponse updateComment(String serverName,
                                  String userId,
                                  String guid,
                                  CommentRequestBody requestBody)

Update an existing comment.

Parameters:

serverName - name of the server instances for this request.

userId - userId of user making request.

guid - unique identifier for the comment to change.

requestBody - containing type of comment enum and the text of the comment.

Returns:

void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException There is a problem updating the asset properties in the metadata repository. UserNotAuthorizedException the requesting user is not authorized to issue this request.

removeCommentFromAsset

public VoidResponse removeCommentFromAsset(String serverName,
                                           String userId,
                                           String guid,
                                           NullRequestBody requestBody)

Removes a comment added to the asset by this user.

Parameters:

serverName - name of the server instances for this request

userId - String - userId of user making request.

guid - String - unique id for the comment object

requestBody - null request body needed to satisfy the HTTP Post request

Returns:

void or InvalidParameterException - one of the parameters is null or invalid or PropertyServerException - there is a problem updating the asset properties in the metadata repository or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getMeaning

public MeaningResponse getMeaning(String serverName,
                                  String userId,
                                  String guid)

Return the full definition (meaning) of a term using the unique identifier of the glossary term.

Parameters:

serverName - name of the server instances for this request

userId - userId of the user making the request.

guid - unique identifier of the meaning.

Returns:

glossary term object or InvalidParameterException the userId is null or invalid or NoProfileForUserException the user does not have a profile or PropertyServerException there is a problem retrieving information from the property server(s) or UserNotAuthorizedException the requesting user is not authorized to issue this request.

getMeaningByName

public MeaningListResponse getMeaningByName(String serverName,
                                            String userId,
                                            String term,
                                            int startFrom,
                                            int pageSize)

Return the full definition (meaning) of the terms matching the supplied name.

Parameters:

serverName - name of the server instances for this request

userId - the name of the calling user.

term - name of term. This may include wild card characters.

startFrom - index of the list ot start from (0 for start)

pageSize - maximum number of elements to return.

Returns:

list of glossary terms or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

addLogMessageToAsset

public VoidResponse addLogMessageToAsset(String serverName,
                                         String userId,
                                         String guid,
                                         LogRecordRequestBody requestBody)

Creates an Audit log record for the asset. This log record is stored in the Asset's Audit Log.

Parameters:

serverName - name of the server instances for this request

userId - String - userId of user making request.

guid - String - unique id for the asset.

requestBody - containing: connectorInstanceId (String - (optional) id of connector in use (if any)), connectionName (String - (optional) name of the connection (extracted from the connector)), connectorType (String - (optional) type of connector in use (if any)), contextId (String - (optional) function name, or processId of the activity that the caller is performing), message (log record content).

Returns:

void or InvalidParameterException - one of the parameters is null or invalid or PropertyServerException - there is a problem adding the log message to the audit log for this asset or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

createPublicTag

public GUIDResponse createPublicTag(String serverName,
                                    String userId,
                                    TagRequestBody requestBody)

Creates a new public informal tag and returns the unique identifier for it.

Parameters:

serverName - name of the server instances for this request

userId - userId of user making request.

requestBody - contains the name of the tag and (optional) description of the tag.

Returns:

guid for new tag or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

createPrivateTag

public GUIDResponse createPrivateTag(String serverName,
                                     String userId,
                                     TagRequestBody requestBody)

Creates a new private informal tag and returns the unique identifier for it.

Parameters:

serverName - name of the server instances for this request

userId - userId of user making request.

requestBody - contains the name of the tag and (optional) description of the tag.

Returns:

guid for new tag or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

updateTagDescription

public VoidResponse updateTagDescription(String serverName,
                                         String userId,
                                         String tagGUID,
                                         TagRequestBody requestBody)

Updates the description of an existing tag (either private of public).

Parameters:

serverName - name of the server instances for this request

userId - userId of user making request.

tagGUID - unique id for the tag.

requestBody - contains the name of the tag and (optional) description of the tag.

Returns:

void or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

deleteTag

public VoidResponse deleteTag(String serverName,
                              String userId,
                              String tagGUID,
                              NullRequestBody requestBody)

Removes a tag from the repository. All of the relationships to assets are lost.

Parameters:

serverName - name of the server instances for this request

userId - userId of user making request.

tagGUID - unique id for the tag.

requestBody - null request body.

Returns:

void or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getTag

public TagResponse getTag(String serverName,
                          String userId,
                          String guid)

Return the tag for the supplied unique identifier (guid).

Parameters:

serverName - name of the server instances for this request

userId - userId of the user making the request.

guid - unique identifier of the tag.

Returns:

Tag object or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getTagsByName

public TagListResponse getTagsByName(String serverName,
                                     String userId,
                                     String tagName,
                                     int startFrom,
                                     int pageSize)

Return the list of tags matching the supplied name.

Parameters:

serverName - name of the server instances for this request

userId - the name of the calling user.

tagName - name of tag. This may include wild card characters.

startFrom - index of the list ot start from (0 for start)

pageSize - maximum number of elements to return.

Returns:

tag list or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

addTagToAsset

public VoidResponse addTagToAsset(String serverName,
                                  String userId,
                                  String assetGUID,
                                  String tagGUID,
                                  NullRequestBody requestBody)

Adds a tag (either private of public) to an asset.

Parameters:

serverName - name of the server instances for this request

userId - userId of user making request.

assetGUID - unique id for the asset.

tagGUID - unique id of the tag.

requestBody - null request body needed for correct protocol exchange.

Returns:

void or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.

removeTagFromAsset

public VoidResponse removeTagFromAsset(String serverName,
                                       String userId,
                                       String assetGUID,
                                       String tagGUID,
                                       NullRequestBody requestBody)

Removes a tag from the asset that was added by this user.

Parameters:

serverName - name of the server instances for this request

userId - userId of user making request.

assetGUID - unique id for the asset.

tagGUID - unique id for the tag.

requestBody - null request body needed for correct protocol exchange.

Returns:

void or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.