org.odpi.openmetadata.accessservices.assetowner.client

Class AvroFileAssetOwner

java.lang.Object

org.odpi.openmetadata.commonservices.ocf.metadatamanagement.client.ConnectedAssetClientBase

org.odpi.openmetadata.accessservices.assetowner.client.AssetOwner

org.odpi.openmetadata.accessservices.assetowner.client.AvroFileAssetOwner

All Implemented Interfaces:

AssetClassificationInterface, AssetDecommissioningInterface, AssetKnowledgeInterface, AssetOnboardingAvroFileInterface, AssetOnboardingInterface, AssetReviewInterface

public class AvroFileAssetOwner
extends AssetOwner
implements AssetOnboardingAvroFileInterface

AvroFileAssetOwner provides specialist methods for working with Avro files. This includes accessing the file and attempting to read the schema to catalog its internal structure. The file is opened client-side so that the metadata server does not need access to the file contents.

Field Summary

Fields inherited from class org.odpi.openmetadata.accessservices.assetowner.client.AssetOwner

restClient

Fields inherited from class org.odpi.openmetadata.commonservices.ocf.metadatamanagement.client.ConnectedAssetClientBase

auditLog, invalidParameterHandler, nullRequestBody, serverName, serverPlatformRootURL

Constructor Summary

Constructors

Constructor and Description
AvroFileAssetOwner(String serverName, String serverPlatformRootURL) Create a new client with no authentication embedded in the HTTP request.
AvroFileAssetOwner(String serverName, String serverPlatformRootURL, AssetOwnerRESTClient restClient, int maxPageSize, AuditLog auditLog) Create a new client that is going to be used in an OMAG Server (view service or integration service typically).
AvroFileAssetOwner(String serverName, String serverPlatformRootURL, AuditLog auditLog) Create a new client with no authentication embedded in the HTTP request and an audit log.
AvroFileAssetOwner(String serverName, String serverPlatformRootURL, String userId, String password) Create a new client that passes userId and password in each HTTP request.
AvroFileAssetOwner(String serverName, String serverPlatformRootURL, String userId, String password, AuditLog auditLog) Create a new client that passes userId and password in each HTTP request.

Method Summary

Modifier and Type	Method and Description
List<String>	addAvroFileToCatalog(String userId, String displayName, String description, String fullPath) Add a simple asset description linked to a connection object for a Avro file.

Methods inherited from class org.odpi.openmetadata.accessservices.assetowner.client.AssetOwner

addAssetOrigin, addAssetToCatalog, addAssetToCatalog, addCombinedSchemaToAsset, addConnectionToAsset, addSchemaAttribute, addSchemaAttributes, addSchemaTypeToAsset, addSecurityTags, addSemanticAssignment, attachSchemaTypeToAsset, deleteAsset, deleteAssetSchemaType, detachSchemaTypeFromAsset, findAssets, getAssetProperties, getAssetsByName, getAssetSummary, getConnectorToAsset, getDiscoveryAnalysisReports, getDiscoveryReportAnnotations, getExtendedAnnotations, getTypesOfAnnotation, getTypesOfAnnotationWithDescriptions, getTypesOfAsset, getTypesOfAssetWithDescriptions, publishAsset, removeAssetOrigin, removeSecurityTags, removeSemanticAssignment, updateAssetOwner, updateAssetZones, withdrawAsset

Methods inherited from class org.odpi.openmetadata.commonservices.ocf.metadatamanagement.client.ConnectedAssetClientBase

getAssetForConnection, getAssetProperties, getAssetSummary, getConnectionByGUID, getConnectionByName, getConnectionForAsset, getConnectorForConnection

Methods inherited from class java.lang.Object

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

Constructor Detail

AvroFileAssetOwner

public AvroFileAssetOwner(String serverName,
                          String serverPlatformRootURL,
                          AuditLog auditLog)
                   throws InvalidParameterException

Create a new client with no authentication embedded in the HTTP request and an audit log.

Parameters:

serverName - name of the server to connect to

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

auditLog - logging destination

Throws:

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

AvroFileAssetOwner

public AvroFileAssetOwner(String serverName,
                          String serverPlatformRootURL)
                   throws InvalidParameterException

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

Parameters:

serverName - name of the server to connect to

serverPlatformRootURL - 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.

AvroFileAssetOwner

public AvroFileAssetOwner(String serverName,
                          String serverPlatformRootURL,
                          String userId,
                          String password,
                          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. There is also an audit log destination.

Parameters:

serverName - name of the server to connect to

serverPlatformRootURL - 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

auditLog - logging destination

Throws:

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

AvroFileAssetOwner

public AvroFileAssetOwner(String serverName,
                          String serverPlatformRootURL,
                          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

serverPlatformRootURL - 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.

AvroFileAssetOwner

public AvroFileAssetOwner(String serverName,
                          String serverPlatformRootURL,
                          AssetOwnerRESTClient restClient,
                          int maxPageSize,
                          AuditLog auditLog)
                   throws InvalidParameterException

Create a new client that is going to be used in an OMAG Server (view service or integration service typically).

Parameters:

serverName - name of the server to connect to

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

restClient - client that issues the REST API calls

maxPageSize - maximum number of results supported by this server

auditLog - logging destination

Throws:

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

Method Detail

addAvroFileToCatalog

public List<String> addAvroFileToCatalog(String userId,
                                         String displayName,
                                         String description,
                                         String fullPath)
                                  throws InvalidParameterException,
                                         UserNotAuthorizedException,
                                         PropertyServerException

Add a simple asset description linked to a connection object for a Avro file.

Specified by:

addAvroFileToCatalog in interface AssetOnboardingAvroFileInterface

Parameters:

userId - calling user (assumed to be the owner)

displayName - display name for the file in the catalog

description - description of the file in the catalog

fullPath - full path of the file - used to access the file through the connector

Returns:

list of GUIDs from the top level to the root of the pathname

Throws:

InvalidParameterException - full path or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem