org.apache.nifi.reporting.script

Class ScriptedReportingTask

java.lang.Object

org.apache.nifi.components.AbstractConfigurableComponent

org.apache.nifi.reporting.AbstractReportingTask

org.apache.nifi.reporting.script.ScriptedReportingTask

All Implemented Interfaces:

ConfigurableComponent, ReportingTask

@Tags(value={"reporting","script","execute","groovy","python","jython","jruby","ruby","javascript","js","lua","luaj"})
 @CapabilityDescription(value="Provides reporting and status information to a script. ReportingContext, ComponentLog, and VirtualMachineMetrics objects are made available as variables (context, log, and vmMetrics, respectively) to the script for further processing. The context makes various information available such as events, provenance, bulletins, controller services, process groups, Java Virtual Machine metrics, etc.")
 @DynamicProperty(name="A script engine property to update",
                 value="The value to set it to",
                 expressionLanguageScope=VARIABLE_REGISTRY,
                 description="Updates a script engine property specified by the Dynamic Property\'s key with the value specified by the Dynamic Property\'s value")
 @Restricted(restrictions=@Restriction(requiredPermission=EXECUTE_CODE,explanation="Provides operator the ability to execute arbitrary code assuming all permissions that NiFi has."))
public class ScriptedReportingTask
extends AbstractReportingTask

A Reporting task whose body is provided by a script (via supported JSR-223 script engines)

Field Summary

Fields

Modifier and Type	Field and Description
protected ScriptingComponentHelper	scriptingComponentHelper
private String	scriptToRun
private JmxJvmMetrics	vmMetrics

Constructor Summary

Constructors

Constructor and Description
ScriptedReportingTask()

Method Summary

Modifier and Type	Method and Description
protected Collection<ValidationResult>	customValidate(ValidationContext validationContext)
protected PropertyDescriptor	getSupportedDynamicPropertyDescriptor(String propertyDescriptorName) Returns a PropertyDescriptor for the given name.
protected List<PropertyDescriptor>	getSupportedPropertyDescriptors() Returns a list of property descriptors supported by this processor.
void	onTrigger(ReportingContext context)
void	setup(ConfigurationContext context) Performs setup operations when the processor is scheduled to run.

Methods inherited from class org.apache.nifi.reporting.AbstractReportingTask

getControllerServiceLookup, getIdentifier, getLogger, getName, getNodeTypeProvider, getSchedulingPeriod, init, initialize, setComponentInfo

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

equals, getPropertyDescriptor, getPropertyDescriptors, hashCode, onPropertyModified, toString, 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

scriptingComponentHelper

protected volatile ScriptingComponentHelper scriptingComponentHelper

scriptToRun

private volatile String scriptToRun

vmMetrics

private volatile JmxJvmMetrics vmMetrics

Constructor Detail

ScriptedReportingTask

public ScriptedReportingTask()

Method Detail

getSupportedPropertyDescriptors

protected List<PropertyDescriptor> getSupportedPropertyDescriptors()

Returns a list of property descriptors supported by this processor. The list always includes properties such as script engine name, script file name, script body name, script arguments, and an external module path. If the scripted processor also defines supported properties, those are added to the list as well.

Overrides:

getSupportedPropertyDescriptors in class AbstractConfigurableComponent

Returns:

a List of PropertyDescriptor objects supported by this processor

getSupportedDynamicPropertyDescriptor

protected PropertyDescriptor getSupportedDynamicPropertyDescriptor(String propertyDescriptorName)

Returns a PropertyDescriptor for the given name. This is for the user to be able to define their own properties which will be available as variables in the script

Overrides:

getSupportedDynamicPropertyDescriptor in class AbstractConfigurableComponent

Parameters:

propertyDescriptorName - used to lookup if any property descriptors exist for that name

Returns:

a PropertyDescriptor object corresponding to the specified dynamic property name

customValidate

protected Collection<ValidationResult> customValidate(ValidationContext validationContext)

Overrides:

customValidate in class AbstractConfigurableComponent

setup

@OnScheduled
public void setup(ConfigurationContext context)

Performs setup operations when the processor is scheduled to run. This includes evaluating the processor's properties, as well as reloading the script (from file or the "Script Body" property)

Parameters:

context - the context in which to perform the setup operations

onTrigger

public void onTrigger(ReportingContext context)