Type Parameters:: T - Glossary Artifact type for supplied and return. Interface describing common methods to client working with Subject area resources. This is the Subject Area client API, for use by the subject area expert. This API exposes SCRUD (search, create, read ,update, delete) operations that can be performed on a Glossary Artifact.

All Known Subinterfaces:: SubjectAreaNodeClient<E>, SubjectAreaRelationshipClient<L>

All Known Implementing Classes:: AbstractSubjectArea, AbstractSubjectAreaNode, AbstractSubjectAreaRelationship, SubjectAreaCategoryClient, SubjectAreaGlossaryClient, SubjectAreaProjectClient, SubjectAreaTermClient

public interface SubjectAreaClient<T>

Field Summary

Fields

Modifier and Type

Field

Description

static final FindRequest

EMPTY_FIND_REQUEST
Method Summary

Modifier and Type

Method

Description

T

create(String userId, T supplied)

Create a Glossary Artifact.

void

delete(String userId, String guid)

Delete a Glossary Artifact.

List<T>

find(String userId, FindRequest findRequest)

Request to find Glossary Artifacts of the type T.

List<T>

find(String userId, FindRequest findRequest, boolean exactValue, boolean ignoreCase)

Request to find Glossary Artifacts of the type T.

List<T>

find(String userId, FindRequest findRequest, boolean exactValue, boolean ignoreCase, Integer maximumPageSizeOnRestCall)

Request to find Glossary Artifacts of the type T.

default List<T>

findAll(String userId)

Request to find all Glossary Artifacts of the type T.

default List<T>

findAll(String userId, Integer maximumPageSizeOnRestCall)

Request to find all Glossary Artifacts of the type T.

T

getByGUID(String userId, String guid)

Get Glossary Artifact by guid

default T

replace(String userId, String guid, T supplied)

Replace a Glossary Artifact.

T

restore(String userId, String guid)

Restore of a soft deleted Glossary Artifact.

default T

update(String userId, String guid, T supplied)

Update a Glossary Artifact.

T

update(String userId, String guid, T supplied, boolean isReplace)

Update or replace a Glossary Artifact.

Field Details
- EMPTY_FIND_REQUEST
  
  static final FindRequest EMPTY_FIND_REQUEST
Method Details
- getByGUID
  
  T getByGUID(String userId, String guid) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
  
  Get Glossary Artifact by guid
  
  Parameters:
  
  userId - unique identifier for requesting user, under which the request is performed.
  
  guid - unique identifier of the Glossary Artifact.
  
  Returns:
  
  found Glossary Artifact of the T type.
  
  Throws:
  
  PropertyServerException - something went wrong with the REST call stack.
  
  UserNotAuthorizedException - the requesting user is not authorized to issue this request.
  
  InvalidParameterException - one of the parameters is null or invalid.
- create
  
  T create(String userId, T supplied) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
  
  Create a Glossary Artifact. To create, you must pass the created object and specify a unique user identifier.
  
  Parameters:
  
  userId - unique identifier for requesting user, under which the request is performed.
  
  supplied - Glossary Artifact to create.
  
  Returns:
  
  created Glossary Artifact.
  
  Throws:
  
  PropertyServerException - something went wrong with the REST call stack.
  
  UserNotAuthorizedException - the requesting user is not authorized to issue this request.
  
  InvalidParameterException - one of the parameters is null or invalid.
- findAll
  
  default List<T> findAll(String userId) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
  
  Request to find all Glossary Artifacts of the type T. Be aware that getting all objects may incur a big performance hit when there are many objects.
  
  Parameters:
  
  userId - unique identifier for requesting user, under which the request is performed.
  
  Returns:
  
  list all Glossary Artifacts of the T type.
  
  Throws:
  
  PropertyServerException - something went wrong with the REST call stack.
  
  UserNotAuthorizedException - the requesting user is not authorized to issue this request.
  
  InvalidParameterException - one of the parameters is null or invalid.
- findAll
  
  default List<T> findAll(String userId, Integer maximumPageSizeOnRestCall) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
  
  Request to find all Glossary Artifacts of the type T. Be aware that getting all objects may incur a big performance hit when there are many objects.
  
  Parameters:
  
  userId - unique identifier for requesting user, under which the request is performed.
  
  maximumPageSizeOnRestCall - maximum page size that can be used on rest calls, null and 0 mean no limit set.
  
  Returns:
  
  list all Glossary Artifacts of the T type.
  
  Throws:
  
  PropertyServerException - something went wrong with the REST call stack.
  
  UserNotAuthorizedException - the requesting user is not authorized to issue this request.
  
  InvalidParameterException - one of the parameters is null or invalid.
- find
  
  List<T> find(String userId, FindRequest findRequest) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
  
  Request to find Glossary Artifacts of the type T.
  
  Parameters:
  
  userId - unique identifier for requesting user, under which the request is performed.
  
  findRequest - information Glossary Artifact for find calls.
  
  Returns:
  
  list Glossary Artifacts of the T type relevant in the findRequest information.
  
  Throws:
  
  PropertyServerException - something went wrong with the REST call stack.
  
  UserNotAuthorizedException - the requesting user is not authorized to issue this request.
  
  InvalidParameterException - one of the parameters is null or invalid.
- find
  
  List<T> find(String userId, FindRequest findRequest, boolean exactValue, boolean ignoreCase) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
  
  Request to find Glossary Artifacts of the type T.
  
  Parameters:
  
  userId - unique identifier for requesting user, under which the request is performed.
  
  findRequest - information Glossary Artifact for find calls.
  
  exactValue - should the result match exactly?
  
  ignoreCase - should the match be case insensitive?
  
  Returns:
  
  list Glossary Artifacts of the T type relevant in the findRequest information.
  
  Throws:
  
  PropertyServerException - something went wrong with the REST call stack.
  
  UserNotAuthorizedException - the requesting user is not authorized to issue this request.
  
  InvalidParameterException - one of the parameters is null or invalid.
- find
  
  List<T> find(String userId, FindRequest findRequest, boolean exactValue, boolean ignoreCase, Integer maximumPageSizeOnRestCall) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
  
  Request to find Glossary Artifacts of the type T. The downstream server is likely to have a maximum Page Size is will accept, the client can interrogate this value and include it on the maximumPageSizeOnRestCall parameter. This API will ensure will issue multiple rest calls if required to ensure requests only request the supported max page size.
  
  Parameters:
  
  userId - unique identifier for requesting user, under which the request is performed.
  
  findRequest - information Glossary Artifact for find calls.
  
  exactValue - exactValue - when false values with trailing characters will match
  
  ignoreCase - ignore the case when matching
  
  maximumPageSizeOnRestCall - maximum page size that can be used on rest calls, null and 0 mean no limit set.
  
  Returns:
  
  list Glossary Artifacts of the T type relevant in the findRequest information.
  
  Throws:
  
  PropertyServerException - something went wrong with the REST call stack.
  
  UserNotAuthorizedException - the requesting user is not authorized to issue this request.
  
  InvalidParameterException - one of the parameters is null or invalid.
- update
  
  T update(String userId, String guid, T supplied, boolean isReplace) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
  
  Update or replace a Glossary Artifact.
  
  Parameters:
  
  guid - unique identifier of the Glossary Artifact.
  
  userId - unique identifier for requesting user, under which the request is performed.
  
  supplied - Glossary Artifact to be updated or replaced.
  
  isReplace - flag to indicate that this update is a replace.
  
  Returns:
  
  updated Glossary Artifact.
  
  Throws:
  
  PropertyServerException - something went wrong with the REST call stack.
  
  UserNotAuthorizedException - the requesting user is not authorized to issue this request.
  
  InvalidParameterException - one of the parameters is null or invalid.
- replace
  
  default T replace(String userId, String guid, T supplied) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
  
  Replace a Glossary Artifact. This means to override all the existing attributes with the supplied attributes.
  
  Parameters:
  
  guid - unique identifier of the Glossary Artifact.
  
  userId - unique identifier for requesting user, under which the request is performed.
  
  supplied - Glossary Artifact to be replaced.
  
  Returns:
  
  replaced Glossary Artifact.
  
  Throws:
  
  PropertyServerException - something went wrong with the REST call stack.
  
  UserNotAuthorizedException - the requesting user is not authorized to issue this request.
  
  InvalidParameterException - one of the parameters is null or invalid.
- update
  
  default T update(String userId, String guid, T supplied) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
  
  Update a Glossary Artifact. This means to update the object with any non-null attributes from the supplied Glossary Artifact.
  
  Parameters:
  
  guid - unique identifier of the Glossary Artifact.
  
  userId - unique identifier for requesting user, under which the request is performed.
  
  supplied - Glossary Artifact to be updated.
  
  Returns:
  
  updated Glossary Artifact.
  
  Throws:
  
  PropertyServerException - something went wrong with the REST call stack.
  
  UserNotAuthorizedException - the requesting user is not authorized to issue this request.
  
  InvalidParameterException - one of the parameters is null or invalid.
- delete
  
  void delete(String userId, String guid) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
  
  Delete a Glossary Artifact.
  
  Parameters:
  
  guid - unique identifier of the Glossary Artifact.
  
  userId - unique identifier for requesting user, under which the request is performed.
  
  Throws:
  
  PropertyServerException - something went wrong with the REST call stack.
  
  UserNotAuthorizedException - the requesting user is not authorized to issue this request.
  
  InvalidParameterException - one of the parameters is null or invalid.
- restore
  
  T restore(String userId, String guid) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
  
  Restore of a soft deleted Glossary Artifact.
  
  Parameters:
  
  guid - unique identifier of the Glossary Artifact.
  
  userId - unique identifier for requesting user, under which the request is performed.
  
  Returns:
  
  restored glossary Artifact
  
  Throws:
  
  PropertyServerException - something went wrong with the REST call stack.
  
  UserNotAuthorizedException - the requesting user is not authorized to issue this request.
  
  InvalidParameterException - one of the parameters is null or invalid.

Interface SubjectAreaClient<T>

Field Summary

Method Summary

Field Details

EMPTY_FIND_REQUEST

Method Details

getByGUID

create

findAll

findAll

find

find

find

update

replace

update

delete

restore