lordgamez commented on code in PR #1866:
URL: https://github.com/apache/nifi-minifi-cpp/pull/1866#discussion_r1842192329
##########
PROCESSORS.md:
##########
@@ -2875,6 +2877,41 @@ In the list below, the names of required properties
appear in bold. Any other pr
| segment.original.filename | | The filename of the parent
FlowFile
|
+## SplitRecord
+
+### Description
+
+Splits up an input FlowFile that is in a record-oriented data format into
multiple smaller FlowFiles
+
+### Properties
+
+In the list below, the names of required properties appear in bold. Any other
properties (not in bold) are considered optional. The table also indicates any
default values, and whether a property supports the NiFi Expression Language.
+
+| Name | Default Value | Allowable Values | Description
|
+|-----------------------|---------------|------------------|-------------------------------------------------------------------------------------------------------------------------------|
+| **Record Reader** | | | Specifies the
Controller Service to use for reading incoming data
|
+| **Record Writer** | | | Specifies the
Controller Service to use for writing out the records
|
+| **Records Per Split** | | | Specifies how
many records should be written to each 'split' or 'segment'
FlowFile<br/>**Supports Expression Language: true** |
+
+### Relationships
+
+| Name | Description
|
+|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| failure | If a FlowFile cannot be transformed from the configured input
format to the configured output format, the unchanged FlowFile will be routed
to this relationship. |
+| original | Upon successfully splitting an input FlowFile, the original
FlowFile will be sent to this relationship.
|
+| splits | The individual 'segments' of the original FlowFile will be routed
to this relationship.
|
+
+### Output Attributes
+
+| Attribute | Relationship | Description
|
+|---------------------------|--------------|--------------------------------------------------------------------------------------------------------------------------------|
+| record.count | | The number of records in the
FlowFile. This is added to FlowFiles that are routed to the 'splits'
Relationship. |
+| fragment.identifier | | All split FlowFiles produced from
the same parent FlowFile will have the same randomly generated UUID added for
this attribute |
Review Comment:
Good point, updated in b34afbfa89aae6398cfdafcb017e70e13934639c
##########
extensions/standard-processors/processors/SplitRecord.cpp:
##########
@@ -0,0 +1,119 @@
+/**
+ * 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.
+ */
+#include "SplitRecord.h"
+
+#include "core/Resource.h"
+#include "nonstd/expected.hpp"
+#include "utils/GeneralUtils.h"
+
+namespace org::apache::nifi::minifi::processors {
+namespace {
+template<typename RecordSetIO>
+std::shared_ptr<RecordSetIO> getRecordSetIO(core::ProcessContext& context,
const core::PropertyReference& property) {
+ std::string service_name;
+ if (context.getProperty(property, service_name) &&
!IsNullOrEmpty(service_name)) {
+ auto record_set_io =
std::dynamic_pointer_cast<RecordSetIO>(context.getControllerService(service_name));
+ if (!record_set_io)
+ return nullptr;
+ return record_set_io;
+ }
+ return nullptr;
+}
+} // namespace
+
+void SplitRecord::onSchedule(core::ProcessContext& context,
core::ProcessSessionFactory&) {
+ record_set_reader_ = getRecordSetIO<core::RecordSetReader>(context,
RecordReader);
+ if (!record_set_reader_) {
+ throw Exception(ExceptionType::PROCESS_SCHEDULE_EXCEPTION, "Record Reader
set is missing or invalid");
+ }
+ record_set_writer_ = getRecordSetIO<core::RecordSetWriter>(context,
RecordWriter);
+ if (!record_set_writer_) {
+ throw Exception(ExceptionType::PROCESS_SCHEDULE_EXCEPTION, "Record Writer
set is missing or invalid");
Review Comment:
Fixed in b34afbfa89aae6398cfdafcb017e70e13934639c
##########
extensions/standard-processors/processors/SplitRecord.cpp:
##########
@@ -0,0 +1,119 @@
+/**
+ * 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.
+ */
+#include "SplitRecord.h"
+
+#include "core/Resource.h"
+#include "nonstd/expected.hpp"
+#include "utils/GeneralUtils.h"
+
+namespace org::apache::nifi::minifi::processors {
+namespace {
+template<typename RecordSetIO>
+std::shared_ptr<RecordSetIO> getRecordSetIO(core::ProcessContext& context,
const core::PropertyReference& property) {
+ std::string service_name;
+ if (context.getProperty(property, service_name) &&
!IsNullOrEmpty(service_name)) {
+ auto record_set_io =
std::dynamic_pointer_cast<RecordSetIO>(context.getControllerService(service_name));
+ if (!record_set_io)
+ return nullptr;
+ return record_set_io;
+ }
+ return nullptr;
+}
+} // namespace
+
+void SplitRecord::onSchedule(core::ProcessContext& context,
core::ProcessSessionFactory&) {
+ record_set_reader_ = getRecordSetIO<core::RecordSetReader>(context,
RecordReader);
+ if (!record_set_reader_) {
+ throw Exception(ExceptionType::PROCESS_SCHEDULE_EXCEPTION, "Record Reader
set is missing or invalid");
+ }
+ record_set_writer_ = getRecordSetIO<core::RecordSetWriter>(context,
RecordWriter);
+ if (!record_set_writer_) {
+ throw Exception(ExceptionType::PROCESS_SCHEDULE_EXCEPTION, "Record Writer
set is missing or invalid");
+ }
+}
+
+nonstd::expected<std::size_t, std::string>
SplitRecord::readRecordsPerSplit(core::ProcessContext& context, const
core::FlowFile& original_flow_file) {
+ std::string value;
+ std::size_t records_per_split = 0;
+ if (context.getProperty(RecordsPerSplit, value, &original_flow_file)) {
+ if (!core::Property::StringToInt(value, records_per_split)) {
+ return nonstd::make_unexpected("Failed to convert Records Per Split
property to an integer");
+ } else if (records_per_split < 1) {
+ return nonstd::make_unexpected("Records per split should be set to a
number larger than 0");
+ }
+ } else {
+ return nonstd::make_unexpected("Records per split should be set to a valid
number larger than 0");
Review Comment:
Fixed in b34afbfa89aae6398cfdafcb017e70e13934639c
##########
extensions/standard-processors/processors/SplitRecord.h:
##########
@@ -0,0 +1,86 @@
+/**
+ * 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.
+ */
+#pragma once
+
+#include "core/Annotation.h"
+#include "core/ProcessContext.h"
+#include "core/ProcessSession.h"
+#include "core/ProcessSessionFactory.h"
+#include "core/PropertyDefinition.h"
+#include "core/PropertyDefinitionBuilder.h"
+#include "core/RelationshipDefinition.h"
+#include "core/logging/Logger.h"
+#include "controllers/RecordSetReader.h"
+#include "controllers/RecordSetWriter.h"
+#include "core/AbstractProcessor.h"
+
+namespace org::apache::nifi::minifi::processors {
+
+class SplitRecord final : public core::AbstractProcessor<SplitRecord> {
+ public:
+ using core::AbstractProcessor<SplitRecord>::AbstractProcessor;
+
+ EXTENSIONAPI static constexpr const char* Description = "Splits up an input
FlowFile that is in a record-oriented data format into multiple smaller
FlowFiles";
+
+ EXTENSIONAPI static constexpr auto RecordReader =
core::PropertyDefinitionBuilder<>::createProperty("Record Reader")
+ .withDescription("Specifies the Controller Service to use for reading
incoming data")
+ .isRequired(true)
+ .withAllowedTypes<minifi::core::RecordSetReader>()
+ .build();
+ EXTENSIONAPI static constexpr auto RecordWriter =
core::PropertyDefinitionBuilder<>::createProperty("Record Writer")
+ .withDescription("Specifies the Controller Service to use for writing
out the records")
+ .isRequired(true)
+ .withAllowedTypes<minifi::core::RecordSetWriter>()
+ .build();
+ EXTENSIONAPI static constexpr auto RecordsPerSplit =
core::PropertyDefinitionBuilder<>::createProperty("Records Per Split")
+ .withDescription("Specifies how many records should be written to each
'split' or 'segment' FlowFile")
+ .isRequired(true)
+ .supportsExpressionLanguage(true)
+ .build();
+
+ EXTENSIONAPI static constexpr auto Properties =
std::to_array<core::PropertyReference>({
+ RecordReader,
+ RecordWriter,
+ RecordsPerSplit
+ });
+
+ EXTENSIONAPI static constexpr auto Failure =
core::RelationshipDefinition{"failure",
+ "If a FlowFile cannot be transformed from the configured input format to
the configured output format, the unchanged FlowFile will be routed to this
relationship."};
+ EXTENSIONAPI static constexpr auto Splits =
core::RelationshipDefinition{"splits",
+ "The individual 'segments' of the original FlowFile will be routed to
this relationship."};
+ EXTENSIONAPI static constexpr auto Original =
core::RelationshipDefinition{"original",
+ "Upon successfully splitting an input FlowFile, the original FlowFile
will be sent to this relationship."};
+ EXTENSIONAPI static constexpr auto Relationships = std::array{Failure,
Splits, Original};
+
Review Comment:
Added in b34afbfa89aae6398cfdafcb017e70e13934639c
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]