org.odpi.openmetadata.accessservices.assetowner.client

Class AvroFileAssetOwner

java.lang.Object

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

All Implemented Interfaces:

AssetOnboardingAvroFileInterface

public class AvroFileAssetOwner
extends Object
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.

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, String userId, String password) 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.
void	refreshAvroSchemaInCatalog(String userId, String assetGUID) Ensure the schema associated with an Avro file is correct.

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

Method Detail

refreshAvroSchemaInCatalog

public void refreshAvroSchemaInCatalog(String userId,
                                       String assetGUID)
                                throws InvalidParameterException,
                                       UserNotAuthorizedException,
                                       PropertyServerException

Ensure the schema associated with an Avro file is correct.

Specified by:

refreshAvroSchemaInCatalog in interface AssetOnboardingAvroFileInterface

Parameters:

userId - calling user

assetGUID - unique identifier for the Avro file's asset in the catalog

Throws:

InvalidParameterException - full path or assetId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

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