org.odpi.openmetadata.commonservices.generichandlers.OperatingPlatformHandler Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of generic-handlers Show documentation
Show all versions of generic-handlers Show documentation
Common services for managing OMAS bean mappings to OMRS API objects as well as
asset visibility through supported zones and calls to the Open Metadata Security Verifier.
/* SPDX-License-Identifier: Apache-2.0 */
/* Copyright Contributors to the ODPi Egeria project. */
package org.odpi.openmetadata.commonservices.generichandlers;
import org.odpi.openmetadata.commonservices.ffdc.InvalidParameterHandler;
import org.odpi.openmetadata.commonservices.repositoryhandler.RepositoryHandler;
import org.odpi.openmetadata.frameworks.auditlog.AuditLog;
import org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException;
import org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException;
import org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException;
import org.odpi.openmetadata.metadatasecurity.server.OpenMetadataServerSecurityVerifier;
import org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.repositoryconnector.OMRSRepositoryHelper;
import java.util.Date;
import java.util.List;
import java.util.Map;
/**
* OperatingPlatformHandler provides the exchange of metadata about operating platforms between the repository and
* the OMAS. Supports external elements and effectivity dates.
*/
public class OperatingPlatformHandler extends OpenMetadataAPIGenericHandler
{
/**
* Construct the operating platform handler with information needed to work with B objects.
*
* @param converter specific converter for this bean class
* @param beanClass name of bean class that is represented by the generic class B
* @param serviceName name of this service
* @param serverName name of the local server
* @param invalidParameterHandler handler for managing parameter errors
* @param repositoryHandler manages calls to the repository services
* @param repositoryHelper provides utilities for manipulating the repository services objects
* @param localServerUserId userId for this server
* @param securityVerifier open metadata security services verifier
* @param supportedZones list of operating platforms that the access service is allowed to serve B instances from.
* @param defaultZones list of operating platforms that the access service should set in all new B instances.
* @param publishZones list of operating platforms that the access service sets up in published B instances.
* @param auditLog destination for audit log events.
*/
public OperatingPlatformHandler(OpenMetadataAPIGenericConverter converter,
Class beanClass,
String serviceName,
String serverName,
InvalidParameterHandler invalidParameterHandler,
RepositoryHandler repositoryHandler,
OMRSRepositoryHelper repositoryHelper,
String localServerUserId,
OpenMetadataServerSecurityVerifier securityVerifier,
List supportedZones,
List defaultZones,
List publishZones,
AuditLog auditLog)
{
super(converter,
beanClass,
serviceName,
serverName,
invalidParameterHandler,
repositoryHandler,
repositoryHelper,
localServerUserId,
securityVerifier,
supportedZones,
defaultZones,
publishZones,
auditLog);
}
/**
* Create a definition of an operating platform.
*
* @param userId calling user
* @param externalSourceGUID guid of the software capability entity that represented the external source - null for local
* @param externalSourceName name of the software capability entity that represented the external source
* @param qualifiedName unique name for the operating platform - used in other configuration
* @param name short display name for the operating platform
* @param description description of the operating platform
* @param operatingSystem the operating system running on this platform
* @param byteOrdering the identifier of the endianness
* @param additionalProperties additional properties for an operating platform
* @param suppliedTypeName type of operatingPlatform
* @param extendedProperties properties for an operating platform subtype
* @param effectiveFrom starting time for this relationship (null for all time)
* @param effectiveTo ending time for this relationship (null for all time)
* @param effectiveTime the time that the retrieved elements must be effective for
* @param methodName calling method
*
* @throws InvalidParameterException qualifiedName or userId is null
* @throws PropertyServerException problem accessing property server
* @throws UserNotAuthorizedException security access problem
*/
public void createOperatingPlatform(String userId,
String externalSourceGUID,
String externalSourceName,
String qualifiedName,
String name,
String description,
String operatingSystem,
int byteOrdering,
Map additionalProperties,
String suppliedTypeName,
Map extendedProperties,
Date effectiveFrom,
Date effectiveTo,
Date effectiveTime,
String methodName) throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException
{
String typeName = OpenMetadataAPIMapper.OPERATING_PLATFORM_TYPE_NAME;
if (suppliedTypeName != null)
{
typeName = suppliedTypeName;
}
String typeGUID = invalidParameterHandler.validateTypeName(typeName,
OpenMetadataAPIMapper.OPERATING_PLATFORM_TYPE_NAME,
serviceName,
methodName,
repositoryHelper);
OperatingPlatformBuilder builder = new OperatingPlatformBuilder(qualifiedName,
name,
description,
operatingSystem,
byteOrdering,
additionalProperties,
typeGUID,
suppliedTypeName,
extendedProperties,
repositoryHelper,
serviceName,
serverName);
builder.setEffectivityDates(effectiveFrom, effectiveTo);
this.createBeanInRepository(userId,
externalSourceGUID,
externalSourceName,
OpenMetadataAPIMapper.OPERATING_PLATFORM_TYPE_GUID,
OpenMetadataAPIMapper.OPERATING_PLATFORM_TYPE_NAME,
builder,
effectiveTime,
methodName);
}
/**
* Update the operating platform.
*
* @param userId calling user
* @param externalSourceGUID guid of the software capability entity that represented the external source - null for local
* @param externalSourceName name of the software capability entity that represented the external source
* @param operatingPlatformGUID unique identifier of the operating platform to update
* @param operatingPlatformGUIDParameterName parameter passing the operatingPlatformGUID
* @param qualifiedName unique name for the operating platform - used in other configuration
* @param name short display name for the operating platform
* @param description description of the governance operating platform
* @param operatingSystem name of the operating system running on the platform
* @param byteOrdering byte ordering used by the hardware
* @param additionalProperties additional properties for a governance operatingPlatform
* @param suppliedTypeName name of subtype or null
* @param extendedProperties properties for a governance operatingPlatform subtype
* @param isMergeUpdate should the properties be merged with existing properties or replace the existing properties?
* @param effectiveFrom starting time for this relationship (null for all time)
* @param effectiveTo ending time for this relationship (null for all time)
* @param forLineage return elements marked with the Memento classification?
* @param forDuplicateProcessing do not merge elements marked as duplicates?
* @param effectiveTime the time that the retrieved elements must be effective for
* @param methodName calling method
*
* @throws InvalidParameterException qualifiedName or userId is null
* @throws PropertyServerException problem accessing property server
* @throws UserNotAuthorizedException security access problem
*/
public void updateOperatingPlatform(String userId,
String externalSourceGUID,
String externalSourceName,
String operatingPlatformGUID,
String operatingPlatformGUIDParameterName,
String qualifiedName,
String name,
String description,
String operatingSystem,
int byteOrdering,
Map additionalProperties,
String suppliedTypeName,
Map extendedProperties,
boolean isMergeUpdate,
Date effectiveFrom,
Date effectiveTo,
boolean forLineage,
boolean forDuplicateProcessing,
Date effectiveTime,
String methodName) throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException
{
final String qualifiedNameParameterName = "qualifiedName";
invalidParameterHandler.validateUserId(userId, methodName);
invalidParameterHandler.validateGUID(operatingPlatformGUID, operatingPlatformGUIDParameterName, methodName);
invalidParameterHandler.validateName(qualifiedName, qualifiedNameParameterName, methodName);
String typeName = OpenMetadataAPIMapper.OPERATING_PLATFORM_TYPE_NAME;
if (suppliedTypeName != null)
{
typeName = suppliedTypeName;
}
String typeGUID = invalidParameterHandler.validateTypeName(typeName,
OpenMetadataAPIMapper.OPERATING_PLATFORM_TYPE_NAME,
serviceName,
methodName,
repositoryHelper);
OperatingPlatformBuilder builder = new OperatingPlatformBuilder(qualifiedName,
name,
description,
operatingSystem,
byteOrdering,
additionalProperties,
typeGUID,
typeName,
extendedProperties,
repositoryHelper,
serviceName,
serverName);
builder.setEffectivityDates(effectiveFrom, effectiveTo);
this.updateBeanInRepository(userId,
externalSourceGUID,
externalSourceName,
operatingPlatformGUID,
operatingPlatformGUIDParameterName,
typeGUID,
typeName,
forLineage,
forDuplicateProcessing,
supportedZones,
builder.getInstanceProperties(methodName),
isMergeUpdate,
effectiveTime,
methodName);
}
/**
* Create a relationship between a host and an operating platform.
*
* @param userId calling user
* @param externalSourceGUID guid of the software capability entity that represented the external source - null for local
* @param externalSourceName name of the software capability entity that represented the external source
* @param hostGUID unique identifier of the host
* @param hostGUIDParameterName parameter supplying the hostGUID
* @param operatingPlatformGUID unique identifier of the operating platform
* @param operatingPlatformGUIDParameterName parameter supplying the operatingPlatformGUID
* @param effectiveFrom starting time for this relationship (null for all time)
* @param effectiveTo ending time for this relationship (null for all time)
* @param forLineage return elements marked with the Memento classification?
* @param forDuplicateProcessing do not merge elements marked as duplicates?
* @param effectiveTime the time that the retrieved elements must be effective for
* @param methodName calling method
*
* @throws InvalidParameterException one of the parameters is invalid
* @throws UserNotAuthorizedException the user is not authorized to issue this request
* @throws PropertyServerException there is a problem reported in the open metadata server(s)
*/
public void setupHostOperatingPlatform(String userId,
String externalSourceGUID,
String externalSourceName,
String hostGUID,
String hostGUIDParameterName,
String operatingPlatformGUID,
String operatingPlatformGUIDParameterName,
Date effectiveFrom,
Date effectiveTo,
boolean forLineage,
boolean forDuplicateProcessing,
Date effectiveTime,
String methodName) throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException
{
this.linkElementToElement(userId,
externalSourceGUID,
externalSourceName,
hostGUID,
hostGUIDParameterName,
OpenMetadataAPIMapper.HOST_TYPE_NAME,
operatingPlatformGUID,
operatingPlatformGUIDParameterName,
OpenMetadataAPIMapper.OPERATING_PLATFORM_TYPE_NAME,
forLineage,
forDuplicateProcessing,
supportedZones,
OpenMetadataAPIMapper.HOST_OPERATING_PLATFORM_TYPE_GUID,
OpenMetadataAPIMapper.HOST_OPERATING_PLATFORM_TYPE_NAME,
null,
effectiveFrom,
effectiveTo,
effectiveTime,
methodName);
}
/**
* Remove a relationship between a host and an operating platform..
*
* @param userId calling user
* @param externalSourceGUID guid of the software capability entity that represented the external source - null for local
* @param externalSourceName name of the software capability entity that represented the external source
* @param hostGUID unique identifier of the host
* @param hostGUIDParameterName parameter supplying the hostGUID
* @param operatingPlatformGUID unique identifier of the operating platform
* @param operatingPlatformGUIDParameterName parameter supplying the operatingPlatformGUID
* @param forLineage return elements marked with the Memento classification?
* @param forDuplicateProcessing do not merge elements marked as duplicates?
* @param effectiveTime the time that the retrieved elements must be effective for (null for any time, new Date() for now)
* @param methodName calling method
*
* @throws InvalidParameterException one of the parameters is invalid
* @throws UserNotAuthorizedException the user is not authorized to issue this request
* @throws PropertyServerException there is a problem reported in the open metadata server(s)
*/
public void clearNestedOperatingPlatform(String userId,
String externalSourceGUID,
String externalSourceName,
String hostGUID,
String hostGUIDParameterName,
String operatingPlatformGUID,
String operatingPlatformGUIDParameterName,
boolean forLineage,
boolean forDuplicateProcessing,
Date effectiveTime,
String methodName) throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException
{
this.unlinkElementFromElement(userId,
false,
externalSourceGUID,
externalSourceName,
hostGUID,
hostGUIDParameterName,
OpenMetadataAPIMapper.HOST_TYPE_NAME,
operatingPlatformGUID,
operatingPlatformGUIDParameterName,
OpenMetadataAPIMapper.OPERATING_PLATFORM_TYPE_GUID,
OpenMetadataAPIMapper.OPERATING_PLATFORM_TYPE_NAME,
forLineage,
forDuplicateProcessing,
OpenMetadataAPIMapper.HOST_OPERATING_PLATFORM_TYPE_GUID,
OpenMetadataAPIMapper.HOST_OPERATING_PLATFORM_TYPE_NAME,
effectiveTime,
methodName);
}
/**
* Remove the metadata element representing a operatingPlatform.
*
* @param userId calling user
* @param externalSourceGUID guid of the software capability entity that represented the external source - null for local
* @param externalSourceName name of the software capability entity that represented the external source
* @param operatingPlatformGUID unique identifier of the metadata element to remove
* @param operatingPlatformGUIDParameterName parameter supplying the operatingPlatformGUID
* @param forLineage return elements marked with the Memento classification?
* @param forDuplicateProcessing do not merge elements marked as duplicates?
* @param effectiveTime the time that the retrieved elements must be effective for (null for any time, new Date() for now)
* @param methodName calling method
*
* @throws InvalidParameterException one of the parameters is invalid
* @throws UserNotAuthorizedException the user is not authorized to issue this request
* @throws PropertyServerException there is a problem reported in the open metadata server(s)
*/
public void removeOperatingPlatform(String userId,
String externalSourceGUID,
String externalSourceName,
String operatingPlatformGUID,
String operatingPlatformGUIDParameterName,
boolean forLineage,
boolean forDuplicateProcessing,
Date effectiveTime,
String methodName) throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException
{
this.deleteBeanInRepository(userId,
externalSourceGUID,
externalSourceName,
operatingPlatformGUID,
operatingPlatformGUIDParameterName,
OpenMetadataAPIMapper.OPERATING_PLATFORM_TYPE_GUID,
OpenMetadataAPIMapper.OPERATING_PLATFORM_TYPE_NAME,
null,
null,
forLineage,
forDuplicateProcessing,
effectiveTime,
methodName);
}
/**
* Return information about a specific operating platform.
*
* @param userId calling user
* @param qualifiedName unique name for the operating platform
* @param qualifiedNameParameter name of parameter supplying the qualifiedName
* @param forLineage return elements marked with the Memento classification?
* @param forDuplicateProcessing do not merge elements marked as duplicates?
* @param effectiveTime the time that the retrieved elements must be effective for (null for any time, new Date() for now)
* @param methodName calling method
*
* @return properties of the operating platform
*
* @throws InvalidParameterException qualifiedName or userId is null
* @throws PropertyServerException problem accessing property server
* @throws UserNotAuthorizedException security access problem
*/
public B getOperatingPlatform(String userId,
String qualifiedName,
String qualifiedNameParameter,
boolean forLineage,
boolean forDuplicateProcessing,
Date effectiveTime,
String methodName) throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException
{
return this.getBeanByUniqueName(userId,
qualifiedName,
qualifiedNameParameter,
OpenMetadataAPIMapper.QUALIFIED_NAME_PROPERTY_NAME,
OpenMetadataAPIMapper.OPERATING_PLATFORM_TYPE_GUID,
OpenMetadataAPIMapper.OPERATING_PLATFORM_TYPE_NAME,
forLineage,
forDuplicateProcessing,
effectiveTime,
methodName);
}
/**
* Return information about the defined operating platforms.
*
* @param userId calling user
* @param startingFrom position in the list (used when there are so many reports that paging is needed
* @param pageSize maximum number of elements to return on this call
* @param effectiveTime the time that the retrieved elements must be effective for
* @param methodName calling method
*
* @return properties of the operating platform
*
* @throws InvalidParameterException qualifiedName or userId is null
* @throws PropertyServerException problem accessing property server
* @throws UserNotAuthorizedException security access problem
*/
public List getOperatingPlatforms(String userId,
int startingFrom,
int pageSize,
Date effectiveTime,
String methodName) throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException
{
return this.getBeansByType(userId,
OpenMetadataAPIMapper.OPERATING_PLATFORM_TYPE_GUID,
OpenMetadataAPIMapper.OPERATING_PLATFORM_TYPE_NAME,
null,
false,
false,
supportedZones,
startingFrom,
pageSize,
effectiveTime,
methodName);
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy