org.odpi.openmetadata.accessservice.assetcatalog.client

Class AssetCatalog

java.lang.Object

org.odpi.openmetadata.accessservice.assetcatalog.client.AssetCatalog

All Implemented Interfaces:

AssetCatalogInterface

public class AssetCatalog
extends Object
implements AssetCatalogInterface

The Asset Catalog Open Metadata Access Service (OMAS) provides an interface to search for assets including data stores, event feeds, APIs and data sets, related assets and relationships. Also, it can return the connection details for the asset metadata. The Asset Catalog OMAS includes:

• Client-side provides language-specific client packages to make it easier for data tools and applications to call the interface.
• OMAS Server calls to retrieve assets and information related to the assets.

Constructor Summary

Constructors

Constructor and Description
AssetCatalog(String newServerURL) Create a new AssetConsumer client.

Method Summary

Modifier and Type	Method and Description
AssetDescriptionResponse	getAssetDetails(String userId, String assetId) Fetch asset's header, classification and properties
RelationshipsResponse	getAssetRelationships(String userId, String assetId) Fetch the relationships for a specific asset
AssetDescriptionResponse	getAssetsByClassificationName(String userId, String classificationName) Fetch the assets that match the classification name
AssetDescriptionResponse	getAssetsByProperty(String userId, String propertyValue) Fetch the assets that match the properties
AssetDescriptionResponse	getAssetsFromNeighborhood(String userId, String assetId) Returns the sub-graph that represents the returned linked relationships.
AssetDescriptionResponse	getAssetSummary(String userId, String assetId) Fetch asset's header and classification
AssetDescriptionResponse	getAssetUniverse(String userId, String assetId) Fetch asset's header, classification, properties and relationships
ClassificationsResponse	getClassificationForAsset(String userId, String assetId) Fetch the classification for a specific asset
AssetDescriptionResponse	getLastCreatedAssets(String userId) Returns the last created assets
AssetDescriptionResponse	getLastUpdatedAssets(String userId) Returns the last updated assets
AssetDescriptionResponse	getLinkingAssets(String userId, String startAssetId, String endAssetId) Returns a sub-graph of intermediate assets that connected two assets
RelationshipsResponse	getLinkingRelationships(String userId, String startAssetId, String endAssetId) Return a sub-graph of relationships that connect two assets
AssetDescriptionResponse	getRelatedAssets(String userId, String assetId) Return the list of assets that are of the types listed in instanceTypes and are connected, either directly or indirectly to the asset identified by assetId.
RelationshipsResponse	getRelationship(String userId, String relationshipId) Fetch relationship details based on its unique identifier
RelationshipsResponse	getRelationshipByLabel(String userId, String propertyName) Fetch relationship details based on property name
RelationshipsResponse	getRelationshipsFromNeighborhood(String userId, String assetId) Returns the sub-graph that represents the returned linked assets
AssetDescriptionResponse	searchAssets(String userId, String searchCriteria) Return a list of assets (details and connections) matching the search criteria
RelationshipsResponse	searchForRelationships(String userId, String relationshipTypeId, String criteria) Return a list of relationships that match the search criteria.

Methods inherited from class java.lang.Object

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

Constructor Detail

AssetCatalog

public AssetCatalog(String newServerURL)

Create a new AssetConsumer client.

Parameters:

newServerURL - the network address of the server running the OMAS REST servers

Method Detail

getAssetSummary

public AssetDescriptionResponse getAssetSummary(String userId,
                                                String assetId)
                                         throws PropertyServerException,
                                                InvalidParameterException

Fetch asset's header and classification

Specified by:

getAssetSummary in interface AssetCatalogInterface

Parameters:

userId - the unique identifier for the user

assetId - the unique identifier for the asset

Returns:

the asset with its header and the list of associated classifications

Throws:

PropertyServerException - there is a problem retrieving information from the property server

InvalidParameterException - one of the parameters is null or invalid

getAssetDetails

public AssetDescriptionResponse getAssetDetails(String userId,
                                                String assetId)
                                         throws PropertyServerException,
                                                InvalidParameterException

Fetch asset's header, classification and properties

Specified by:

getAssetDetails in interface AssetCatalogInterface

Parameters:

userId - the unique identifier for the user

assetId - the unique identifier for the asset

Returns:

the asset with its header and the list of associated classifications and specific properties

Throws:

PropertyServerException - there is a problem retrieving information from the property server

InvalidParameterException - one of the parameters is null or invalid

getAssetUniverse

public AssetDescriptionResponse getAssetUniverse(String userId,
                                                 String assetId)
                                          throws PropertyServerException,
                                                 InvalidParameterException

Fetch asset's header, classification, properties and relationships

Specified by:

getAssetUniverse in interface AssetCatalogInterface

Parameters:

userId - the unique identifier for the user

assetId - the unique identifier for the asset

Returns:

the asset with its header and the list of associated classifications

Throws:

PropertyServerException - there is a problem retrieving information from the property server

InvalidParameterException - one of the parameters is null or invalid

getAssetRelationships

public RelationshipsResponse getAssetRelationships(String userId,
                                                   String assetId)
                                            throws PropertyServerException,
                                                   InvalidParameterException

Fetch the relationships for a specific asset

Specified by:

getAssetRelationships in interface AssetCatalogInterface

Parameters:

userId - the unique identifier for the user

assetId - the unique identifier for the asset

Returns:

list of relationships for the given asset

Throws:

PropertyServerException - there is a problem retrieving information from the property server

InvalidParameterException - one of the parameters is null or invalid

getClassificationForAsset

public ClassificationsResponse getClassificationForAsset(String userId,
                                                         String assetId)
                                                  throws PropertyServerException,
                                                         InvalidParameterException

Fetch the classification for a specific asset

Specified by:

getClassificationForAsset in interface AssetCatalogInterface

Parameters:

userId - the unique identifier for the user

assetId - the unique identifier for the asset

Returns:

the classification for the asset

Throws:

PropertyServerException - there is a problem retrieving information from the property server

InvalidParameterException - one of the parameters is null or invalid

getAssetsByProperty

public AssetDescriptionResponse getAssetsByProperty(String userId,
                                                    String propertyValue)
                                             throws PropertyServerException,
                                                    InvalidParameterException

Fetch the assets that match the properties

Specified by:

getAssetsByProperty in interface AssetCatalogInterface

Parameters:

userId - the unique identifier for the user

propertyValue - the property value searched

Returns:

a list of assets that match the properties

Throws:

PropertyServerException - there is a problem retrieving information from the property server

InvalidParameterException - one of the parameters is null or invalid

getAssetsByClassificationName

public AssetDescriptionResponse getAssetsByClassificationName(String userId,
                                                              String classificationName)
                                                       throws PropertyServerException,
                                                              InvalidParameterException

Fetch the assets that match the classification name

Specified by:

getAssetsByClassificationName in interface AssetCatalogInterface

Parameters:

userId - the unique identifier for the user

classificationName - the name of the classification

Returns:

a list of assets that match the classification name

Throws:

PropertyServerException - there is a problem retrieving information from the property server

InvalidParameterException - one of the parameters is null or invalid

getLinkingRelationships

public RelationshipsResponse getLinkingRelationships(String userId,
                                                     String startAssetId,
                                                     String endAssetId)
                                              throws PropertyServerException,
                                                     InvalidParameterException

Return a sub-graph of relationships that connect two assets

Specified by:

getLinkingRelationships in interface AssetCatalogInterface

Parameters:

userId - the unique identifier for the user

startAssetId - the starting asset identifier of the query

endAssetId - the ending asset identifier of the query

Returns:

a list of relationships that connects the assets

Throws:

PropertyServerException - there is a problem retrieving information from the property server

InvalidParameterException - one of the parameters is null or invalid

getLinkingAssets

public AssetDescriptionResponse getLinkingAssets(String userId,
                                                 String startAssetId,
                                                 String endAssetId)
                                          throws PropertyServerException,
                                                 InvalidParameterException

Returns a sub-graph of intermediate assets that connected two assets

Specified by:

getLinkingAssets in interface AssetCatalogInterface

Parameters:

userId - the unique identifier for the user

startAssetId - the starting asset identifier of the query

endAssetId - the ending asset identifier of the query

Returns:

a list of assets between the given assets

Throws:

PropertyServerException - there is a problem retrieving information from the property server

InvalidParameterException - one of the parameters is null or invalid

getRelatedAssets

public AssetDescriptionResponse getRelatedAssets(String userId,
                                                 String assetId)
                                          throws PropertyServerException,
                                                 InvalidParameterException

Return the list of assets that are of the types listed in instanceTypes and are connected, either directly or indirectly to the asset identified by assetId.

Specified by:

getRelatedAssets in interface AssetCatalogInterface

Parameters:

userId - the unique identifier for the user

assetId - the starting asset identifier of the query

Returns:

list of assets either directly or indirectly connected to the start asset

Throws:

PropertyServerException - there is a problem retrieving information from the property server

InvalidParameterException - one of the parameters is null or invalid

getAssetsFromNeighborhood

public AssetDescriptionResponse getAssetsFromNeighborhood(String userId,
                                                          String assetId)
                                                   throws PropertyServerException,
                                                          InvalidParameterException

Returns the sub-graph that represents the returned linked relationships.

Specified by:

getAssetsFromNeighborhood in interface AssetCatalogInterface

Parameters:

userId - the unique identifier for the user

assetId - the starting asset identifier of the query

Returns:

a list of assets that in neighborhood of the given asset

Throws:

PropertyServerException - there is a problem retrieving information from the property server

InvalidParameterException - one of the parameters is null or invalid

getRelationshipsFromNeighborhood

public RelationshipsResponse getRelationshipsFromNeighborhood(String userId,
                                                              String assetId)
                                                       throws PropertyServerException,
                                                              InvalidParameterException

Returns the sub-graph that represents the returned linked assets

Specified by:

getRelationshipsFromNeighborhood in interface AssetCatalogInterface

Parameters:

userId - the unique identifier for the user

assetId - the starting asset identifier of the query

Returns:

a list of relationships that are linked between the assets

Throws:

PropertyServerException - there is a problem retrieving information from the property server

InvalidParameterException - one of the parameters is null or invalid

getLastCreatedAssets

public AssetDescriptionResponse getLastCreatedAssets(String userId)
                                              throws InvalidParameterException,
                                                     PropertyServerException

Returns the last created assets

Specified by:

getLastCreatedAssets in interface AssetCatalogInterface

Parameters:

userId - the unique identifier for the user

Returns:

a list of the last created assets

Throws:

PropertyServerException - there is a problem retrieving information from the property server

InvalidParameterException - one of the parameters is null or invalid

getLastUpdatedAssets

public AssetDescriptionResponse getLastUpdatedAssets(String userId)
                                              throws PropertyServerException,
                                                     InvalidParameterException

Returns the last updated assets

Specified by:

getLastUpdatedAssets in interface AssetCatalogInterface

Parameters:

userId - the unique identifier for the user

Returns:

a list of the last updated assets

Throws:

PropertyServerException - there is a problem retrieving information from the property server

InvalidParameterException - one of the parameters is null or invalid

getRelationship

public RelationshipsResponse getRelationship(String userId,
                                             String relationshipId)
                                      throws PropertyServerException,
                                             InvalidParameterException

Fetch relationship details based on its unique identifier

Specified by:

getRelationship in interface AssetCatalogInterface

Parameters:

userId - String unique identifier for the user

relationshipId - String unique identifier for the relationship

Returns:

relationship details

Throws:

PropertyServerException

InvalidParameterException

getRelationshipByLabel

public RelationshipsResponse getRelationshipByLabel(String userId,
                                                    String propertyName)
                                             throws PropertyServerException,
                                                    InvalidParameterException

Fetch relationship details based on property name

Specified by:

getRelationshipByLabel in interface AssetCatalogInterface

Parameters:

userId - String unique identifier for the user

propertyName - String that it is used to identify the relationship label

Returns:

a list of relationships that have the property specified

Throws:

PropertyServerException - there is a problem retrieving information from the property server

InvalidParameterException - one of the parameters is null or invalid

searchForRelationships

public RelationshipsResponse searchForRelationships(String userId,
                                                    String relationshipTypeId,
                                                    String criteria)
                                             throws PropertyServerException,
                                                    InvalidParameterException

Return a list of relationships that match the search criteria.

Specified by:

searchForRelationships in interface AssetCatalogInterface

Parameters:

userId - String unique identifier for the user

relationshipTypeId - limit the result set to only include the specified types for relationships

criteria - String for searching the relationship

Returns:

a list of relationships that match the search criteria

Throws:

PropertyServerException - there is a problem retrieving information from the property server

InvalidParameterException - one of the parameters is null or invalid

searchAssets

public AssetDescriptionResponse searchAssets(String userId,
                                             String searchCriteria)
                                      throws PropertyServerException,
                                             InvalidParameterException

Return a list of assets (details and connections) matching the search criteria

Specified by:

searchAssets in interface AssetCatalogInterface

Parameters:

userId - the unique identifier for the user

searchCriteria - a string expression of the characteristics of the required assets

Returns:

list of properties used to narrow the search

Throws:

PropertyServerException - there is a problem retrieving information from the property server

InvalidParameterException - one of the parameters is null or invalid