Package org.odpi.openmetadata.integrationservices.lineage.client

Class LineageIntegrator

java.lang.Object

org.odpi.openmetadata.integrationservices.lineage.client.LineageIntegrator

All Implemented Interfaces:

LineageIntegratorAPI

public class LineageIntegrator
extends Object
implements LineageIntegratorAPI

LineageIntegrator is the client library for the Lineage Integrator OMIS's REST API.

Constructor Summary

Constructors

Constructor	Description
LineageIntegrator(String serverName, String serverPlatformRootURL)	Create a new client with no authentication embedded in the HTTP request.
LineageIntegrator(String serverName, String serverPlatformRootURL, String userId, String password)	Create a new client that passes userId and password in each HTTP request.
LineageIntegrator(String serverName, String serverPlatformRootURL, String userId, String password, AuditLog auditLog)	Create a new client that passes userId and password in each HTTP request.
LineageIntegrator(String serverName, String serverPlatformRootURL, AuditLog auditLog)	Create a new client with no authentication embedded in the HTTP request.

Method Summary

Modifier and Type	Method	Description
void	publishOpenLineageEvent(String userId, io.openlineage.client.OpenLineage.RunEvent event)	Pass an open lineage event to the integration service.
ConnectorType	validateConnector(String userId, String connectorProviderClassName)	Validate the connector and return its connector type.

Methods inherited from class java.lang.Object

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

Constructor Detail

LineageIntegrator

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

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.

LineageIntegrator

public LineageIntegrator(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.

LineageIntegrator

public LineageIntegrator(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.

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.

LineageIntegrator

public LineageIntegrator(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

validateConnector

public ConnectorType validateConnector(String userId,
                                       String connectorProviderClassName)
                                throws InvalidParameterException,
                                       UserNotAuthorizedException,
                                       PropertyServerException

Validate the connector and return its connector type.

Specified by:

validateConnector in interface LineageIntegratorAPI

Parameters:

userId - calling user

connectorProviderClassName - name of a specific connector or null for all connectors

Returns:

connector type for this connector

Throws:

InvalidParameterException - the connector provider class name is not a valid connector fo this service

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - there is a problem processing the request

publishOpenLineageEvent

public void publishOpenLineageEvent(String userId,
                                    io.openlineage.client.OpenLineage.RunEvent event)
                             throws InvalidParameterException,
                                    UserNotAuthorizedException,
                                    PropertyServerException

Pass an open lineage event to the integration service. It will pass it on to the integration connectors that have registered a listener for open lineage events.

Specified by:

publishOpenLineageEvent in interface LineageIntegratorAPI

Parameters:

userId - calling user

event - open lineage event to publish.

Throws:

InvalidParameterException - one of the parameters is null or invalid

UserNotAuthorizedException - the caller is not authorized to call the service

PropertyServerException - there is a problem processing the request