org.apache.nifi.provenance

Interface ProvenanceEventBuilder

public interface ProvenanceEventBuilder

Method Summary

Methods

Modifier and Type	Method and Description
ProvenanceEventBuilder	addChildFlowFile(FlowFile child) Adds the given FlowFile as a child for Events of type ProvenanceEventType#SPAWN, ProvenanceEventType.FORK, ProvenanceEventType.JOIN, and ProvenanceEventType.CLONE This is valid only for null null null null null ProvenanceEventType#SPAWN, ProvenanceEventType.FORK, ProvenanceEventType.JOIN, and ProvenanceEventType.CLONE events and will be ignored for any other event types.
ProvenanceEventBuilder	addParentFlowFile(FlowFile parent) Adds the given FlowFile as a parent for Events of type ProvenanceEventType#SPAWN, ProvenanceEventType.FORK, ProvenanceEventType.JOIN, and ProvenanceEventType.CLONE This is valid only for null null null null null ProvenanceEventType#SPAWN, ProvenanceEventType.FORK, ProvenanceEventType.JOIN, and ProvenanceEventType.CLONE events and will be ignored for any other event types.
ProvenanceEventRecord	build() Builds the Provenance Event.
ProvenanceEventBuilder	fromEvent(ProvenanceEventRecord event) Populates the values of the Event being built from the values in the given event
ProvenanceEventBuilder	fromFlowFile(FlowFile flowFile) Populates the builder with as much information as it can from the given FlowFile
ProvenanceEventBuilder	removeChildFlowFile(FlowFile child) Removes the given FlowFile as a child for Events of type ProvenanceEventType#SPAWN, ProvenanceEventType.FORK, ProvenanceEventType.JOIN, and ProvenanceEventType.CLONE This is valid only for null null null null null ProvenanceEventType#SPAWN, ProvenanceEventType.FORK, ProvenanceEventType.JOIN, and ProvenanceEventType.CLONE events and will be ignored for any other event types.
ProvenanceEventBuilder	removeParentFlowFile(FlowFile parent) Removes the given FlowFile as a parent for Events of type ProvenanceEventType#SPAWN, ProvenanceEventType.FORK, ProvenanceEventType.JOIN, and ProvenanceEventType.CLONE This is valid only for null null null null null ProvenanceEventType#SPAWN, ProvenanceEventType.FORK, ProvenanceEventType.JOIN, and ProvenanceEventType.CLONE events and will be ignored for any other event types.
ProvenanceEventBuilder	setAlternateIdentifierUri(String alternateIdentifierUri) Associates the given identifier with the FlowFile for which this Event is created.
ProvenanceEventBuilder	setAttributes(Map<String,String> previousAttributes, Map<String,String> updatedAttributes) Sets the attributes that existed on the FlowFile before this event occurred and any attributes that were added or updated as a result of this event.
ProvenanceEventBuilder	setComponentId(String componentId) Sets the unique identifier of the NiFi Component (such as a Processor) that is generating the Event
ProvenanceEventBuilder	setComponentType(String componentType) Sets the type of the Component that is generating the Event.
ProvenanceEventBuilder	setCurrentContentClaim(String container, String section, String identifier, Long offset, long size) Sets the Content Claim that the FlowFile is associated with as a result of this event
ProvenanceEventBuilder	setDetails(String details) Sets the details for this event.
ProvenanceEventBuilder	setEventDuration(long millis) Sets the amount of time that was required in order to perform the function referred to by this event
ProvenanceEventBuilder	setEventTime(long eventTime) Sets the time at which the Provenance Event took place
ProvenanceEventBuilder	setEventType(ProvenanceEventType eventType) Sets the type of ProvenanceEventRecord
ProvenanceEventBuilder	setFlowFileEntryDate(long entryDate) Sets the date and time at which the FlowFile entered the flow
ProvenanceEventBuilder	setFlowFileUUID(String uuid) Sets the UUID to associate with the FlowFile
ProvenanceEventBuilder	setLineageIdentifiers(Set<String> lineageIdentifiers) Sets the Lineage Identifiers.
ProvenanceEventBuilder	setLineageStartDate(long startDate) Sets the time at which the FlowFile's lineage began
ProvenanceEventBuilder	setPreviousContentClaim(String container, String section, String identifier, Long offset, long size) Sets the Content Claim that the FlowFile was previously associated with before this event occurred.
ProvenanceEventBuilder	setRelationship(Relationship relationship) Sets the to which the FlowFile was routed for ProvenanceEventType.ROUTE events.
ProvenanceEventBuilder	setSourceQueueIdentifier(String identifier) Sets the identifier of the FlowFile Queue from which the FlowFile was pulled
ProvenanceEventBuilder	setSourceSystemFlowFileIdentifier(String sourceSystemFlowFileIdentifier) Sets the identifier that is used by the remote system to refer to the FlowFile for which this Event is being created.
ProvenanceEventBuilder	setTransitUri(String transitUri) Sets the Transit URI that is used for the Event.

Method Detail

setEventType

ProvenanceEventBuilder setEventType(ProvenanceEventType eventType)

Sets the type of ProvenanceEventRecord

Parameters:

eventType -

Returns:

fromEvent

ProvenanceEventBuilder fromEvent(ProvenanceEventRecord event)

Populates the values of the Event being built from the values in the given event

Parameters:

event - the event from which to populate the Builders values

Returns:

setFlowFileEntryDate

ProvenanceEventBuilder setFlowFileEntryDate(long entryDate)

Sets the date and time at which the FlowFile entered the flow

Parameters:

entryDate -

Returns:

setLineageIdentifiers

ProvenanceEventBuilder setLineageIdentifiers(Set<String> lineageIdentifiers)

Sets the Lineage Identifiers. This is a set of all FlowFile UUID's that were involved in making this event occur.

Parameters:

lineageIdentifiers -

Returns:

setPreviousContentClaim

ProvenanceEventBuilder setPreviousContentClaim(String container,
                                             String section,
                                             String identifier,
                                             Long offset,
                                             long size)

Sets the Content Claim that the FlowFile was previously associated with before this event occurred.

Parameters:

container -

section -

identifier -

offset -

size -

Returns:

setCurrentContentClaim

ProvenanceEventBuilder setCurrentContentClaim(String container,
                                            String section,
                                            String identifier,
                                            Long offset,
                                            long size)

Sets the Content Claim that the FlowFile is associated with as a result of this event

Parameters:

container -

section -

identifier -

offset -

size -

Returns:

setSourceQueueIdentifier

ProvenanceEventBuilder setSourceQueueIdentifier(String identifier)

Sets the identifier of the FlowFile Queue from which the FlowFile was pulled

Parameters:

identifier -

Returns:

setAttributes

ProvenanceEventBuilder setAttributes(Map<String,String> previousAttributes,
                                   Map<String,String> updatedAttributes)

Sets the attributes that existed on the FlowFile before this event occurred and any attributes that were added or updated as a result of this event.

Parameters:

previousAttributes -

updatedAttributes - Map containing all attributes that were added or updated. If any entry has a value of null, that attribute is considered removed

Returns:

setFlowFileUUID

ProvenanceEventBuilder setFlowFileUUID(String uuid)

Sets the UUID to associate with the FlowFile

Parameters:

uuid -

Returns:

setEventTime

ProvenanceEventBuilder setEventTime(long eventTime)

Sets the time at which the Provenance Event took place

Parameters:

eventTime -

Returns:

setEventDuration

ProvenanceEventBuilder setEventDuration(long millis)

Sets the amount of time that was required in order to perform the function referred to by this event

Parameters:

millis -

Returns:

setLineageStartDate

ProvenanceEventBuilder setLineageStartDate(long startDate)

Sets the time at which the FlowFile's lineage began

Parameters:

startDate -

Returns:

setComponentId

ProvenanceEventBuilder setComponentId(String componentId)

Sets the unique identifier of the NiFi Component (such as a Processor) that is generating the Event

Parameters:

componentId -

Returns:

setComponentType

ProvenanceEventBuilder setComponentType(String componentType)

Sets the type of the Component that is generating the Event. For Processors, this is the Simple Class Name of the Processor.

Parameters:

componentType -

Returns:

setSourceSystemFlowFileIdentifier

ProvenanceEventBuilder setSourceSystemFlowFileIdentifier(String sourceSystemFlowFileIdentifier)

Sets the identifier that is used by the remote system to refer to the FlowFile for which this Event is being created. This is valid only for Event Types ProvenanceEventType.RECEIVE and ProvenanceEventType.SEND and will be ignored for any other event types.

Parameters:

sourceSystemFlowFileIdentifier -

Returns:

setTransitUri

ProvenanceEventBuilder setTransitUri(String transitUri)

Sets the Transit URI that is used for the Event. This is a URI that provides information about the System and Protocol information over which the transfer occurred. The intent of this field is such that both the sender and the receiver can publish the events to an external Enterprise-wide system that is then able to correlate the SEND and RECEIVE events. This is valid only for Event Types ProvenanceEventType.RECEIVE and ProvenanceEventType.SEND and will be ignored for any other event types.

Parameters:

transitUri -

Returns:

addParentFlowFile

ProvenanceEventBuilder addParentFlowFile(FlowFile parent)

Adds the given FlowFile as a parent for Events of type ProvenanceEventType#SPAWN, ProvenanceEventType.FORK, ProvenanceEventType.JOIN, and ProvenanceEventType.CLONE This is valid only for null null null null null ProvenanceEventType#SPAWN, ProvenanceEventType.FORK, ProvenanceEventType.JOIN, and ProvenanceEventType.CLONE events and will be ignored for any other event types.

Parameters:

parent -

Returns:

removeParentFlowFile

ProvenanceEventBuilder removeParentFlowFile(FlowFile parent)

Removes the given FlowFile as a parent for Events of type ProvenanceEventType#SPAWN, ProvenanceEventType.FORK, ProvenanceEventType.JOIN, and ProvenanceEventType.CLONE This is valid only for null null null null null ProvenanceEventType#SPAWN, ProvenanceEventType.FORK, ProvenanceEventType.JOIN, and ProvenanceEventType.CLONE events and will be ignored for any other event types.

Parameters:

parent -

Returns:

addChildFlowFile

ProvenanceEventBuilder addChildFlowFile(FlowFile child)

Adds the given FlowFile as a child for Events of type ProvenanceEventType#SPAWN, ProvenanceEventType.FORK, ProvenanceEventType.JOIN, and ProvenanceEventType.CLONE This is valid only for null null null null null ProvenanceEventType#SPAWN, ProvenanceEventType.FORK, ProvenanceEventType.JOIN, and ProvenanceEventType.CLONE events and will be ignored for any other event types.

Parameters:

child -

Returns:

removeChildFlowFile

ProvenanceEventBuilder removeChildFlowFile(FlowFile child)

Removes the given FlowFile as a child for Events of type ProvenanceEventType#SPAWN, ProvenanceEventType.FORK, ProvenanceEventType.JOIN, and ProvenanceEventType.CLONE This is valid only for null null null null null ProvenanceEventType#SPAWN, ProvenanceEventType.FORK, ProvenanceEventType.JOIN, and ProvenanceEventType.CLONE events and will be ignored for any other event types.

Parameters:

child -

Returns:

setAlternateIdentifierUri

ProvenanceEventBuilder setAlternateIdentifierUri(String alternateIdentifierUri)

Associates the given identifier with the FlowFile for which this Event is created. This provides a linkage between the given FlowFile and alternate identifier. This information can be useful if published to an external, enterprise-wide Provenance tracking system that is able to associate the data between different processes or services. This is valid only for ProvenanceEventType.ADDINFO events and will be ignored for any other event types.

Parameters:

alternateIdentifierUri -

Returns:

setDetails

ProvenanceEventBuilder setDetails(String details)

Sets the details for this event. This is a free-form String that can contain any information that is relevant to this event.

Parameters:

details -

Returns:

setRelationship

ProvenanceEventBuilder setRelationship(Relationship relationship)

Sets the to which the FlowFile was routed for ProvenanceEventType.ROUTE events. This is valid only for ProvenanceEventType.ROUTE events and will be ignored for any other event types.

Parameters:

relationship -

Returns:

fromFlowFile

ProvenanceEventBuilder fromFlowFile(FlowFile flowFile)

Populates the builder with as much information as it can from the given FlowFile

Parameters:

flowFile -

Returns:

build

ProvenanceEventRecord build()

Builds the Provenance Event. It is possible that calling ProvenanceEventRecord.getEventId() on the ProvenanceEventRecord that is returned will yield -1. This is because the implementation of the Event may depend on the ProvevenanceEventRepository to generate the unique identifier.

Returns: