org.odpi.openmetadata.accessservices.assetlineage.outtopic

Class AssetLineagePublisher

java.lang.Object

org.odpi.openmetadata.accessservices.assetlineage.outtopic.AssetLineagePublisher

public class AssetLineagePublisher
extends Object

AssetLineagePublisher is the connector responsible for publishing lineage context information about new and changed assets.

Constructor Summary

Constructors

Constructor and Description
AssetLineagePublisher(OpenMetadataTopicConnector outTopicConnector, String serverName, String serverUserName) The constructor is given the connection to the out topic for Asset Lineage OMAS along with classes for testing and manipulating instances.

Method Summary

Modifier and Type	Method and Description
boolean	isEntityEligibleForPublishing(EntityDetail entityDetail) Checks if the entity is eligible to be send in a lineage event.
void	publishClassificationContext(EntityDetail entityDetail, AssetLineageEventType assetLineageEventType)
void	publishEvent(AssetLineageEventHeader event) Output a new asset event.
Map<String,Set<GraphContext>>	publishGlossaryContext(EntityDetail entityDetail) Build the context for a Glossary Term and publishes the event to the out topic
void	publishGlossaryContext(String glossaryTermGUID) Build the context for a Glossary Term based on the glossary term GUID and publishes the event to the out topic
void	publishLineageEntityEvent(LineageEntity lineageEntity, AssetLineageEventType lineageEventType) Publish lineage entity event
void	publishLineageRelationshipEvent(LineageRelationship lineageRelationship, AssetLineageEventType eventType) Publishes a LineageRelationshipEvent containing a LineageRelationship
Map<String,Set<GraphContext>>	publishProcessContext(EntityDetail entityDetail) Takes the context for a Process and publishes the event to the output topic

Methods inherited from class java.lang.Object

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

Constructor Detail

AssetLineagePublisher

public AssetLineagePublisher(OpenMetadataTopicConnector outTopicConnector,
                             String serverName,
                             String serverUserName)
                      throws OCFCheckedExceptionBase

The constructor is given the connection to the out topic for Asset Lineage OMAS along with classes for testing and manipulating instances.

Parameters:

outTopicConnector - connection to the out topic

serverName - name of the user of the server instance

serverUserName - name of this server instance

Throws:

OCFCheckedExceptionBase

Method Detail

publishProcessContext

public Map<String,Set<GraphContext>> publishProcessContext(EntityDetail entityDetail)
                                                    throws OCFCheckedExceptionBase,
                                                           com.fasterxml.jackson.core.JsonProcessingException

Takes the context for a Process and publishes the event to the output topic

Parameters:

entityDetail - entity to get context

Throws:

OCFCheckedExceptionBase - checked exception for reporting errors found when using OCF connectors

com.fasterxml.jackson.core.JsonProcessingException - exception parsing the event json

publishGlossaryContext

public void publishGlossaryContext(String glossaryTermGUID)
                            throws OCFCheckedExceptionBase,
                                   com.fasterxml.jackson.core.JsonProcessingException

Build the context for a Glossary Term based on the glossary term GUID and publishes the event to the out topic

Parameters:

glossaryTermGUID - glossary term GUID to get context

Throws:

OCFCheckedExceptionBase - checked exception for reporting errors found when using OCF connectors

com.fasterxml.jackson.core.JsonProcessingException - exception parsing the event json

publishGlossaryContext

public Map<String,Set<GraphContext>> publishGlossaryContext(EntityDetail entityDetail)
                                                     throws OCFCheckedExceptionBase,
                                                            com.fasterxml.jackson.core.JsonProcessingException

Build the context for a Glossary Term and publishes the event to the out topic

Parameters:

entityDetail - glossary term to get context

Returns:

the Glossary Term context

Throws:

OCFCheckedExceptionBase - checked exception for reporting errors found when using OCF connectors

com.fasterxml.jackson.core.JsonProcessingException - exception parsing the event json

publishClassificationContext

public void publishClassificationContext(EntityDetail entityDetail,
                                         AssetLineageEventType assetLineageEventType)
                                  throws OCFCheckedExceptionBase,
                                         com.fasterxml.jackson.core.JsonProcessingException

Parameters:

entityDetail - entity to get context

assetLineageEventType - event type to get published

Throws:

OCFCheckedExceptionBase - checked exception for reporting errors found when using OCF connectors

com.fasterxml.jackson.core.JsonProcessingException - exception parsing the event json

publishLineageRelationshipEvent

public void publishLineageRelationshipEvent(LineageRelationship lineageRelationship,
                                            AssetLineageEventType eventType)
                                     throws ConnectorCheckedException,
                                            com.fasterxml.jackson.core.JsonProcessingException

Publishes a LineageRelationshipEvent containing a LineageRelationship

Parameters:

lineageRelationship - the LineageRelationship to be published

eventType - the type on the event

Throws:

ConnectorCheckedException - unable to send the event due to connectivity issue

com.fasterxml.jackson.core.JsonProcessingException - exception parsing the event json

publishEvent

public void publishEvent(AssetLineageEventHeader event)
                  throws com.fasterxml.jackson.core.JsonProcessingException,
                         ConnectorCheckedException

Output a new asset event.

Parameters:

event - event to send

Throws:

ConnectorCheckedException - unable to send the event due to connectivity issue

com.fasterxml.jackson.core.JsonProcessingException - exception parsing the event json

publishLineageEntityEvent

public void publishLineageEntityEvent(LineageEntity lineageEntity,
                                      AssetLineageEventType lineageEventType)
                               throws ConnectorCheckedException,
                                      com.fasterxml.jackson.core.JsonProcessingException

Publish lineage entity event

Parameters:

lineageEntity - - lineage entity

lineageEventType - - lineage event type

Throws:

ConnectorCheckedException - unable to send the event due to connectivity issue

com.fasterxml.jackson.core.JsonProcessingException - exception parsing the event json

isEntityEligibleForPublishing

public boolean isEntityEligibleForPublishing(EntityDetail entityDetail)
                                      throws UserNotAuthorizedException,
                                             PropertyServerException

Checks if the entity is eligible to be send in a lineage event. The GlossaryTerm and GlossaryCategory entities are send out if has SemanticAssignment and/or TermCategorization relationships

Parameters:

entityDetail - entity to be checked

Returns:

true if the entity has the lineage relationships created

Throws:

UserNotAuthorizedException - security access problem

PropertyServerException - problem accessing property server