Class ValidMetadataRESTServices
java.lang.Object
org.odpi.openmetadata.tokencontroller.TokenController
org.odpi.openmetadata.viewservices.validmetadata.server.ValidMetadataRESTServices
The ValidMetadataRESTServices provides the server-side implementation of the Valid Metadata Open Metadata
View Service (OMVS).
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionclearValidMetadataMapName(String serverName, String urlMarker, String typeName, String propertyName, String preferredValue, DeleteElementRequestBody requestBody) Remove a valid map name value for a property.clearValidMetadataMapValue(String serverName, String urlMarker, String typeName, String propertyName, String mapName, String preferredValue, DeleteElementRequestBody requestBody) Remove a valid map name value for a property.clearValidMetadataValue(String serverName, String urlMarker, String typeName, String propertyName, String preferredValue, DeleteElementRequestBody requestBody) Remove a valid value for a property.deleteSpecificationProperty(String serverName, String urlMarker, String specificationPropertyGUID, DeleteElementRequestBody requestBody) Removes a specification property added to the element by this user.findSpecificationProperties(String serverName, String urlMarker, SearchStringRequestBody requestBody) Retrieve the list of specification property metadata elements that contain the search string.getAllTypes(String serverName, String urlMarker) Returns the list of different types of metadata organized into two groups.getConsistentMetadataValues(String serverName, String urlMarker, String typeName, String propertyName, String mapName, String preferredValue, int startFrom, int pageSize) Retrieve all the consistent valid values for the requested property.getSpecificationPropertiesByName(String serverName, String urlMarker, FilterRequestBody requestBody) Retrieve the list of specification property metadata elements that contain the name.getSpecificationPropertiesByType(String serverName, String urlMarker, SpecificationPropertyType specificationPropertyType, ResultsRequestBody requestBody) Retrieve the list of specification property metadata elements that contain the specification property type.getSpecificationPropertyByGUID(String serverName, String urlMarker, String specificationPropertyGUID, GetRequestBody requestBody) Return the requested specification property.getSpecificationPropertyTypes(String serverName, String urlMarker) Return the list of specification property types.getSubTypes(String serverName, String urlMarker, String typeName) Returns all the TypeDefs for a specific subtype.getTypeDefByName(String serverName, String urlMarker, String name) Return the TypeDef identified by the unique name.getTypeDefsByCategory(String serverName, String urlMarker, OpenMetadataTypeDefCategory category) Returns all the TypeDefs for a specific category.getValidClassificationTypes(String serverName, String urlMarker, String typeName) Returns all the TypeDefs for classifications that can be attached to the requested entity type.getValidMetadataMapName(String serverName, String urlMarker, String typeName, String propertyName, String preferredValue) Retrieve details of a specific valid name for a map property.getValidMetadataMapValue(String serverName, String urlMarker, String typeName, String propertyName, String mapName, String preferredValue) Retrieve details of a specific valid value for a map name.getValidMetadataValue(String serverName, String urlMarker, String typeName, String propertyName, String preferredValue) Retrieve details of a specific valid value for a property.getValidMetadataValues(String serverName, String urlMarker, String typeName, String propertyName, int startFrom, int pageSize) Retrieve all the valid values for the requested property.getValidRelationshipTypes(String serverName, String urlMarker, String typeName) Returns all the TypeDefs for relationships that can be attached to the requested entity type.setConsistentMetadataValues(String serverName, String urlMarker, String typeName1, String propertyName1, String mapName1, String preferredValue1, String typeName2, String propertyName2, String mapName2, String preferredValue2, NullRequestBody requestBody) Set up consistent metadata values relationship between the two property values.setUpSpecificationProperty(String serverName, String urlMarker, String elementGUID, SpecificationPropertyType specificationPropertyType, SpecificationProperty requestBody) Adds a specification property to the element.setUpValidMetadataMapName(String serverName, String urlMarker, String typeName, String propertyName, ValidMetadataValue requestBody) Create or update the valid value for a name that can be stored in a particular open metadata property name.setUpValidMetadataMapValue(String serverName, String urlMarker, String typeName, String propertyName, String mapName, ValidMetadataValue requestBody) Create or update the valid value for a name that can be stored in a particular open metadata property name.setUpValidMetadataValue(String serverName, String urlMarker, String typeName, String propertyName, ValidMetadataValue requestBody) Create or update the valid value for a particular open metadata property name.validateMetadataMapName(String serverName, String urlMarker, String typeName, String propertyName, String actualValue) Validate whether the name found in an open metadata map property is valid.validateMetadataMapValue(String serverName, String urlMarker, String typeName, String propertyName, String mapName, String actualValue) Validate whether the name found in an open metadata map property is valid.validateMetadataValue(String serverName, String urlMarker, String typeName, String propertyName, String actualValue) Validate whether the value found in an open metadata property is valid.Methods inherited from class org.odpi.openmetadata.tokencontroller.TokenController
getUser
-
Constructor Details
-
ValidMetadataRESTServices
public ValidMetadataRESTServices()Default constructor
-
-
Method Details
-
setUpValidMetadataValue
public VoidResponse setUpValidMetadataValue(String serverName, String urlMarker, String typeName, String propertyName, ValidMetadataValue requestBody) Create or update the valid value for a particular open metadata property name. If the typeName is null, this valid value applies to properties of this name from all types. The valid value is stored in the preferredValue property. If a valid value is already set up for this property (with overlapping effective dates) then the valid value is updated.- Parameters:
serverName- name of server instance to route request tourlMarker- view service URL markertypeName- type name if this is valid value is specific for a type, or null if this valid value if for the property name for all typespropertyName- name of property that this valid value appliesrequestBody- preferred value to use in the open metadata types plus additional descriptive values.- Returns:
- void or InvalidParameterException the property name is null or not known. UserNotAuthorizedException the service is not able to create/access the element PropertyServerException there is a problem accessing the metadata store
-
setUpValidMetadataMapName
public VoidResponse setUpValidMetadataMapName(String serverName, String urlMarker, String typeName, String propertyName, ValidMetadataValue requestBody) Create or update the valid value for a name that can be stored in a particular open metadata property name. This property is of type map from name to string. The valid value is stored in the preferredValue property of validMetadataValue. If the typeName is null, this valid value applies to properties of this name from any open metadata type. If a valid value is already set up for this property (with overlapping effective dates) then the valid value is updated.- Parameters:
serverName- name of server instance to route request tourlMarker- view service URL markertypeName- type name if this is valid value is specific for a type, or null if this valid value if for the property name for all typespropertyName- name of property that this valid value appliesrequestBody- preferred value to use in the open metadata types plus additional descriptive values.- Returns:
- void or InvalidParameterException the property name is null or not known. UserNotAuthorizedException the service is not able to create/access the element PropertyServerException there is a problem accessing the metadata store
-
setUpValidMetadataMapValue
public VoidResponse setUpValidMetadataMapValue(String serverName, String urlMarker, String typeName, String propertyName, String mapName, ValidMetadataValue requestBody) Create or update the valid value for a name that can be stored in a particular open metadata property name. This property is of type map from name to string. The valid value is stored in the preferredValue property of validMetadataValue. If the typeName is null, this valid value applies to properties of this name from any open metadata type. If a valid value is already set up for this property (with overlapping effective dates) then the valid value is updated.- Parameters:
serverName- name of server instance to route request tourlMarker- view service URL markertypeName- type name if this is valid value is specific for a type, or null if this valid value if for the property name for all typespropertyName- name of property that this valid value appliesmapName- name in the map that this valid value applies. If null then the value can be used for any name in the map.requestBody- preferred value to use in the open metadata types plus additional descriptive values.- Returns:
- void or InvalidParameterException the property name is null or not known. UserNotAuthorizedException the service is not able to create/access the element PropertyServerException there is a problem accessing the metadata store
-
clearValidMetadataValue
public VoidResponse clearValidMetadataValue(String serverName, String urlMarker, String typeName, String propertyName, String preferredValue, DeleteElementRequestBody requestBody) Remove a valid value for a property.- Parameters:
serverName- name of server instance to route request tourlMarker- view service URL markertypeName- type name if this is valid value is specific for a type, or null if this valid value if for the property name for all typespropertyName- name of property that this valid value appliespreferredValue- specific valid value to removerequestBody- null request body- Returns:
- void or InvalidParameterException the property name is null or not known. UserNotAuthorizedException the service is not able to create/access the element PropertyServerException there is a problem accessing the metadata store
-
clearValidMetadataMapName
public VoidResponse clearValidMetadataMapName(String serverName, String urlMarker, String typeName, String propertyName, String preferredValue, DeleteElementRequestBody requestBody) Remove a valid map name value for a property. The match is done on preferred name.- Parameters:
serverName- name of server instance to route request tourlMarker- view service URL markertypeName- type name if this is valid value is specific for a type, or null if this valid value if for the property name for all typespropertyName- name of property that this valid value appliespreferredValue- specific valid value to removerequestBody- null request body- Returns:
- void or InvalidParameterException the property name is null or not known. UserNotAuthorizedException the service is not able to create/access the element PropertyServerException there is a problem accessing the metadata store
-
clearValidMetadataMapValue
public VoidResponse clearValidMetadataMapValue(String serverName, String urlMarker, String typeName, String propertyName, String mapName, String preferredValue, DeleteElementRequestBody requestBody) Remove a valid map name value for a property. The match is done on preferred name.- Parameters:
serverName- name of server instance to route request tourlMarker- view service URL markertypeName- type name if this is valid value is specific for a type, or null if this valid value if for the property name for all typespropertyName- name of property that this valid value appliesmapName- name in the map that this valid value applies. If null then the value can be used for any name in the map.preferredValue- specific valid value to removerequestBody- null request body- Returns:
- void or InvalidParameterException the property name is null or not known. UserNotAuthorizedException the service is not able to create/access the element PropertyServerException there is a problem accessing the metadata store
-
validateMetadataValue
public BooleanResponse validateMetadataValue(String serverName, String urlMarker, String typeName, String propertyName, String actualValue) Validate whether the value found in an open metadata property is valid.- Parameters:
serverName- name of server instance to route request tourlMarker- view service URL markertypeName- type name if this is valid value is specific for a type, or null if this valid value if for the property name for all typespropertyName- name of property that this valid value appliesactualValue- value stored in the property - if this is null, true is only returned if null is set up as a valid value.- Returns:
- boolean flag - true if the value is one of the defined valid values or there are no valid values set up for the property (and so any value is value) or InvalidParameterException the property name is null or not known. UserNotAuthorizedException the service is not able to create/access the element PropertyServerException there is a problem accessing the metadata store
-
validateMetadataMapName
public BooleanResponse validateMetadataMapName(String serverName, String urlMarker, String typeName, String propertyName, String actualValue) Validate whether the name found in an open metadata map property is valid.- Parameters:
serverName- name of server instance to route request tourlMarker- view service URL markertypeName- type name if this is valid value is specific for a type, or null if this valid value if for the property name for all typespropertyName- name of property that this valid value appliesactualValue- value stored in the property - if this is null, true is only returned if null is set up as a valid value.- Returns:
- boolean flag - true if the value is one of the defined valid values or there are no valid values set up for the property (and so any value is value) or InvalidParameterException the property name is null or not known. UserNotAuthorizedException the service is not able to create/access the element PropertyServerException there is a problem accessing the metadata store
-
validateMetadataMapValue
public BooleanResponse validateMetadataMapValue(String serverName, String urlMarker, String typeName, String propertyName, String mapName, String actualValue) Validate whether the name found in an open metadata map property is valid.- Parameters:
serverName- name of server instance to route request tourlMarker- view service URL markertypeName- type name if this is valid value is specific for a type, or null if this valid value if for the property name for all typespropertyName- name of property that this valid value appliesmapName- name in the map that this valid value applies. If null then the value can be used for any name in the map.actualValue- value stored in the property - if this is null, true is only returned if null is set up as a valid value.- Returns:
- boolean flag - true if the value is one of the defined valid values or there are no valid values set up for the property (and so any value is value) or InvalidParameterException the property name is null or not known. UserNotAuthorizedException the service is not able to create/access the element PropertyServerException there is a problem accessing the metadata store
-
getValidMetadataValue
public ValidMetadataValueResponse getValidMetadataValue(String serverName, String urlMarker, String typeName, String propertyName, String preferredValue) Retrieve details of a specific valid value for a property.- Parameters:
serverName- name of server instance to route request tourlMarker- view service URL markertypeName- type name if this is valid value is specific for a type, or null if this valid value if for the property name for all typespropertyName- name of property that this valid value appliespreferredValue- valid value to match- Returns:
- specific valid value definition or none if there is no definition stored or InvalidParameterException the property name is null or not known. UserNotAuthorizedException the service is not able to create/access the element PropertyServerException there is a problem accessing the metadata store
-
getValidMetadataMapName
public ValidMetadataValueResponse getValidMetadataMapName(String serverName, String urlMarker, String typeName, String propertyName, String preferredValue) Retrieve details of a specific valid name for a map property.- Parameters:
serverName- name of server instance to route request tourlMarker- view service URL markertypeName- type name if this is valid value is specific for a type, or null if this valid value if for the property name for all typespropertyName- name of property that this valid value appliespreferredValue- valid value to match- Returns:
- specific valid value definition or none if there is no definition stored or InvalidParameterException the property name is null or not known. UserNotAuthorizedException the service is not able to create/access the element PropertyServerException there is a problem accessing the metadata store
-
getValidMetadataMapValue
public ValidMetadataValueResponse getValidMetadataMapValue(String serverName, String urlMarker, String typeName, String propertyName, String mapName, String preferredValue) Retrieve details of a specific valid value for a map name.- Parameters:
serverName- name of server instance to route request tourlMarker- view service URL markertypeName- type name if this is valid value is specific for a type, or null if this valid value if for the property name for all typespropertyName- name of property that this valid value appliesmapName- name in the map that this valid value applies. If null then the value can be used for any name in the map.preferredValue- valid value to match- Returns:
- specific valid value definition or none if there is no definition stored or InvalidParameterException the property name is null or not known. UserNotAuthorizedException the service is not able to create/access the element PropertyServerException there is a problem accessing the metadata store
-
getValidMetadataValues
public ValidMetadataValueListResponse getValidMetadataValues(String serverName, String urlMarker, String typeName, String propertyName, int startFrom, int pageSize) Retrieve all the valid values for the requested property.- Parameters:
serverName- name of server instance to route request tourlMarker- view service URL markertypeName- type name if this is valid value is specific for a type, or null if this valid value if for the property name for all typespropertyName- name of property that this valid value appliesstartFrom- paging start pointpageSize- maximum results that can be returned- Returns:
- list of valid values defined for the property or InvalidParameterException the property name is null or not known. UserNotAuthorizedException the service is not able to create/access the element PropertyServerException there is a problem accessing the metadata store
-
getConsistentMetadataValues
public ValidMetadataValueListResponse getConsistentMetadataValues(String serverName, String urlMarker, String typeName, String propertyName, String mapName, String preferredValue, int startFrom, int pageSize) Retrieve all the consistent valid values for the requested property.- Parameters:
serverName- name of server instance to route request tourlMarker- view service URL markertypeName- type name if this is valid value is specific for a type, or null if this valid value if for the property name for all typespropertyName- name of property that this valid value appliesmapName- optional name of map key that this valid value appliespreferredValue- the value to match againststartFrom- paging start pointpageSize- maximum results that can be returned- Returns:
- list of valid values defined for the property or InvalidParameterException the property name is null or not known. UserNotAuthorizedException the service is not able to create/access the element PropertyServerException there is a problem accessing the metadata store
-
setConsistentMetadataValues
public VoidResponse setConsistentMetadataValues(String serverName, String urlMarker, String typeName1, String propertyName1, String mapName1, String preferredValue1, String typeName2, String propertyName2, String mapName2, String preferredValue2, NullRequestBody requestBody) Set up consistent metadata values relationship between the two property values.- Parameters:
serverName- name of server instance to route request tourlMarker- view service URL markertypeName1- type name if this is valid value is specific for a type, or null if this valid value if for the property name for all typespropertyName1- name of property that this valid value appliesmapName1- optional name of map key that this valid value appliespreferredValue1- the value to match againsttypeName2- type name if this is valid value is specific for a type, or null if this valid value if for the property name for all typespropertyName2- name of property that this valid value appliesmapName2- optional name of map key that this valid value appliespreferredValue2- the value to match againstrequestBody- null request body- Returns:
- void or InvalidParameterException the property name is null or not known. UserNotAuthorizedException the service is not able to create/access the element PropertyServerException there is a problem accessing the metadata store
-
getAllTypes
Returns the list of different types of metadata organized into two groups. The first are the attribute type definitions (AttributeTypeDefs). These provide types for properties in full type definitions. Full type definitions (TypeDefs) describe types for entities, relationships and classifications.- Parameters:
serverName- unique identifier for requested server.urlMarker- view service URL marker- Returns:
- TypeDefGalleryResponse: List of different categories of type definitions or RepositoryErrorException there is a problem communicating with the metadata repository or UserNotAuthorizedException the userId is not permitted to perform this operation.
-
getTypeDefsByCategory
public TypeDefListResponse getTypeDefsByCategory(String serverName, String urlMarker, OpenMetadataTypeDefCategory category) Returns all the TypeDefs for a specific category.- Parameters:
serverName- unique identifier for requested server.urlMarker- view service URL markercategory- find parameters used to limit the returned results.- Returns:
- TypeDefListResponse: TypeDefs list or InvalidParameterException the TypeDefCategory is null or RepositoryErrorException there is a problem communicating with the metadata repository or UserNotAuthorizedException the userId is not permitted to perform this operation.
-
getSubTypes
Returns all the TypeDefs for a specific subtype. If a null result is returned it means the type has no subtypes.- Parameters:
serverName- unique identifier for requested server.urlMarker- view service URL markertypeName- name of type to retrieve against.- Returns:
- TypeDefListResponse: TypeDefs list or InvalidParameterException the typeName is null or RepositoryErrorException there is a problem communicating with the metadata repository or UserNotAuthorizedException the userId is not permitted to perform this operation.
-
getValidRelationshipTypes
public TypeDefListResponse getValidRelationshipTypes(String serverName, String urlMarker, String typeName) Returns all the TypeDefs for relationships that can be attached to the requested entity type.- Parameters:
serverName- unique identifier for requested server.urlMarker- view service URL markertypeName- name of entity type to retrieve against.- Returns:
- TypeDefsGalleryResponse: A list of types or InvalidParameterException all attributes of the external id are null or RepositoryErrorException there is a problem communicating with the metadata repository or UserNotAuthorizedException the userId is not permitted to perform this operation.
-
getValidClassificationTypes
public TypeDefListResponse getValidClassificationTypes(String serverName, String urlMarker, String typeName) Returns all the TypeDefs for classifications that can be attached to the requested entity type.- Parameters:
serverName- unique identifier for requested server.urlMarker- view service URL markertypeName- name of type to retrieve against.- Returns:
- TypeDefsGalleryResponse: A list of types or InvalidParameterException all attributes of the external id are null or RepositoryErrorException there is a problem communicating with the metadata repository or UserNotAuthorizedException the userId is not permitted to perform this operation.
-
getTypeDefByName
Return the TypeDef identified by the unique name.- Parameters:
serverName- unique identifier for requested server.urlMarker- view service URL markername- String name of the TypeDef.- Returns:
- TypeDefResponse: TypeDef structure describing its category and properties or InvalidParameterException the name is null or RepositoryErrorException there is a problem communicating with the metadata repository where the metadata collection is stored or TypeDefNotKnownException the requested TypeDef is not found in the metadata collection or UserNotAuthorizedException the userId is not permitted to perform this operation.
-
getSpecificationPropertyTypes
Return the list of specification property types.- Parameters:
serverName- name of the server instance to connect tourlMarker- view service URL marker- Returns:
- list of type names that are subtypes of asset or throws InvalidParameterException full path or userId is null or throws PropertyServerException problem accessing property server or throws UserNotAuthorizedException security access problem.
-
setUpSpecificationProperty
public GUIDResponse setUpSpecificationProperty(String serverName, String urlMarker, String elementGUID, SpecificationPropertyType specificationPropertyType, SpecificationProperty requestBody) Adds a specification property to the element.- Parameters:
serverName- name of the server instances for this requesturlMarker- view service URL markerelementGUID- unique identifier of the element to connect it tospecificationPropertyType- type of specification property (enum)requestBody- the property description- Returns:
- elementGUID for new specification property object or InvalidParameterException - one of the parameters is null or invalid or PropertyServerException - there is a problem adding the element properties to the metadata repository or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
deleteSpecificationProperty
public VoidResponse deleteSpecificationProperty(String serverName, String urlMarker, String specificationPropertyGUID, DeleteElementRequestBody requestBody) Removes a specification property added to the element by this user.- Parameters:
serverName- name of the server instances for this requesturlMarker- view service URL markerspecificationPropertyGUID- String - unique id for the specification property objectrequestBody- optional effective time- Returns:
- void or InvalidParameterException - one of the parameters is null or invalid or PropertyServerException - there is a problem updating the element properties in the metadata repository or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
getSpecificationPropertyByGUID
public OpenMetadataRootElementResponse getSpecificationPropertyByGUID(String serverName, String urlMarker, String specificationPropertyGUID, GetRequestBody requestBody) Return the requested specification property.- Parameters:
serverName- name of the server instances for this requestspecificationPropertyGUID- unique identifier for the specification property object.urlMarker- view service URL markerrequestBody- optional effective time- Returns:
- specification property properties or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem updating the element properties in the property server. UserNotAuthorizedException the user does not have permission to perform this request.
-
getSpecificationPropertiesByName
public OpenMetadataRootElementsResponse getSpecificationPropertiesByName(String serverName, String urlMarker, FilterRequestBody requestBody) Retrieve the list of specification property metadata elements that contain the name.- Parameters:
serverName- name of the server to route the request tourlMarker- view service URL markerrequestBody- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
-
getSpecificationPropertiesByType
public OpenMetadataRootElementsResponse getSpecificationPropertiesByType(String serverName, String urlMarker, SpecificationPropertyType specificationPropertyType, ResultsRequestBody requestBody) Retrieve the list of specification property metadata elements that contain the specification property type.- Parameters:
serverName- name of the server to route the request tourlMarker- view service URL markerspecificationPropertyType- enum value for specification property typerequestBody- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
-
findSpecificationProperties
public OpenMetadataRootElementsResponse findSpecificationProperties(String serverName, String urlMarker, SearchStringRequestBody requestBody) Retrieve the list of specification property metadata elements that contain the search string.- Parameters:
serverName- name of the server to route the request tourlMarker- view service URL markerrequestBody- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
-