mirror of https://github.com/apache/nifi.git
NIFI-280 This closes #19 Updated poms for versions after merge. Minor doc removals. Awesome PR!
This commit is contained in:
parent
cadfc679d8
commit
e9d31f5d99
|
@ -181,6 +181,11 @@ The following binary components are provided under the Apache Software License v
|
||||||
Apache log4j
|
Apache log4j
|
||||||
Copyright 2007 The Apache Software Foundation
|
Copyright 2007 The Apache Software Foundation
|
||||||
|
|
||||||
|
(ASLv2) Apache Tika
|
||||||
|
The following NOTICE information applies:
|
||||||
|
Apache Tika Core
|
||||||
|
Copyright 2007-2015 The Apache Software Foundation
|
||||||
|
|
||||||
(ASLv2) Apache Commons Configuration
|
(ASLv2) Apache Commons Configuration
|
||||||
The following NOTICE information applies:
|
The following NOTICE information applies:
|
||||||
Apache Commons Configuration
|
Apache Commons Configuration
|
||||||
|
|
|
@ -16,7 +16,7 @@
|
||||||
<parent>
|
<parent>
|
||||||
<groupId>org.apache.nifi</groupId>
|
<groupId>org.apache.nifi</groupId>
|
||||||
<artifactId>nifi-framework</artifactId>
|
<artifactId>nifi-framework</artifactId>
|
||||||
<version>0.0.2-incubating-SNAPSHOT</version>
|
<version>0.1.0-incubating-SNAPSHOT</version>
|
||||||
</parent>
|
</parent>
|
||||||
<artifactId>nifi-documentation</artifactId>
|
<artifactId>nifi-documentation</artifactId>
|
||||||
<dependencies>
|
<dependencies>
|
||||||
|
|
|
@ -87,11 +87,9 @@ public class DocGenerator {
|
||||||
* check to see if an "additionalDetails.html" file exists and will link
|
* check to see if an "additionalDetails.html" file exists and will link
|
||||||
* that from the generated documentation.
|
* that from the generated documentation.
|
||||||
*
|
*
|
||||||
* @param docsDir
|
* @param docsDir the work\docs\components dir to stick component
|
||||||
* the work\docs\components dir to stick component documentation
|
* documentation in
|
||||||
* in
|
* @param componentClass the class to document
|
||||||
* @param componentClass
|
|
||||||
* the class to document
|
|
||||||
* @throws InstantiationException
|
* @throws InstantiationException
|
||||||
* @throws IllegalAccessException
|
* @throws IllegalAccessException
|
||||||
* @throws IOException
|
* @throws IOException
|
||||||
|
@ -123,8 +121,7 @@ public class DocGenerator {
|
||||||
* Returns the DocumentationWriter for the type of component. Currently
|
* Returns the DocumentationWriter for the type of component. Currently
|
||||||
* Processor, ControllerService, and ReportingTask are supported.
|
* Processor, ControllerService, and ReportingTask are supported.
|
||||||
*
|
*
|
||||||
* @param componentClass
|
* @param componentClass the class that requires a DocumentationWriter
|
||||||
* the class that requires a DocumentationWriter
|
|
||||||
* @return a DocumentationWriter capable of generating documentation for
|
* @return a DocumentationWriter capable of generating documentation for
|
||||||
* that specific type of class
|
* that specific type of class
|
||||||
*/
|
*/
|
||||||
|
@ -144,8 +141,8 @@ public class DocGenerator {
|
||||||
* Returns a ConfigurableComponentInitializer for the type of component.
|
* Returns a ConfigurableComponentInitializer for the type of component.
|
||||||
* Currently Processor, ControllerService and ReportingTask are supported.
|
* Currently Processor, ControllerService and ReportingTask are supported.
|
||||||
*
|
*
|
||||||
* @param componentClass
|
* @param componentClass the class that requires a
|
||||||
* the class that requires a ConfigurableComponentInitializer
|
* ConfigurableComponentInitializer
|
||||||
* @return a ConfigurableComponentInitializer capable of initializing that
|
* @return a ConfigurableComponentInitializer capable of initializing that
|
||||||
* specific type of class
|
* specific type of class
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -70,12 +70,10 @@ public class HtmlDocumentationWriter implements DocumentationWriter {
|
||||||
/**
|
/**
|
||||||
* Writes the head portion of the HTML documentation.
|
* Writes the head portion of the HTML documentation.
|
||||||
*
|
*
|
||||||
* @param configurableComponent
|
* @param configurableComponent the component to describe
|
||||||
* the component to describe
|
* @param xmlStreamWriter the stream to write to
|
||||||
* @param xmlStreamWriter
|
* @throws XMLStreamException thrown if there was a problem writing to the
|
||||||
* the stream to write to
|
* stream
|
||||||
* @throws XMLStreamException
|
|
||||||
* thrown if there was a problem writing to the stream
|
|
||||||
*/
|
*/
|
||||||
protected void writeHead(final ConfigurableComponent configurableComponent,
|
protected void writeHead(final ConfigurableComponent configurableComponent,
|
||||||
final XMLStreamWriter xmlStreamWriter) throws XMLStreamException {
|
final XMLStreamWriter xmlStreamWriter) throws XMLStreamException {
|
||||||
|
@ -97,8 +95,7 @@ public class HtmlDocumentationWriter implements DocumentationWriter {
|
||||||
/**
|
/**
|
||||||
* Gets the class name of the component.
|
* Gets the class name of the component.
|
||||||
*
|
*
|
||||||
* @param configurableComponent
|
* @param configurableComponent the component to describe
|
||||||
* the component to describe
|
|
||||||
* @return the class name of the component
|
* @return the class name of the component
|
||||||
*/
|
*/
|
||||||
protected String getTitle(final ConfigurableComponent configurableComponent) {
|
protected String getTitle(final ConfigurableComponent configurableComponent) {
|
||||||
|
@ -109,16 +106,14 @@ public class HtmlDocumentationWriter implements DocumentationWriter {
|
||||||
* Writes the body section of the documentation, this consists of the
|
* Writes the body section of the documentation, this consists of the
|
||||||
* component description, the tags, and the PropertyDescriptors.
|
* component description, the tags, and the PropertyDescriptors.
|
||||||
*
|
*
|
||||||
* @param configurableComponent
|
* @param configurableComponent the component to describe
|
||||||
* the component to describe
|
* @param xmlStreamWriter the stream writer
|
||||||
* @param xmlStreamWriter
|
* @param hasAdditionalDetails whether there are additional details present
|
||||||
* the stream writer
|
* or not
|
||||||
* @param hasAdditionalDetails
|
* @throws XMLStreamException thrown if there was a problem writing to the
|
||||||
* whether there are additional details present or not
|
* XML stream
|
||||||
* @throws XMLStreamException
|
|
||||||
* thrown if there was a problem writing to the XML stream
|
|
||||||
*/
|
*/
|
||||||
private final void writeBody(final ConfigurableComponent configurableComponent,
|
private void writeBody(final ConfigurableComponent configurableComponent,
|
||||||
final XMLStreamWriter xmlStreamWriter, final boolean hasAdditionalDetails)
|
final XMLStreamWriter xmlStreamWriter, final boolean hasAdditionalDetails)
|
||||||
throws XMLStreamException {
|
throws XMLStreamException {
|
||||||
xmlStreamWriter.writeStartElement("body");
|
xmlStreamWriter.writeStartElement("body");
|
||||||
|
@ -133,12 +128,10 @@ public class HtmlDocumentationWriter implements DocumentationWriter {
|
||||||
* This method may be overridden by sub classes to write additional
|
* This method may be overridden by sub classes to write additional
|
||||||
* information to the body of the documentation.
|
* information to the body of the documentation.
|
||||||
*
|
*
|
||||||
* @param configurableComponent
|
* @param configurableComponent the component to describe
|
||||||
* the component to describe
|
* @param xmlStreamWriter the stream writer
|
||||||
* @param xmlStreamWriter
|
* @throws XMLStreamException thrown if there was a problem writing to the
|
||||||
* the stream writer
|
* XML stream
|
||||||
* @throws XMLStreamException
|
|
||||||
* thrown if there was a problem writing to the XML stream
|
|
||||||
*/
|
*/
|
||||||
protected void writeAdditionalBodyInfo(final ConfigurableComponent configurableComponent,
|
protected void writeAdditionalBodyInfo(final ConfigurableComponent configurableComponent,
|
||||||
final XMLStreamWriter xmlStreamWriter) throws XMLStreamException {
|
final XMLStreamWriter xmlStreamWriter) throws XMLStreamException {
|
||||||
|
@ -171,15 +164,12 @@ public class HtmlDocumentationWriter implements DocumentationWriter {
|
||||||
/**
|
/**
|
||||||
* Writes a description of the configurable component.
|
* Writes a description of the configurable component.
|
||||||
*
|
*
|
||||||
* @param configurableComponent
|
* @param configurableComponent the component to describe
|
||||||
* the component to describe
|
* @param xmlStreamWriter the stream writer
|
||||||
* @param xmlStreamWriter
|
* @param hasAdditionalDetails whether there are additional details
|
||||||
* the stream writer
|
* available as 'additionalDetails.html'
|
||||||
* @param hasAdditionalDetails
|
* @throws XMLStreamException thrown if there was a problem writing to the
|
||||||
* whether there are additional details available as
|
* XML stream
|
||||||
* 'additionalDetails.html'
|
|
||||||
* @throws XMLStreamException
|
|
||||||
* thrown if there was a problem writing to the XML stream
|
|
||||||
*/
|
*/
|
||||||
protected void writeDescription(final ConfigurableComponent configurableComponent,
|
protected void writeDescription(final ConfigurableComponent configurableComponent,
|
||||||
final XMLStreamWriter xmlStreamWriter, final boolean hasAdditionalDetails)
|
final XMLStreamWriter xmlStreamWriter, final boolean hasAdditionalDetails)
|
||||||
|
@ -199,8 +189,7 @@ public class HtmlDocumentationWriter implements DocumentationWriter {
|
||||||
* Gets a description of the ConfigurableComponent using the
|
* Gets a description of the ConfigurableComponent using the
|
||||||
* CapabilityDescription annotation.
|
* CapabilityDescription annotation.
|
||||||
*
|
*
|
||||||
* @param configurableComponent
|
* @param configurableComponent the component to describe
|
||||||
* the component to describe
|
|
||||||
* @return a description of the configurableComponent
|
* @return a description of the configurableComponent
|
||||||
*/
|
*/
|
||||||
protected String getDescription(final ConfigurableComponent configurableComponent) {
|
protected String getDescription(final ConfigurableComponent configurableComponent) {
|
||||||
|
@ -220,12 +209,10 @@ public class HtmlDocumentationWriter implements DocumentationWriter {
|
||||||
/**
|
/**
|
||||||
* Writes the PropertyDescriptors out as a table.
|
* Writes the PropertyDescriptors out as a table.
|
||||||
*
|
*
|
||||||
* @param configurableComponent
|
* @param configurableComponent the component to describe
|
||||||
* the component to describe
|
* @param xmlStreamWriter the stream writer
|
||||||
* @param xmlStreamWriter
|
* @throws XMLStreamException thrown if there was a problem writing to the
|
||||||
* the stream writer
|
* XML Stream
|
||||||
* @throws XMLStreamException
|
|
||||||
* thrown if there was a problem writing to the XML Stream
|
|
||||||
*/
|
*/
|
||||||
protected void writeProperties(final ConfigurableComponent configurableComponent,
|
protected void writeProperties(final ConfigurableComponent configurableComponent,
|
||||||
final XMLStreamWriter xmlStreamWriter) throws XMLStreamException {
|
final XMLStreamWriter xmlStreamWriter) throws XMLStreamException {
|
||||||
|
@ -247,7 +234,6 @@ public class HtmlDocumentationWriter implements DocumentationWriter {
|
||||||
xmlStreamWriter.writeCharacters(".");
|
xmlStreamWriter.writeCharacters(".");
|
||||||
xmlStreamWriter.writeEndElement();
|
xmlStreamWriter.writeEndElement();
|
||||||
|
|
||||||
|
|
||||||
List<PropertyDescriptor> properties = configurableComponent.getPropertyDescriptors();
|
List<PropertyDescriptor> properties = configurableComponent.getPropertyDescriptors();
|
||||||
if (properties.size() > 0) {
|
if (properties.size() > 0) {
|
||||||
xmlStreamWriter.writeStartElement("table");
|
xmlStreamWriter.writeStartElement("table");
|
||||||
|
@ -319,12 +305,10 @@ public class HtmlDocumentationWriter implements DocumentationWriter {
|
||||||
* Interrogates a PropertyDescriptor to get a list of AllowableValues, if
|
* Interrogates a PropertyDescriptor to get a list of AllowableValues, if
|
||||||
* there are none, nothing is written to the stream.
|
* there are none, nothing is written to the stream.
|
||||||
*
|
*
|
||||||
* @param xmlStreamWriter
|
* @param xmlStreamWriter the stream writer to use
|
||||||
* the stream writer to use
|
* @param property the property to describe
|
||||||
* @param property
|
* @throws XMLStreamException thrown if there was a problem writing to the
|
||||||
* the property to describe
|
* XML Stream
|
||||||
* @throws XMLStreamException
|
|
||||||
* thrown if there was a problem writing to the XML Stream
|
|
||||||
*/
|
*/
|
||||||
protected void writeValidValues(XMLStreamWriter xmlStreamWriter, PropertyDescriptor property)
|
protected void writeValidValues(XMLStreamWriter xmlStreamWriter, PropertyDescriptor property)
|
||||||
throws XMLStreamException {
|
throws XMLStreamException {
|
||||||
|
@ -353,16 +337,12 @@ public class HtmlDocumentationWriter implements DocumentationWriter {
|
||||||
* Writes a begin element, then text, then end element for the element of a
|
* Writes a begin element, then text, then end element for the element of a
|
||||||
* users choosing. Example: <p>text</p>
|
* users choosing. Example: <p>text</p>
|
||||||
*
|
*
|
||||||
* @param writer
|
* @param writer the stream writer to use
|
||||||
* the stream writer to use
|
* @param elementName the name of the element
|
||||||
* @param elementName
|
* @param characters the characters to insert into the element
|
||||||
* the name of the element
|
* @param strong whether the characters should be strong or not.
|
||||||
* @param characters
|
* @throws XMLStreamException thrown if there was a problem writing to the
|
||||||
* the characters to insert into the element
|
* stream.
|
||||||
* @param strong
|
|
||||||
* whether the characters should be strong or not.
|
|
||||||
* @throws XMLStreamException
|
|
||||||
* thrown if there was a problem writing to the stream.
|
|
||||||
*/
|
*/
|
||||||
protected final static void writeSimpleElement(final XMLStreamWriter writer, final String elementName,
|
protected final static void writeSimpleElement(final XMLStreamWriter writer, final String elementName,
|
||||||
final String characters, boolean strong) throws XMLStreamException {
|
final String characters, boolean strong) throws XMLStreamException {
|
||||||
|
@ -381,14 +361,11 @@ public class HtmlDocumentationWriter implements DocumentationWriter {
|
||||||
* Writes a begin element, then text, then end element for the element of a
|
* Writes a begin element, then text, then end element for the element of a
|
||||||
* users choosing. Example: <p>text</p>
|
* users choosing. Example: <p>text</p>
|
||||||
*
|
*
|
||||||
* @param writer
|
* @param writer the stream writer to use
|
||||||
* the stream writer to use
|
* @param elementName the name of the element
|
||||||
* @param elementName
|
* @param characters the characters to insert into the element
|
||||||
* the name of the element
|
* @throws XMLStreamException thrown if there was a problem writing to the
|
||||||
* @param characters
|
* stream
|
||||||
* the characters to insert into the element
|
|
||||||
* @throws XMLStreamException
|
|
||||||
* thrown if there was a problem writing to the stream
|
|
||||||
*/
|
*/
|
||||||
protected final static void writeSimpleElement(final XMLStreamWriter writer, final String elementName,
|
protected final static void writeSimpleElement(final XMLStreamWriter writer, final String elementName,
|
||||||
final String characters) throws XMLStreamException {
|
final String characters) throws XMLStreamException {
|
||||||
|
@ -398,14 +375,11 @@ public class HtmlDocumentationWriter implements DocumentationWriter {
|
||||||
/**
|
/**
|
||||||
* A helper method to write a link
|
* A helper method to write a link
|
||||||
*
|
*
|
||||||
* @param xmlStreamWriter
|
* @param xmlStreamWriter the stream to write to
|
||||||
* the stream to write to
|
* @param text the text of the link
|
||||||
* @param text
|
* @param location the location of the link
|
||||||
* the text of the link
|
* @throws XMLStreamException thrown if there was a problem writing to the
|
||||||
* @param location
|
* stream
|
||||||
* the location of the link
|
|
||||||
* @throws XMLStreamException
|
|
||||||
* thrown if there was a problem writing to the stream
|
|
||||||
*/
|
*/
|
||||||
protected void writeLink(final XMLStreamWriter xmlStreamWriter, final String text, final String location)
|
protected void writeLink(final XMLStreamWriter xmlStreamWriter, final String text, final String location)
|
||||||
throws XMLStreamException {
|
throws XMLStreamException {
|
||||||
|
|
|
@ -1,3 +1,19 @@
|
||||||
|
/*
|
||||||
|
* Licensed to the Apache Software Foundation (ASF) under one or more
|
||||||
|
* contributor license agreements. See the NOTICE file distributed with
|
||||||
|
* this work for additional information regarding copyright ownership.
|
||||||
|
* The ASF licenses this file to You under the Apache License, Version 2.0
|
||||||
|
* (the "License"); you may not use this file except in compliance with
|
||||||
|
* the License. You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*/
|
||||||
package org.apache.nifi.documentation.example;
|
package org.apache.nifi.documentation.example;
|
||||||
|
|
||||||
import org.apache.nifi.processor.AbstractProcessor;
|
import org.apache.nifi.processor.AbstractProcessor;
|
||||||
|
@ -9,7 +25,6 @@ public class NakedProcessor extends AbstractProcessor {
|
||||||
|
|
||||||
@Override
|
@Override
|
||||||
public void onTrigger(ProcessContext arg0, ProcessSession arg1) throws ProcessException {
|
public void onTrigger(ProcessContext arg0, ProcessSession arg1) throws ProcessException {
|
||||||
// TODO Auto-generated method stub
|
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
|
@ -111,7 +111,7 @@
|
||||||
<dependency>
|
<dependency>
|
||||||
<groupId>org.apache.nifi</groupId>
|
<groupId>org.apache.nifi</groupId>
|
||||||
<artifactId>nifi-documentation</artifactId>
|
<artifactId>nifi-documentation</artifactId>
|
||||||
<version>0.0.2-incubating-SNAPSHOT</version>
|
<version>0.1.0-incubating-SNAPSHOT</version>
|
||||||
</dependency>
|
</dependency>
|
||||||
</dependencies>
|
</dependencies>
|
||||||
</dependencyManagement>
|
</dependencyManagement>
|
||||||
|
|
|
@ -151,7 +151,7 @@ public class DistributeLoad extends AbstractProcessor {
|
||||||
}
|
}
|
||||||
|
|
||||||
private static Relationship createRelationship(final int num) {
|
private static Relationship createRelationship(final int num) {
|
||||||
return new Relationship.Builder().name(String.valueOf(num)).build();
|
return new Relationship.Builder().name(String.valueOf(num)).description("Where to route flowfiles for this relationship index").build();
|
||||||
}
|
}
|
||||||
|
|
||||||
@Override
|
@Override
|
||||||
|
|
|
@ -79,9 +79,9 @@ public class HandleHttpRequest extends AbstractProcessor {
|
||||||
private static final Pattern URL_QUERY_PARAM_DELIMITER = Pattern.compile("&");
|
private static final Pattern URL_QUERY_PARAM_DELIMITER = Pattern.compile("&");
|
||||||
|
|
||||||
// Allowable values for client auth
|
// Allowable values for client auth
|
||||||
public static final AllowableValue CLIENT_NONE = new AllowableValue("No Authentication", "Processor will not authenticate clients. Anyone can communicate with this Processor anonymously");
|
public static final AllowableValue CLIENT_NONE = new AllowableValue("No Authentication", "No Authentication", "Processor will not authenticate clients. Anyone can communicate with this Processor anonymously");
|
||||||
public static final AllowableValue CLIENT_WANT = new AllowableValue("Want Authentication", "Processor will try to verify the client but if unable to verify will allow the client to communicate anonymously");
|
public static final AllowableValue CLIENT_WANT = new AllowableValue("Want Authentication", "Want Authentication", "Processor will try to verify the client but if unable to verify will allow the client to communicate anonymously");
|
||||||
public static final AllowableValue CLIENT_NEED = new AllowableValue("Need Authentication", "Processor will reject communications from any client unless the client provides a certificate that is trusted by the TrustStore specified in the SSL Context Service");
|
public static final AllowableValue CLIENT_NEED = new AllowableValue("Need Authentication", "Need Authentication", "Processor will reject communications from any client unless the client provides a certificate that is trusted by the TrustStore specified in the SSL Context Service");
|
||||||
|
|
||||||
|
|
||||||
public static final PropertyDescriptor PORT = new PropertyDescriptor.Builder()
|
public static final PropertyDescriptor PORT = new PropertyDescriptor.Builder()
|
||||||
|
@ -208,6 +208,7 @@ public class HandleHttpRequest extends AbstractProcessor {
|
||||||
descriptors.add(ALLOW_HEAD);
|
descriptors.add(ALLOW_HEAD);
|
||||||
descriptors.add(ALLOW_OPTIONS);
|
descriptors.add(ALLOW_OPTIONS);
|
||||||
descriptors.add(ADDITIONAL_METHODS);
|
descriptors.add(ADDITIONAL_METHODS);
|
||||||
|
descriptors.add(CLIENT_AUTH);
|
||||||
|
|
||||||
return descriptors;
|
return descriptors;
|
||||||
}
|
}
|
||||||
|
|
|
@ -22,27 +22,7 @@
|
||||||
</head>
|
</head>
|
||||||
|
|
||||||
<body>
|
<body>
|
||||||
<h2>Description:</h2>
|
<strong>Relationships</strong>
|
||||||
<p>This processor distributes FlowFiles to downstream
|
|
||||||
processors based on a distribution strategy. The user may select the strategy "round robin", the
|
|
||||||
strategy "next available", or "load distribution service". If using the round robin
|
|
||||||
strategy, the default is to assign each destination (i.e., relationship) a weighting of 1
|
|
||||||
(evenly distributed). However, the user may add optional properties to change this weighting. When
|
|
||||||
adding a property, the name must be a positive integer between 1 and the number of relationships (inclusive).
|
|
||||||
For example, if Number of Relationships has a value of 8 and a property is added with the name 5
|
|
||||||
and the value 10, then relationship 5 (among the 8) will receive 10
|
|
||||||
FlowFiles in each iteration instead of 1. All other relationships will receive 1 FlowFile in each iteration.
|
|
||||||
</p>
|
|
||||||
<strong>Properties:</strong>
|
|
||||||
<p>In the list below, the names of required properties appear
|
|
||||||
in bold. Any other properties (not in bold) are considered optional.
|
|
||||||
If a property has a default value, it is indicated. If a property
|
|
||||||
supports the use of the NiFi Expression Language (or simply,
|
|
||||||
"expression language"), that is also indicated.</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
<strong>Relationships:</strong>
|
|
||||||
</p>
|
|
||||||
<ul>
|
<ul>
|
||||||
<li>1
|
<li>1
|
||||||
<ul>
|
<ul>
|
||||||
|
|
|
@ -0,0 +1,58 @@
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html lang="en">
|
||||||
|
<!--
|
||||||
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||||
|
contributor license agreements. See the NOTICE file distributed with
|
||||||
|
this work for additional information regarding copyright ownership.
|
||||||
|
The ASF licenses this file to You under the Apache License, Version 2.0
|
||||||
|
(the "License"); you may not use this file except in compliance with
|
||||||
|
the License. You may obtain a copy of the License at
|
||||||
|
http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
Unless required by applicable law or agreed to in writing, software
|
||||||
|
distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
See the License for the specific language governing permissions and
|
||||||
|
limitations under the License.
|
||||||
|
-->
|
||||||
|
<head>
|
||||||
|
<meta charset="utf-8"/>
|
||||||
|
<title>EvaluateJsonPath</title>
|
||||||
|
<link rel="stylesheet" href="../../css/component-usage.css" type="text/css"/>
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body>
|
||||||
|
<!-- Processor Documentation ================================================== -->
|
||||||
|
<p>
|
||||||
|
<strong>Note:</strong> The underlying JsonPath library loads the entirety of the streamed content into and performs
|
||||||
|
result evaluations in memory. Accordingly, it is important to consider the anticipated profile of content being
|
||||||
|
evaluated by this processor and the hardware supporting it especially when working against large JSON documents.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<strong>Modifies Attributes:</strong>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
This processor adds user-defined attributes if the <Destination> property is set to
|
||||||
|
<code>flowfile-attribute</code>.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<strong>Properties</strong>
|
||||||
|
</p>
|
||||||
|
<ul>
|
||||||
|
<li>
|
||||||
|
user-defined properties
|
||||||
|
<ul>
|
||||||
|
<li>The name of the attribute to put the JsonPath result into if
|
||||||
|
flowfile-attribute is used as the value for the Destination
|
||||||
|
property; if using flowfile-content as the value for the
|
||||||
|
Destination property, this value is ignored.
|
||||||
|
</li>
|
||||||
|
<li>Supports expression language: false</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</body>
|
||||||
|
</html>
|
|
@ -1,155 +0,0 @@
|
||||||
<!DOCTYPE html>
|
|
||||||
<html lang="en">
|
|
||||||
<!--
|
|
||||||
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
||||||
contributor license agreements. See the NOTICE file distributed with
|
|
||||||
this work for additional information regarding copyright ownership.
|
|
||||||
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
||||||
(the "License"); you may not use this file except in compliance with
|
|
||||||
the License. You may obtain a copy of the License at
|
|
||||||
http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
Unless required by applicable law or agreed to in writing, software
|
|
||||||
distributed under the License is distributed on an "AS IS" BASIS,
|
|
||||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
||||||
See the License for the specific language governing permissions and
|
|
||||||
limitations under the License.
|
|
||||||
-->
|
|
||||||
<head>
|
|
||||||
<meta charset="utf-8"/>
|
|
||||||
<title>EvaluateJsonPath</title>
|
|
||||||
<link rel="stylesheet" href="../../css/component-usage.css" type="text/css"/>
|
|
||||||
</head>
|
|
||||||
|
|
||||||
<body>
|
|
||||||
<!-- Processor Documentation ================================================== -->
|
|
||||||
<h2>Description:</h2>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
Evaluates one or more JsonPath expressions against the content of a FlowFile. The results of those expressions are
|
|
||||||
assigned to FlowFile Attributes or are written to the content of the FlowFile itself, depending on configuration of
|
|
||||||
the Processor. JsonPaths are entered by adding user-defined properties; the name of the property maps to the
|
|
||||||
Attribute Name into which the result will be placed (if the Destination is flowfile-attribute; otherwise, the
|
|
||||||
property name is ignored). The value of the property must be a valid JsonPath expression. If the JsonPath evaluates
|
|
||||||
to a JSON array or JSON object and the Return Type is set to 'scalar' the FlowFile will be unmodified and will be
|
|
||||||
routed to failure. A Return Type of JSON can return scalar values if the provided JsonPath evaluates to the
|
|
||||||
specified value and will be routed as a match. If Destination is 'flowfile-content' and the JsonPath does not
|
|
||||||
evaluate to a defined path, the FlowFile will be routed to 'unmatched' without having its contents modified. If
|
|
||||||
Destination is flowfile-attribute and the expression matches nothing, attributes will be created with empty
|
|
||||||
strings as the value, and the FlowFile will always be routed to 'matched.'
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
<strong>Note:</strong> The underlying JsonPath library loads the entirety of the streamed content into and performs
|
|
||||||
result evaluations in memory. Accordingly, it is important to consider the anticipated profile of content being
|
|
||||||
evaluated by this processor and the hardware supporting it especially when working against large JSON documents.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
<strong>Properties:</strong>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
In the list below, the names of required properties appear in bold.
|
|
||||||
Any other properties (not in bold) are considered optional. If a
|
|
||||||
property has a default value, it is indicated. If a property
|
|
||||||
supports the use of the NiFi Expression Language (or simply,
|
|
||||||
"expression language"), that is also indicated.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
<strong>Modifies Attributes:</strong>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
This processor adds user-defined attributes if the <Destination> property is set to
|
|
||||||
<code>flowfile-attribute</code>.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
|
|
||||||
<ul>
|
|
||||||
<li>
|
|
||||||
<strong>Destination</strong>
|
|
||||||
<ul>
|
|
||||||
<li>Indicates whether the results of the JsonPath evaluation are
|
|
||||||
written to the FlowFile content or a FlowFile attribute; if using
|
|
||||||
attribute, the attribute's name must be specified in the value of
|
|
||||||
the Attribute Name property.
|
|
||||||
</li>
|
|
||||||
<li>
|
|
||||||
Valid values are:
|
|
||||||
<ul>
|
|
||||||
<li>flowfile-content</li>
|
|
||||||
<li>flowfile-attribute</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li>Default value: flowfile-content</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li>
|
|
||||||
<strong>Return Type</strong>
|
|
||||||
<ul>
|
|
||||||
<li>Indicates the desired return type of the JsonPath expressions.
|
|
||||||
Selecting 'auto-detect' will set the return type to 'json' for a
|
|
||||||
Destination of 'flowfile-content', and 'scalar' for a Destination of
|
|
||||||
'flowfile-attribute'.")
|
|
||||||
</li>
|
|
||||||
<li>
|
|
||||||
Valid values are:
|
|
||||||
<ul>
|
|
||||||
<li>auto-detect</li>
|
|
||||||
<li>json</li>
|
|
||||||
<li>scalar</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li>Default value: auto-detect</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li>
|
|
||||||
user-defined properties
|
|
||||||
<ul>
|
|
||||||
<li>The name of the attribute to put the JsonPath result into if
|
|
||||||
flowfile-attribute is used as the value for the Destination
|
|
||||||
property; if using flowfile-content as the value for the
|
|
||||||
Destination property, this value is ignored.
|
|
||||||
</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
<strong>Relationships:</strong>
|
|
||||||
</p>
|
|
||||||
<ul>
|
|
||||||
<li>
|
|
||||||
failure
|
|
||||||
<ul>
|
|
||||||
<li>If the JsonPath cannot be evaluated against the content of the
|
|
||||||
FlowFile, then the FlowFile follows this relationship. For
|
|
||||||
example, if the FlowFile does not contain valid JSON.
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li>
|
|
||||||
matched
|
|
||||||
<ul>
|
|
||||||
<li>If the JsonPath is successfully evaluated and the FlowFile is
|
|
||||||
modified as a result, then the FlowFile follows this
|
|
||||||
relationship.
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li>
|
|
||||||
unmatched
|
|
||||||
<ul>
|
|
||||||
<li>If the JsonPath does not match the content of the FlowFile, then
|
|
||||||
the FlowFile follows this relationship.
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
</p>
|
|
||||||
</body>
|
|
||||||
</html>
|
|
|
@ -1,100 +0,0 @@
|
||||||
<!DOCTYPE html>
|
|
||||||
<html lang="en">
|
|
||||||
<!--
|
|
||||||
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
||||||
contributor license agreements. See the NOTICE file distributed with
|
|
||||||
this work for additional information regarding copyright ownership.
|
|
||||||
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
||||||
(the "License"); you may not use this file except in compliance with
|
|
||||||
the License. You may obtain a copy of the License at
|
|
||||||
http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
Unless required by applicable law or agreed to in writing, software
|
|
||||||
distributed under the License is distributed on an "AS IS" BASIS,
|
|
||||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
||||||
See the License for the specific language governing permissions and
|
|
||||||
limitations under the License.
|
|
||||||
-->
|
|
||||||
<head>
|
|
||||||
<meta charset="utf-8" />
|
|
||||||
<title>ExecuteProcess</title>
|
|
||||||
|
|
||||||
<link rel="stylesheet" href="../../css/component-usage.css" type="text/css" />
|
|
||||||
</head>
|
|
||||||
|
|
||||||
<body>
|
|
||||||
<!-- Processor Documentation ================================================== -->
|
|
||||||
<h2> Description:</h2>
|
|
||||||
<p>
|
|
||||||
Runs an operating system command specified by the user and writes the output of that command to a FlowFile. If the command is expected
|
|
||||||
to be long-running, the Processor can output the partial data on a specified interval. When this option is used, the output is expected to be in textual
|
|
||||||
format, as it typically does not make sense to split binary data on arbitrary time-based intervals.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
<strong>Properties:</strong>
|
|
||||||
</p>
|
|
||||||
<p>In the list below, the names of required properties appear
|
|
||||||
in bold. Any other properties (not in bold) are considered optional.
|
|
||||||
If a property has a default value, it is indicated. If a property
|
|
||||||
supports the use of the NiFi Expression Language (or simply,
|
|
||||||
"expression language"), that is also indicated.</p>
|
|
||||||
<ul>
|
|
||||||
<li><strong>Command</strong>
|
|
||||||
<ul>
|
|
||||||
<li>Specifies the command to be executed; if just the name of an executable is provided, it must be in the user's environment PATH.</li>
|
|
||||||
<li>Default value: none</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li>Command Arguments
|
|
||||||
<ul>
|
|
||||||
<li>The arguments to supply to the executable delimited by white space. White space can be escaped by enclosing it in double-quotes.</li>
|
|
||||||
<li>Default value: none</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li>Working Directory
|
|
||||||
<ul>
|
|
||||||
<li>The directory to use as the current working directory when executing the command</li>
|
|
||||||
<li>Default value: none (which means whatever NiFi's root installation directory is)</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li>Batch Duration
|
|
||||||
<ul>
|
|
||||||
<li>
|
|
||||||
If the process is expected to be long-running and produce textual output, a batch duration can be specified so
|
|
||||||
that the output will be captured for this amount of time and a FlowFile will then be sent out with the results
|
|
||||||
and a new FlowFile will be started, rather than waiting for the process to finish before sending out the results.
|
|
||||||
If no value is provided, the process will run to completion and the entire output of the process will be written
|
|
||||||
to a single FlowFile.
|
|
||||||
</li>
|
|
||||||
<li>Default value: none</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li>Redirect Error Stream
|
|
||||||
<ul>
|
|
||||||
<li>
|
|
||||||
If true will redirect any error stream output of the process to the output stream.
|
|
||||||
This is particularly helpful for processes which write extensively to the error stream or for troubleshooting.
|
|
||||||
</li>
|
|
||||||
<li>Default value: false</li>
|
|
||||||
<li>Allowed Values: true, false</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
<strong>Relationships:</strong>
|
|
||||||
</p>
|
|
||||||
<ul>
|
|
||||||
<li>success
|
|
||||||
<ul>
|
|
||||||
<li>All FlowFiles that are created are routed to this relationship.</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
</body>
|
|
||||||
</html>
|
|
|
@ -0,0 +1,127 @@
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html lang="en">
|
||||||
|
<!--
|
||||||
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||||
|
contributor license agreements. See the NOTICE file distributed with
|
||||||
|
this work for additional information regarding copyright ownership.
|
||||||
|
The ASF licenses this file to You under the Apache License, Version 2.0
|
||||||
|
(the "License"); you may not use this file except in compliance with
|
||||||
|
the License. You may obtain a copy of the License at
|
||||||
|
http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
Unless required by applicable law or agreed to in writing, software
|
||||||
|
distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
See the License for the specific language governing permissions and
|
||||||
|
limitations under the License.
|
||||||
|
-->
|
||||||
|
<head>
|
||||||
|
<meta charset="utf-8" />
|
||||||
|
<title>HandleHttpRequest</title>
|
||||||
|
<link rel="stylesheet" href="../../css/component-usage.css" type="text/css" />
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body>
|
||||||
|
<h2>Usage Description</h2>
|
||||||
|
<p>
|
||||||
|
The pairing of this Processor with a <a href="../org.apache.nifi.processors.standard.HandleHttpResponse/index.html">HandleHttpResponse</a> Processor
|
||||||
|
provides the ability to use NiFi to visually construct a web server that can carry out any functionality that is available
|
||||||
|
through the existing Processors. For example, one could construct a Web-based front end to an SFTP Server by constructing a
|
||||||
|
flow such as:
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<a href="index.html">HandleHttpRequest</a> ->
|
||||||
|
<a href="../org.apache.nifi.processors.standard.PutSFTP/index.html">PutSFTP</a> ->
|
||||||
|
<a href="../org.apache.nifi.processors.standard.HandleHttpResponse/index.html">HandleHttpResponse</a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
The HandleHttpRequest Processor provides several Properties to configure which methods are supported, the paths that are
|
||||||
|
supported, and SSL configuration. The FlowFiles that are generated by this Processor have the following attributes added to
|
||||||
|
them, providing powerful routing capabilities and traceability of all data:
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<table>
|
||||||
|
<thead>
|
||||||
|
<tr>
|
||||||
|
<th>Attribute Name</th>
|
||||||
|
<th>Attribute Description</th>
|
||||||
|
</tr>
|
||||||
|
</thead>
|
||||||
|
<tbody>
|
||||||
|
<tr>
|
||||||
|
<td>http.context.identifier</td>
|
||||||
|
<td>An identifier that allows the HandleHttpRequest and HandleHttpResponse to coordinate which FlowFile belongs
|
||||||
|
to which HTTP Request/Response.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>mime.type</td>
|
||||||
|
<td>The MIME Type of the data, according to the HTTP Header "Content-Type"</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>http.servlet.path</td>
|
||||||
|
<td>The part of the request URL that is considered the Servlet Path</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>http.context.path</td>
|
||||||
|
<td>The part of the request URL that is considered to be the Context Path</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>http.method</td>
|
||||||
|
<td>The HTTP Method that was used for the request, such as GET or POST</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>http.query.string</td>
|
||||||
|
<td>The query string portion of hte Request URL</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>http.remote.host</td>
|
||||||
|
<td>The hostname of the requestor</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>http.remote.addr</td>
|
||||||
|
<td>The hostname:port combination of the requestor</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>http.remote.user</td>
|
||||||
|
<td>The username of the requestor</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>http.request.uri</td>
|
||||||
|
<td>The full Request URL</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>http.auth.type</td>
|
||||||
|
<td>The type of HTTP Authorization used</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>http.principal.name</td>
|
||||||
|
<td>The name of the authenticated user making the request</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>http.subject.dn</td>
|
||||||
|
<td>The Distinguished Name of the requestor. This value will not be populated unless the Processor is
|
||||||
|
configured to use an SSLContext Service</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>http.issuer.dn</td>
|
||||||
|
<td>The Distinguished Name of the entity that issued the Subject's certificate. This value will not be
|
||||||
|
populated unless the Processor is configured to use an SSLContext Service</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>http.headers.XXX</td>
|
||||||
|
<td>Each of the HTTP Headers that is received in the request will be added as an attribute, prefixed
|
||||||
|
with "http.headers." For example, if the request contains an HTTP Header named "x-my-header",
|
||||||
|
then the value will be added to an attribute named "http.headers.x-my-header"</td>
|
||||||
|
</tr>
|
||||||
|
</tbody>
|
||||||
|
</table>
|
||||||
|
<p>
|
||||||
|
<strong>See Also:</strong><br />
|
||||||
|
<a href="../org.apache.nifi.processors.standard.HandleHttpResponse/index.html">HandleHttpResponse</a><br />
|
||||||
|
<a href="../org.apache.nifi.http.StandardHttpContextMap/index.html">StandardHttpContextMap</a><br />
|
||||||
|
<a href="../org.apache.nifi.ssl.StandardSSLContextService/index.html">StandardSSLContextService</a><br />
|
||||||
|
</p>
|
||||||
|
|
||||||
|
</body>
|
||||||
|
</html>
|
|
@ -1,255 +0,0 @@
|
||||||
<!DOCTYPE html>
|
|
||||||
<html lang="en">
|
|
||||||
<!--
|
|
||||||
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
||||||
contributor license agreements. See the NOTICE file distributed with
|
|
||||||
this work for additional information regarding copyright ownership.
|
|
||||||
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
||||||
(the "License"); you may not use this file except in compliance with
|
|
||||||
the License. You may obtain a copy of the License at
|
|
||||||
http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
Unless required by applicable law or agreed to in writing, software
|
|
||||||
distributed under the License is distributed on an "AS IS" BASIS,
|
|
||||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
||||||
See the License for the specific language governing permissions and
|
|
||||||
limitations under the License.
|
|
||||||
-->
|
|
||||||
<head>
|
|
||||||
<meta charset="utf-8" />
|
|
||||||
<title>HandleHttpRequest</title>
|
|
||||||
<link rel="stylesheet" href="../../css/component-usage.css" type="text/css" />
|
|
||||||
</head>
|
|
||||||
|
|
||||||
<body>
|
|
||||||
<!-- Processor Documentation ================================================== -->
|
|
||||||
<h2>Description:</h2>
|
|
||||||
<p>
|
|
||||||
This processor starts an HTTP server and creates a FlowFile for each HTTP Request that it receives. The Processor leaves
|
|
||||||
the HTTP Connection open and is intended to be used in conjunction with a
|
|
||||||
<a href="../org.apache.nifi.processors.standard.HandleHttpResponse/index.html">HandleHttpResponse</a> Processor.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
The pairing of this Processor with a <a href="../org.apache.nifi.processors.standard.HandleHttpResponse/index.html">HandleHttpResponse</a> Processor
|
|
||||||
provides the ability to use NiFi to visually construct a web server that can carry out any functionality that is available
|
|
||||||
through the existing Processors. For example, one could construct a Web-based front end to an SFTP Server by constructing a
|
|
||||||
flow such as:
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
<a href="index.html">HandleHttpRequest</a> ->
|
|
||||||
<a href="../org.apache.nifi.processors.standard.PutSFTP/index.html">PutSFTP</a> ->
|
|
||||||
<a href="../org.apache.nifi.processors.standard.HandleHttpResponse/index.html">HandleHttpResponse</a>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
The HandleHttpRequest Processor provides several Properties to configure which methods are supported, the paths that are
|
|
||||||
supported, and SSL configuration. The FlowFiles that are generated by this Processor have the following attributes added to
|
|
||||||
them, providing powerful routing capabilities and traceability of all data:
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<table>
|
|
||||||
<thead>
|
|
||||||
<th>Attribute Name</th>
|
|
||||||
<th>Attribute Description</th>
|
|
||||||
</thead>
|
|
||||||
<tbody>
|
|
||||||
<tr>
|
|
||||||
<td>http.context.identifier</td>
|
|
||||||
<td>An identifier that allows the HandleHttpRequest and HandleHttpResponse to coordinate which FlowFile belongs
|
|
||||||
to which HTTP Request/Response.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>mime.type</td>
|
|
||||||
<td>The MIME Type of the data, according to the HTTP Header "Content-Type"</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>http.servlet.path</td>
|
|
||||||
<td>The part of the request URL that is considered the Servlet Path</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>http.context.path</td>
|
|
||||||
<td>The part of the request URL that is considered to be the Context Path</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>http.method</td>
|
|
||||||
<td>The HTTP Method that was used for the request, such as GET or POST</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>http.query.string</td>
|
|
||||||
<td>The query string portion of hte Request URL</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>http.remote.host</td>
|
|
||||||
<td>The hostname of the requestor</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>http.remote.addr</td>
|
|
||||||
<td>The hostname:port combination of the requestor</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>http.remote.user</td>
|
|
||||||
<td>The username of the requestor</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>http.request.uri</td>
|
|
||||||
<td>The full Request URL</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>http.auth.type</td>
|
|
||||||
<td>The type of HTTP Authorization used</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>http.principal.name</td>
|
|
||||||
<td>The name of the authenticated user making the request</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>http.subject.dn</td>
|
|
||||||
<td>The Distinguished Name of the requestor. This value will not be populated unless the Processor is
|
|
||||||
configured to use an SSLContext Service</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>http.issuer.dn</td>
|
|
||||||
<td>The Distinguished Name of the entity that issued the Subject's certificate. This value will not be
|
|
||||||
populated unless the Processor is configured to use an SSLContext Service</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>http.headers.XXX</td>
|
|
||||||
<td>Each of the HTTP Headers that is received in the request will be added as an attribute, prefixed
|
|
||||||
with "http.headers." For example, if the request contains an HTTP Header named "x-my-header",
|
|
||||||
then the value will be added to an attribute named "http.headers.x-my-header"</td>
|
|
||||||
</tr>
|
|
||||||
</tbody>
|
|
||||||
</table>
|
|
||||||
|
|
||||||
|
|
||||||
<p>
|
|
||||||
<strong>Properties:</strong>
|
|
||||||
</p>
|
|
||||||
<p>
|
|
||||||
In the list below, the names of required properties appear in bold. Any other properties (not in bold) are considered optional. If a property has a default value, it is indicated. If a property supports the use of the NiFi Expression Language (or simply, "expression language"), that is also indicated.
|
|
||||||
</p>
|
|
||||||
<ul>
|
|
||||||
<li><strong>Listening Port</strong>
|
|
||||||
<ul>
|
|
||||||
<li>The port to listen on for incoming HTTP Requests</li>
|
|
||||||
<li>Default value: no default</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li>Hostname
|
|
||||||
<ul>
|
|
||||||
<li>The Hostname to bind to. If not specified, will bind to all hosts</li>
|
|
||||||
<li>Default value: no default</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li><strong>HTTP Context Map</strong>
|
|
||||||
<ul>
|
|
||||||
<li>The HTTP Context Map Controller Service to use for caching the HTTP Request Information</li>
|
|
||||||
<li>Default value: no default</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li>SSL Context Service
|
|
||||||
<ul>
|
|
||||||
<li>The Controller Service to use for obtaining an SSL Context. The SSL Context controller service is a mechanism for providing all the security properties that allow for secure communications between NiFi extensions and other systems. See the User Guide or the Controller Services documentation via the "help" link in the upper-right corner of the GUI for more information about the StandardSSLContextService. The value for this property is the identifier name that is configured in the StandardSSLContextService.</li>
|
|
||||||
<li>Default value: no default</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
|
|
||||||
<li><strong>Allowed Paths</strong>
|
|
||||||
<ul>
|
|
||||||
<li>A Regular Expression that specifies the valid HTTP Paths that are allowed in the incoming URL Requests. If this value is specified and the path of the HTTP Requests does not match this Regular Expression, the Processor will respond with a 404: NotFound</li>
|
|
||||||
<li>Default value: no default</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li><strong>Allow GET</strong>
|
|
||||||
<ul>
|
|
||||||
<li>Specifies whether or not to allow HTTP GET Method</li>
|
|
||||||
<li>Default value: true</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li><strong>Allow POST</strong>
|
|
||||||
<ul>
|
|
||||||
<li>Specifies whether or not to allow HTTP POST Method</li>
|
|
||||||
<li>Default value: true</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li><strong>Allow PUT</strong>
|
|
||||||
<ul>
|
|
||||||
<li>Specifies whether or not to allow HTTP PUT Method</li>
|
|
||||||
<li>Default value: true</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li><strong>Allow DELETE</strong>
|
|
||||||
<ul>
|
|
||||||
<li>Specifies whether or not to allow HTTP DELETE Method</li>
|
|
||||||
<li>Default value: true</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li><strong>Allow HEAD</strong>
|
|
||||||
<ul>
|
|
||||||
<li>Specifies whether or not to allow HTTP HEAD Method</li>
|
|
||||||
<li>Default value: false</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li><strong>Allow OPTIONS</strong>
|
|
||||||
<ul>
|
|
||||||
<li>Specifies whether or not to allow HTTP OPTIONS Method</li>
|
|
||||||
<li>Default value: false</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li>Additional HTTP Methods
|
|
||||||
<ul>
|
|
||||||
<li>A comma-separated list of non-standard HTTP Methods that should be allowed</li>
|
|
||||||
<li>Default value: no default</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li><strong>Client Authentication</strong>
|
|
||||||
<ul>
|
|
||||||
<li>Specifies whether or not the Processor should authenticate clients. This value is ignored if the <SSL Context Service> Property is not specified or the SSL Context provided uses only a KeyStore and not a TrustStore.</li>
|
|
||||||
<li>
|
|
||||||
The following values are allowed:
|
|
||||||
<ul>
|
|
||||||
<li><b>No Authentication</b> - Processor will not authenticate clients. Anyone can communicate with this Processor anonymously</li>
|
|
||||||
<li><b>Want Authentication</b> - Processor will try to verify the client but if unable to verify will allow the client to communicate anonymously</li>
|
|
||||||
<li><b>Need Authentication</b> - Processor will reject communications from any client unless the client provides a certificate that is trusted by the TrustStore specified in the SSL Context Service</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li>Default value: No Authentication</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
<strong>Relationships:</strong>
|
|
||||||
</p>
|
|
||||||
<ul>
|
|
||||||
<li>success
|
|
||||||
<ul>
|
|
||||||
<li>All FlowFiles that are created are routed to this relationship.</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
|
|
||||||
<p>
|
|
||||||
<strong>See Also:</strong><br />
|
|
||||||
<a href="../org.apache.nifi.processors.standard.HandleHttpResponse/index.html">HandleHttpResponse</a><br />
|
|
||||||
<a href="../org.apache.nifi.http.StandardHttpContextMap/index.html">StandardHttpContextMap</a><br />
|
|
||||||
<a href="../org.apache.nifi.ssl.StandardSSLContextService/index.html">StandardSSLContextService</a><br />
|
|
||||||
</p>
|
|
||||||
|
|
||||||
</body>
|
|
||||||
</html>
|
|
|
@ -0,0 +1,57 @@
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html lang="en">
|
||||||
|
<!--
|
||||||
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||||
|
contributor license agreements. See the NOTICE file distributed with
|
||||||
|
this work for additional information regarding copyright ownership.
|
||||||
|
The ASF licenses this file to You under the Apache License, Version 2.0
|
||||||
|
(the "License"); you may not use this file except in compliance with
|
||||||
|
the License. You may obtain a copy of the License at
|
||||||
|
http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
Unless required by applicable law or agreed to in writing, software
|
||||||
|
distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
See the License for the specific language governing permissions and
|
||||||
|
limitations under the License.
|
||||||
|
-->
|
||||||
|
<head>
|
||||||
|
<meta charset="utf-8" />
|
||||||
|
<title>HandleHttpResponse</title>
|
||||||
|
<link rel="stylesheet" href="../../css/component-usage.css" type="text/css" />
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body>
|
||||||
|
<!-- Processor Documentation ================================================== -->
|
||||||
|
<h2>Usage Description:</h2>
|
||||||
|
<p>
|
||||||
|
The pairing of this Processor with a <a href="../org.apache.nifi.processors.standard.HandleHttpRequest/index.html">HandleHttpRequest</a> Processor
|
||||||
|
provides the ability to use NiFi to visually construct a web server that can carry out any functionality that is available
|
||||||
|
through the existing Processors. For example, one could construct a Web-based front end to an SFTP Server by constructing a
|
||||||
|
flow such as:
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<a href="../org.apache.nifi.processors.standard.HandleHttpRequest/index.html">HandleHttpRequest</a> ->
|
||||||
|
<a href="../org.apache.nifi.processors.standard.PutSFTP/index.html">PutSFTP</a> ->
|
||||||
|
<a href="index.html">HandleHttpResponse</a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
This Processor must be configured with the same <HTTP Context Map> service as the corresponding HandleHttpRequest Processor.
|
||||||
|
Otherwise, all FlowFiles will be routed to the 'failure' relationship.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
All FlowFiles must have an attribute named <code>http.context.identifier</code>. The value of this attribute is used to lookup
|
||||||
|
the HTTP Response so that the proper message can be sent back to the requestor. If this attribute is missing, the FlowFile
|
||||||
|
will be routed to 'failure.'
|
||||||
|
</p>
|
||||||
|
<p>
|
||||||
|
<strong>See Also:</strong><br />
|
||||||
|
<a href="../org.apache.nifi.processors.standard.HandleHttpRequest/index.html">HandleHttpRequest</a><br />
|
||||||
|
<a href="../org.apache.nifi.http.StandardHttpContextMap/index.html">StandardHttpContextMap</a><br />
|
||||||
|
<a href="../org.apache.nifi.ssl.StandardSSLContextService/index.html">StandardSSLContextService</a><br />
|
||||||
|
</p>
|
||||||
|
|
||||||
|
</body>
|
||||||
|
</html>
|
|
@ -1,112 +0,0 @@
|
||||||
<!DOCTYPE html>
|
|
||||||
<html lang="en">
|
|
||||||
<!--
|
|
||||||
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
||||||
contributor license agreements. See the NOTICE file distributed with
|
|
||||||
this work for additional information regarding copyright ownership.
|
|
||||||
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
||||||
(the "License"); you may not use this file except in compliance with
|
|
||||||
the License. You may obtain a copy of the License at
|
|
||||||
http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
Unless required by applicable law or agreed to in writing, software
|
|
||||||
distributed under the License is distributed on an "AS IS" BASIS,
|
|
||||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
||||||
See the License for the specific language governing permissions and
|
|
||||||
limitations under the License.
|
|
||||||
-->
|
|
||||||
<head>
|
|
||||||
<meta charset="utf-8" />
|
|
||||||
<title>HandleHttpResponse</title>
|
|
||||||
<link rel="stylesheet" href="../../css/component-usage.css" type="text/css" />
|
|
||||||
</head>
|
|
||||||
|
|
||||||
<body>
|
|
||||||
<!-- Processor Documentation ================================================== -->
|
|
||||||
<h2>Description:</h2>
|
|
||||||
<p>
|
|
||||||
This processor responds to an HTTP request that was received by the
|
|
||||||
<a href="../org.apache.nifi.processors.standard.HandleHttpRequest/index.html">HandleHttpRequest</a> Processor.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
The pairing of this Processor with a <a href="../org.apache.nifi.processors.standard.HandleHttpRequest/index.html">HandleHttpRequest</a> Processor
|
|
||||||
provides the ability to use NiFi to visually construct a web server that can carry out any functionality that is available
|
|
||||||
through the existing Processors. For example, one could construct a Web-based front end to an SFTP Server by constructing a
|
|
||||||
flow such as:
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
<a href="../org.apache.nifi.processors.standard.HandleHttpRequest/index.html">HandleHttpRequest</a> ->
|
|
||||||
<a href="../org.apache.nifi.processors.standard.PutSFTP/index.html">PutSFTP</a> ->
|
|
||||||
<a href="index.html">HandleHttpResponse</a>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
This Processor must be configured with the same <HTTP Context Map> service as the corresponding HandleHttpRequest Processor.
|
|
||||||
Otherwise, all FlowFiles will be routed to the 'failure' relationship.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
All FlowFiles must have an attribute named <code>http.context.identifier</code>. The value of this attribute is used to lookup
|
|
||||||
the HTTP Response so that the proper message can be sent back to the requestor. If this attribute is missing, the FlowFile
|
|
||||||
will be routed to 'failure.'
|
|
||||||
</p>
|
|
||||||
|
|
||||||
|
|
||||||
<p>
|
|
||||||
<strong>Properties:</strong>
|
|
||||||
</p>
|
|
||||||
<p>
|
|
||||||
In the list below, the names of required properties appear in bold. Any other properties (not in bold) are considered optional. If a property has a default value, it is indicated. If a property supports the use of the NiFi Expression Language (or simply, "expression language"), that is also indicated.
|
|
||||||
</p>
|
|
||||||
<ul>
|
|
||||||
<li><strong>HTTP Status Code</strong>
|
|
||||||
<ul>
|
|
||||||
<li>The HTTP Status Code to use when responding to the HTTP Request. See Section 10 of RFC 2616 for more information.</li>
|
|
||||||
<li>Default value: no default</li>
|
|
||||||
<li>Supports expression language: true</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li><strong>HTTP Context Map</strong>
|
|
||||||
<ul>
|
|
||||||
<li>The HTTP Context Map Controller Service to use for caching the HTTP Request Information</li>
|
|
||||||
<li>Default value: no default</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
<strong>Relationships:</strong>
|
|
||||||
</p>
|
|
||||||
<ul>
|
|
||||||
<li>success
|
|
||||||
<ul>
|
|
||||||
<li>If a message is successfully sent back to the requestor, the FlowFile is routed to this relationship.</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
|
|
||||||
<li>failure
|
|
||||||
<ul>
|
|
||||||
<li>
|
|
||||||
A FlowFile will be routed to failure under the following conditions:
|
|
||||||
<ul>
|
|
||||||
<li>The FlowFile does not have an <code>http.context.identifier</code> attribute</li>
|
|
||||||
<li>The <code>http.context.identifier</code> attribute has a value that cannot be found in the HTTP Context Map</li>
|
|
||||||
<li>The HTTP Status Code is not a number</li>
|
|
||||||
<li>There was a communications failure when attempting to write the response to the requestor</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
<strong>See Also:</strong><br />
|
|
||||||
<a href="../org.apache.nifi.processors.standard.HandleHttpRequest/index.html">HandleHttpRequest</a><br />
|
|
||||||
<a href="../org.apache.nifi.http.StandardHttpContextMap/index.html">StandardHttpContextMap</a><br />
|
|
||||||
<a href="../org.apache.nifi.ssl.StandardSSLContextService/index.html">StandardSSLContextService</a><br />
|
|
||||||
</p>
|
|
||||||
|
|
||||||
</body>
|
|
||||||
</html>
|
|
|
@ -22,60 +22,6 @@
|
||||||
</head>
|
</head>
|
||||||
|
|
||||||
<body>
|
<body>
|
||||||
<!-- Processor Documentation ================================================== -->
|
|
||||||
<h2>Description:</h2>
|
|
||||||
<p>
|
|
||||||
This processor attempts to identify the MIME type used for a
|
|
||||||
FlowFile. If the MIME type can be identified, an attribute with the
|
|
||||||
name
|
|
||||||
<code>mime.type</code>
|
|
||||||
is added to the FlowFile, and its value is the detected MIME type.
|
|
||||||
Some MIME
|
|
||||||
types require the processor to read a significant amount of data; for
|
|
||||||
these MIME types, their identification is optional. (See the
|
|
||||||
properties Identify ZIP and Identify TAR.) The algorithm may have to
|
|
||||||
read the entire contents of a file for each type of identification. If
|
|
||||||
the MIME Type cannot be determined, its mime.type attribute will be
|
|
||||||
set to
|
|
||||||
<code>application/octet-stream</code>
|
|
||||||
.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>The following MIME Types are detected:
|
|
||||||
</p>
|
|
||||||
<ul>
|
|
||||||
<li>application/gzip</li>
|
|
||||||
<li>application/bzip2</li>
|
|
||||||
<li>application/flowfile-v3</li>
|
|
||||||
<li>application/flowfile-v1 (requires Identify TAR be set to true)</li>
|
|
||||||
<li>application/xml</li>
|
|
||||||
<li>video/mp4</li>
|
|
||||||
<li>video/x-m4v</li>
|
|
||||||
<li>video/mp4a-latm</li>
|
|
||||||
<li>video/quicktime</li>
|
|
||||||
<li>video/mpeg</li>
|
|
||||||
<li>audio/wav</li>
|
|
||||||
<li>audio/mp3</li>
|
|
||||||
<li>image/bmp</li>
|
|
||||||
<li>image/png</li>
|
|
||||||
<li>image/jpg</li>
|
|
||||||
<li>image/gif</li>
|
|
||||||
<li>image/tif</li>
|
|
||||||
<li>application/vnd.ms-works</li>
|
|
||||||
<li>application/msexcel</li>
|
|
||||||
<li>application/mspowerpoint</li>
|
|
||||||
<li>application/msaccess</li>
|
|
||||||
<li>application/x-ms-wmv</li>
|
|
||||||
<li>application/pdf</li>
|
|
||||||
<li>application/x-rpm</li>
|
|
||||||
<li>application/tar</li>
|
|
||||||
<li>application/x-7z-compressed</li>
|
|
||||||
<li>application/java-archive</li>
|
|
||||||
<li>application/zip</li>
|
|
||||||
<li>application/x-lzh</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
<strong>Modifies Attributes:</strong>
|
<strong>Modifies Attributes:</strong>
|
||||||
</p>
|
</p>
|
||||||
|
|
|
@ -37,25 +37,7 @@
|
||||||
essentially the same as sending quote commands to an FTP server from the command line.
|
essentially the same as sending quote commands to an FTP server from the command line.
|
||||||
</li>
|
</li>
|
||||||
<li><strong>NOTE</strong>: While this is the same as sending a quote command, it is very important that
|
<li><strong>NOTE</strong>: While this is the same as sending a quote command, it is very important that
|
||||||
you leave off the “quote” part of the command from the text value you enter in. For example, if you want
|
you leave off the .
|
||||||
to mimic the command line ftp command quote stat you would give the text value of stat. You have the
|
|
||||||
option of sending a number of commands to the FTP server before the file is sent. If you have only one
|
|
||||||
command, then the name of the optional parameter will be pre.cmd.1. If you have a second command, then
|
|
||||||
the next optional parameter you give is pre.cmd.2, and so on. There is no limit to the number of pre
|
|
||||||
commands you can send. The commands will be sent in the order of their number, so pre.cmd.1 will be sent
|
|
||||||
first, pre.cmd.2 will be sent next, etc. This is true regardless of what order they are added to the
|
|
||||||
processor properties. The property names determine the order.</li>
|
|
||||||
<li><strong>NOTE</strong>: If the optional property name does not follow the pattern pre.cmd.<em>integer</em>
|
|
||||||
- then the command will not be sent. If a command is given which is not recognized by the server, then
|
|
||||||
that will be logged.</li>
|
|
||||||
<li>Supports expression language: true. FlowFile attributes can be used in commands using the expression language</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li>post.cmd.#
|
|
||||||
<ul>
|
|
||||||
<li>Optional properties of this type can be added by the user and should be used for <strong>VERY
|
|
||||||
RARE</strong> cases only. You will know when you need to use it when the recipient specifies that you must
|
|
||||||
send FTP commands after the transfer. Otherwise, do not use it. These are the same as the pre commands.
|
|
||||||
(See pre commands above) except that these commands are sent after the file transfer.
|
(See pre commands above) except that these commands are sent after the file transfer.
|
||||||
</li>
|
</li>
|
||||||
<li>Supports expression language: true. FlowFile attributes can be used in commands using the expression language</li>
|
<li>Supports expression language: true. FlowFile attributes can be used in commands using the expression language</li>
|
||||||
|
|
|
@ -22,7 +22,7 @@
|
||||||
</head>
|
</head>
|
||||||
|
|
||||||
<body>
|
<body>
|
||||||
<h2>Description:</h2>
|
<h2>Usage Example</h2>
|
||||||
<p>
|
<p>
|
||||||
This processor routes FlowFiles based on their attributes
|
This processor routes FlowFiles based on their attributes
|
||||||
using the NiFi Expression Language. Users add properties with
|
using the NiFi Expression Language. Users add properties with
|
||||||
|
|
|
@ -1,85 +0,0 @@
|
||||||
<!DOCTYPE html>
|
|
||||||
<html lang="en">
|
|
||||||
<!--
|
|
||||||
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
||||||
contributor license agreements. See the NOTICE file distributed with
|
|
||||||
this work for additional information regarding copyright ownership.
|
|
||||||
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
||||||
(the "License"); you may not use this file except in compliance with
|
|
||||||
the License. You may obtain a copy of the License at
|
|
||||||
http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
Unless required by applicable law or agreed to in writing, software
|
|
||||||
distributed under the License is distributed on an "AS IS" BASIS,
|
|
||||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
||||||
See the License for the specific language governing permissions and
|
|
||||||
limitations under the License.
|
|
||||||
-->
|
|
||||||
<head>
|
|
||||||
<meta charset="utf-8"/>
|
|
||||||
<title>SplitJson</title>
|
|
||||||
|
|
||||||
<link rel="stylesheet" href="../../css/component-usage.css" type="text/css"/>
|
|
||||||
</head>
|
|
||||||
|
|
||||||
<body>
|
|
||||||
<!-- Processor Documentation ================================================== -->
|
|
||||||
<h2>Description:</h2>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
This processor splits a JSON File into multiple, separate FlowFiles for an array element specified by a JsonPath
|
|
||||||
expression.
|
|
||||||
Each generated FlowFile is comprised of an element of the specified array and transferred to relationship 'split,'
|
|
||||||
with the original file transferred to the 'original' relationship. If the specified JsonPath is not found or
|
|
||||||
does not evaluate to an array element, the original file is routed to 'failure' and no files are generated.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
<strong>Note:</strong> The underlying JsonPath library loads the entirety of the streamed content into and performs
|
|
||||||
result evaluations in memory. Accordingly, it is important to consider the anticipated profile of content being
|
|
||||||
evaluated by this processor and the hardware supporting it especially when working against large JSON documents.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<strong>Properties:</strong>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
In the list below, the names of required properties appear in bold. Any other properties (not in bold) are
|
|
||||||
considered optional. If a property has a default value, it is indicated. If a property supports the use of the NiFi
|
|
||||||
Expression Language (or simply, "expression language"), that is also indicated.
|
|
||||||
</p>
|
|
||||||
<ul>
|
|
||||||
<li><strong>JsonPath Expression</strong>
|
|
||||||
<ul>
|
|
||||||
<li>A JsonPath expression that indicates the array element to split into JSON/scalar fragments.</li>
|
|
||||||
<li>Supports expression language: false</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
<strong>Relationships:</strong>
|
|
||||||
</p>
|
|
||||||
<ul>
|
|
||||||
<li>failure
|
|
||||||
<ul>
|
|
||||||
<li>If a FlowFile fails processing for any reason (for example, the FlowFile is not valid JSON or the
|
|
||||||
specified path does not exist) and does not go down the original relationship.
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li>original
|
|
||||||
<ul>
|
|
||||||
<li>If FlowFiles are successfully split, a copy of the original FlowFile follows this relationship.</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
<li>split
|
|
||||||
<ul>
|
|
||||||
<li>If FlowFiles are successfully split into one or more files, those split files follow this
|
|
||||||
relationship.
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
</body>
|
|
||||||
</html>
|
|
Loading…
Reference in New Issue