org.apache.nifi.processors.standard

Class ExecuteStreamCommand

java.lang.Object

org.apache.nifi.components.AbstractConfigurableComponent

org.apache.nifi.processor.AbstractSessionFactoryProcessor

org.apache.nifi.processor.AbstractProcessor

org.apache.nifi.processors.standard.ExecuteStreamCommand

All Implemented Interfaces:

ConfigurableComponent, Processor

@EventDriven
@SupportsBatching
@Tags(value={"command execution","command","stream","execute"})
@CapabilityDescription(value="Executes an external command on the contents of a flow file, and creates a new flow file with the results of the command.")
public class ExecuteStreamCommand
extends AbstractProcessor

This processor executes an external command on the contents of a flow file, and creates a new flow file with the results of the command.

Properties:

• Command Path
  • Specifies the command to be executed; if just the name of an executable is provided, it must be in the user's environment PATH.
  • Default value: none
  • Supports expression language: true
• Command Arguments
  • The arguments to supply to the executable delimited by the ';' character. Each argument may be an Expression Language statement.
  • Default value: none
  • Supports expression language: true
• Working Directory
  • The directory to use as the current working directory when executing the command
  • Default value: none (which means whatever NiFi's current working directory is...probably the root of the NiFi installation directory.)
  • Supports expression language: true

Relationships:

• original
  • The destination path for the original incoming flow file
• output-stream
  • The destination path for the flow file created from the command's output

Author:

unattributed

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static class	ExecuteStreamCommand.StdInWriterCallback

Field Summary

Fields

Modifier and Type	Field and Description
private static Validator	ATTRIBUTE_EXPRESSION_LANGUAGE_VALIDATOR
(package private) static PropertyDescriptor	EXECUTION_ARGUMENTS
(package private) static PropertyDescriptor	EXECUTION_COMMAND
private ProcessorLog	logger
static Relationship	ORIGINAL_RELATIONSHIP
static Relationship	OUTPUT_STREAM_RELATIONSHIP
private static List<PropertyDescriptor>	PROPERTIES
private static Set<Relationship>	RELATIONSHIPS
(package private) static PropertyDescriptor	WORKING_DIR

Constructor Summary

Constructors

Constructor and Description
ExecuteStreamCommand()

Method Summary

Methods

Modifier and Type	Method and Description
Set<Relationship>	getRelationships()
List<PropertyDescriptor>	getSupportedPropertyDescriptors()
protected void	init(ProcessorInitializationContext context)
void	onTrigger(ProcessContext context, ProcessSession session)

Methods inherited from class org.apache.nifi.processor.AbstractProcessor

onTrigger

Methods inherited from class org.apache.nifi.processor.AbstractSessionFactoryProcessor

getControllerServiceLookup, getIdentifier, getLogger, initialize, isScheduled, toString, updateScheduledFalse, updateScheduledTrue

Methods inherited from class org.apache.nifi.components.AbstractConfigurableComponent

customValidate, equals, getPropertyDescriptor, getPropertyDescriptors, getSupportedDynamicPropertyDescriptor, hashCode, onPropertyModified, validate

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.nifi.components.ConfigurableComponent

getPropertyDescriptor, getPropertyDescriptors, onPropertyModified, validate

Field Detail

ORIGINAL_RELATIONSHIP

public static final Relationship ORIGINAL_RELATIONSHIP

OUTPUT_STREAM_RELATIONSHIP

public static final Relationship OUTPUT_STREAM_RELATIONSHIP

RELATIONSHIPS

private static final Set<Relationship> RELATIONSHIPS

ATTRIBUTE_EXPRESSION_LANGUAGE_VALIDATOR

private static final Validator ATTRIBUTE_EXPRESSION_LANGUAGE_VALIDATOR

EXECUTION_COMMAND

static final PropertyDescriptor EXECUTION_COMMAND

EXECUTION_ARGUMENTS

static final PropertyDescriptor EXECUTION_ARGUMENTS

WORKING_DIR

static final PropertyDescriptor WORKING_DIR

PROPERTIES

private static final List<PropertyDescriptor> PROPERTIES

logger

private ProcessorLog logger

Constructor Detail

ExecuteStreamCommand

public ExecuteStreamCommand()

Method Detail

getRelationships

public Set<Relationship> getRelationships()

Specified by:

getRelationships in interface Processor

Overrides:

getRelationships in class AbstractSessionFactoryProcessor

init

protected void init(ProcessorInitializationContext context)

Overrides:

init in class AbstractSessionFactoryProcessor

getSupportedPropertyDescriptors

public List<PropertyDescriptor> getSupportedPropertyDescriptors()

Overrides:

getSupportedPropertyDescriptors in class AbstractConfigurableComponent

onTrigger

public void onTrigger(ProcessContext context,
             ProcessSession session)
               throws ProcessException

Specified by:

onTrigger in class AbstractProcessor

Throws:

ProcessException