org.odpi.openmetadata.accessservices.governanceprogram.client

Class GovernanceZoneManager

java.lang.Object

org.odpi.openmetadata.accessservices.governanceprogram.client.GovernanceZoneManager

All Implemented Interfaces:

GovernanceZonesInterface

public class GovernanceZoneManager
extends Object
implements GovernanceZonesInterface

GovernanceZoneManager is the Java client used to manage governance zones.

Constructor Summary

Constructors

Constructor and Description
GovernanceZoneManager(String serverName, String serverPlatformURLRoot) Create a new client with no authentication embedded in the HTTP request.
GovernanceZoneManager(String serverName, String serverPlatformURLRoot, GovernanceProgramRESTClient restClient, int maxPageSize) Create a new client that uses the supplied rest client.
GovernanceZoneManager(String serverName, String serverPlatformURLRoot, int maxPageSize, AuditLog auditLog) Create a new client with no authentication embedded in the HTTP request.
GovernanceZoneManager(String serverName, String serverPlatformURLRoot, String userId, String password) Create a new client that passes userId and password in each HTTP request.
GovernanceZoneManager(String serverName, String serverPlatformURLRoot, String userId, String password, int maxPageSize, AuditLog auditLog) Create a new client that passes userId and password in each HTTP request.

Method Summary

Modifier and Type	Method and Description
String	createGovernanceZone(String userId, GovernanceZoneProperties properties) Create a definition of a governance zone.
void	deleteGovernanceZone(String userId, String zoneGUID) Remove the definition of a zone.
GovernanceZoneElement	getGovernanceZoneByGUID(String userId, String zoneGUID) Return information about a specific governance zone.
GovernanceZoneElement	getGovernanceZoneByName(String userId, String qualifiedName) Return information about a specific governance zone.
GovernanceZoneDefinition	getGovernanceZoneDefinitionByGUID(String userId, String zoneGUID) Return information about a specific governance zone and its linked governance definitions.
List<GovernanceZoneElement>	getGovernanceZonesForDomain(String userId, int domainIdentifier, int startFrom, int pageSize) Return information about the defined governance zones.
void	linkZonesInHierarchy(String userId, String parentZoneGUID, String childZoneGUID) Link two related governance zones together as part of a hierarchy.
void	linkZoneToGovernanceDefinition(String userId, String zoneGUID, String definitionGUID) Link a governance zone to a governance definition that controls how the assets in the zone should be governed.
void	unlinkZoneFromGovernanceDefinition(String userId, String zoneGUID, String definitionGUID) Remove the link between a zone and a governance definition.
void	unlinkZonesInHierarchy(String userId, String parentZoneGUID, String childZoneGUID) Remove the link between two zones in the zone hierarchy.
void	updateGovernanceZone(String userId, String zoneGUID, boolean isMergeUpdate, GovernanceZoneProperties properties) Update the definition of a zone.

Methods inherited from class java.lang.Object

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

Constructor Detail

GovernanceZoneManager

public GovernanceZoneManager(String serverName,
                             String serverPlatformURLRoot)
                      throws InvalidParameterException

Create a new client with no authentication embedded in the HTTP request.

Parameters:

serverName - name of the server to connect to

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

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

GovernanceZoneManager

public GovernanceZoneManager(String serverName,
                             String serverPlatformURLRoot,
                             String userId,
                             String password)
                      throws InvalidParameterException

Create a new client that passes userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is sent on each request.

Parameters:

serverName - name of the server to connect to

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

userId - caller's userId embedded in all HTTP requests

password - caller's userId embedded in all HTTP requests

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

GovernanceZoneManager

public GovernanceZoneManager(String serverName,
                             String serverPlatformURLRoot,
                             int maxPageSize,
                             AuditLog auditLog)
                      throws InvalidParameterException

Create a new client with no authentication embedded in the HTTP request.

Parameters:

serverName - name of the server to connect to

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

maxPageSize - pre-initialized parameter limit

auditLog - logging destination

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

GovernanceZoneManager

public GovernanceZoneManager(String serverName,
                             String serverPlatformURLRoot,
                             String userId,
                             String password,
                             int maxPageSize,
                             AuditLog auditLog)
                      throws InvalidParameterException

Create a new client that passes userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is sent on each request.

Parameters:

serverName - name of the server to connect to

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

userId - caller's userId embedded in all HTTP requests

password - caller's userId embedded in all HTTP requests

maxPageSize - pre-initialized parameter limit

auditLog - logging destination

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

GovernanceZoneManager

public GovernanceZoneManager(String serverName,
                             String serverPlatformURLRoot,
                             GovernanceProgramRESTClient restClient,
                             int maxPageSize)
                      throws InvalidParameterException

Create a new client that uses the supplied rest client. This is typically used when called fro manother OMAG Server.

Parameters:

serverName - name of the server to connect to

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

restClient - internal client for rest calls

maxPageSize - pre-initialized parameter limit

Throws:

InvalidParameterException - bad input parameters

Method Detail

createGovernanceZone

public String createGovernanceZone(String userId,
                                   GovernanceZoneProperties properties)
                            throws InvalidParameterException,
                                   UserNotAuthorizedException,
                                   PropertyServerException

Create a definition of a governance zone. The qualified name of these governance zones can be added to the supportedZones, publishedZones and defaultZones properties of an OMAS to control which assets are processed and how they are set up. In addition the qualified names of zones can be added to Asset definitions to indicate which zone(s) they belong to.

Specified by:

createGovernanceZone in interface GovernanceZonesInterface

Parameters:

userId - calling user

properties - properties for a governance zone

Throws:

InvalidParameterException - qualifiedName or userId is null; qualifiedName is not unique

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

updateGovernanceZone

public void updateGovernanceZone(String userId,
                                 String zoneGUID,
                                 boolean isMergeUpdate,
                                 GovernanceZoneProperties properties)
                          throws InvalidParameterException,
                                 UserNotAuthorizedException,
                                 PropertyServerException

Update the definition of a zone.

Specified by:

updateGovernanceZone in interface GovernanceZonesInterface

Parameters:

userId - calling user

zoneGUID - unique identifier of zone

isMergeUpdate - are unspecified properties unchanged (true) or replaced with null?

properties - properties to change

Throws:

InvalidParameterException - guid, qualifiedName or userId is null; qualifiedName is not unique; guid is not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

deleteGovernanceZone

public void deleteGovernanceZone(String userId,
                                 String zoneGUID)
                          throws InvalidParameterException,
                                 UserNotAuthorizedException,
                                 PropertyServerException

Remove the definition of a zone.

Specified by:

deleteGovernanceZone in interface GovernanceZonesInterface

Parameters:

userId - calling user

zoneGUID - unique identifier of zone

Throws:

InvalidParameterException - guid or userId is null; guid is not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

linkZonesInHierarchy

public void linkZonesInHierarchy(String userId,
                                 String parentZoneGUID,
                                 String childZoneGUID)
                          throws InvalidParameterException,
                                 UserNotAuthorizedException,
                                 PropertyServerException

Link two related governance zones together as part of a hierarchy. A zone can only have one parent but many child zones.

Specified by:

linkZonesInHierarchy in interface GovernanceZonesInterface

Parameters:

userId - calling user

parentZoneGUID - unique identifier of the parent zone

childZoneGUID - unique identifier of the child zone

Throws:

InvalidParameterException - one of the guids is null or not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

unlinkZonesInHierarchy

public void unlinkZonesInHierarchy(String userId,
                                   String parentZoneGUID,
                                   String childZoneGUID)
                            throws InvalidParameterException,
                                   UserNotAuthorizedException,
                                   PropertyServerException

Remove the link between two zones in the zone hierarchy.

Specified by:

unlinkZonesInHierarchy in interface GovernanceZonesInterface

Parameters:

userId - calling user

parentZoneGUID - unique identifier of the parent zone

childZoneGUID - unique identifier of the child zone

Throws:

InvalidParameterException - one of the guids is null or not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

linkZoneToGovernanceDefinition

public void linkZoneToGovernanceDefinition(String userId,
                                           String zoneGUID,
                                           String definitionGUID)
                                    throws InvalidParameterException,
                                           UserNotAuthorizedException,
                                           PropertyServerException

Link a governance zone to a governance definition that controls how the assets in the zone should be governed.

Specified by:

linkZoneToGovernanceDefinition in interface GovernanceZonesInterface

Parameters:

userId - calling user

zoneGUID - unique identifier of the zone

definitionGUID - unique identifier of the governance definition

Throws:

InvalidParameterException - one of the guids is null or not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

unlinkZoneFromGovernanceDefinition

public void unlinkZoneFromGovernanceDefinition(String userId,
                                               String zoneGUID,
                                               String definitionGUID)
                                        throws InvalidParameterException,
                                               UserNotAuthorizedException,
                                               PropertyServerException

Remove the link between a zone and a governance definition.

Specified by:

unlinkZoneFromGovernanceDefinition in interface GovernanceZonesInterface

Parameters:

userId - calling user

zoneGUID - unique identifier of the zone

definitionGUID - unique identifier of the governance definition

Throws:

InvalidParameterException - one of the guids is null or not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

getGovernanceZoneByGUID

public GovernanceZoneElement getGovernanceZoneByGUID(String userId,
                                                     String zoneGUID)
                                              throws InvalidParameterException,
                                                     UserNotAuthorizedException,
                                                     PropertyServerException

Return information about a specific governance zone.

Specified by:

getGovernanceZoneByGUID in interface GovernanceZonesInterface

Parameters:

userId - calling user

zoneGUID - unique identifier for the zone

Returns:

properties of the governance zone

Throws:

InvalidParameterException - zoneGUID or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

getGovernanceZoneByName

public GovernanceZoneElement getGovernanceZoneByName(String userId,
                                                     String qualifiedName)
                                              throws InvalidParameterException,
                                                     UserNotAuthorizedException,
                                                     PropertyServerException

Return information about a specific governance zone.

Specified by:

getGovernanceZoneByName in interface GovernanceZonesInterface

Parameters:

userId - calling user

qualifiedName - unique name for the zone

Returns:

properties of the governance zone

Throws:

InvalidParameterException - qualifiedName or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

getGovernanceZonesForDomain

public List<GovernanceZoneElement> getGovernanceZonesForDomain(String userId,
                                                               int domainIdentifier,
                                                               int startFrom,
                                                               int pageSize)
                                                        throws InvalidParameterException,
                                                               UserNotAuthorizedException,
                                                               PropertyServerException

Return information about the defined governance zones.

Specified by:

getGovernanceZonesForDomain in interface GovernanceZonesInterface

Parameters:

userId - calling user

domainIdentifier - identifier for the desired governance domain - 0 for all

startFrom - paging start point

pageSize - maximum results that can be returned

Returns:

properties of the governance zone

Throws:

InvalidParameterException - qualifiedName or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

getGovernanceZoneDefinitionByGUID

public GovernanceZoneDefinition getGovernanceZoneDefinitionByGUID(String userId,
                                                                  String zoneGUID)
                                                           throws InvalidParameterException,
                                                                  UserNotAuthorizedException,
                                                                  PropertyServerException

Return information about a specific governance zone and its linked governance definitions.

Specified by:

getGovernanceZoneDefinitionByGUID in interface GovernanceZonesInterface

Parameters:

userId - calling user

zoneGUID - unique identifier for the zone

Returns:

properties of the governance zone linked to the associated governance definitions

Throws:

InvalidParameterException - zoneGUID or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem