+++ /dev/null
-/*\r
- * ===============================LICENSE_START======================================\r
- * dcae-analytics\r
- * ================================================================================\r
- * Copyright © 2017 AT&T Intellectual Property. All rights reserved.\r
- * ================================================================================\r
- * Licensed under the Apache License, Version 2.0 (the "License");\r
- * you may not use this file except in compliance with the License.\r
- * You may obtain a copy of the License at\r
- *\r
- * http://www.apache.org/licenses/LICENSE-2.0\r
- *\r
- * Unless required by applicable law or agreed to in writing, software\r
- * distributed under the License is distributed on an "AS IS" BASIS,\r
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
- * See the License for the specific language governing permissions and\r
- * limitations under the License.\r
- * ============================LICENSE_END===========================================\r
- */\r
-\r
-package org.openecomp.dcae.apod.analytics.common.service.processor;\r
-\r
-import com.google.common.base.Optional;\r
-import org.openecomp.dcae.apod.analytics.common.exception.MessageProcessingException;\r
-import org.slf4j.Logger;\r
-import org.slf4j.LoggerFactory;\r
-\r
-import javax.annotation.Nonnull;\r
-\r
-import static java.lang.String.format;\r
-\r
-/**\r
- * An abstract Message Processor which can be extended by {@link MessageProcessor} implementations\r
- * to get default behavior for Message Processors\r
- *\r
- * @param <P> Processor Context sub classes\r
- *\r
- * @author Rajiv Singla . Creation Date: 11/8/2016.\r
- */\r
-public abstract class AbstractMessageProcessor<P extends ProcessorContext> implements MessageProcessor<P> {\r
-\r
- private static final Logger LOG = LoggerFactory.getLogger(AbstractMessageProcessor.class);\r
-\r
- /**\r
- * By Default there is no processing message\r
- */\r
- private String processingMessage = null;\r
-\r
- /**\r
- * By Default Processing State is set to not required - subclasses must\r
- * set processing state to {@link ProcessingState#PROCESSING_FINISHED_SUCCESSFULLY} on successful processing\r
- * or {@link ProcessingState#PROCESSING_TERMINATED_EARLY} if processing fails\r
- */\r
- protected ProcessingState processingState = ProcessingState.PROCESSING_NOT_REQUIRED;\r
-\r
- /**\r
- * Sub classes must provide a description of a processor\r
- *\r
- * @return description of processor\r
- *\r
- */\r
- public abstract String getProcessorDescription();\r
-\r
-\r
- /**\r
- * Sub classes must provide implementation to process Message\r
- *\r
- * @param processorContext incoming {@link ProcessorContext}\r
- * @return outgoing {@link ProcessorContext}\r
- */\r
- public abstract P processMessage(P processorContext);\r
-\r
- @Override\r
- public ProcessorInfo getProcessorInfo() {\r
- // by default the class of the Processor is assigned as Processor Name\r
- final String processorClassName = getClass().getSimpleName();\r
- return new GenericProcessorInfo(processorClassName, getProcessorDescription());\r
- }\r
-\r
- @Override\r
- public P preProcessor(P processorContext) {\r
- LOG.debug("Processing Started for Processor: {}", getProcessorInfo().getProcessorName());\r
- // by default check to see if continue processing Flag is not false\r
- final boolean okToContinue = processorContext.canProcessingContinue();\r
- if (!okToContinue) {\r
- final String errorMessage =\r
- format("Processor: %s. Processing Context flag okToContinue is false. Unable to proceed...",\r
- getProcessorInfo().getProcessorName());\r
- throw new MessageProcessingException(errorMessage, LOG, new IllegalStateException(errorMessage));\r
- }\r
- processingState = ProcessingState.PROCESSING_STARTED;\r
- return processorContext;\r
- }\r
-\r
- @Override\r
- public ProcessingState getProcessingState() {\r
- return processingState;\r
- }\r
-\r
- @Override\r
- public Optional<String> getProcessingMessage() {\r
- return Optional.fromNullable(processingMessage);\r
- }\r
-\r
- @Override\r
- public P postProcessor(P processorContext) {\r
- // Default implementation updates the post processing flag if processing did not\r
- // completed successfully\r
- if (processingState != ProcessingState.PROCESSING_FINISHED_SUCCESSFULLY) {\r
- LOG.debug("Processor: {}, Update Process Context State to stop Processing.",\r
- getProcessorInfo().getProcessorName());\r
- processorContext.setProcessingContinueFlag(false);\r
- }\r
- // attaches itself to message processor context\r
- processorContext.getMessageProcessors().add(this);\r
- LOG.debug("Processing Completed for Processor: {}", getProcessorInfo());\r
- return processorContext;\r
- }\r
-\r
-\r
- @Override\r
- public final P apply(@Nonnull P processorContext) {\r
- final P preProcessedProcessorContext = preProcessor(processorContext);\r
- final P processedProcessorContext = processMessage(preProcessedProcessorContext);\r
- return postProcessor(processedProcessorContext);\r
- }\r
-\r
-\r
- /**\r
- * Helper method that updates processing state in case of early termination, logs the processing\r
- * termination reason, updates Processor processing state as Terminated and sets it processing message\r
- *\r
- * @param terminatingMessage error Message\r
- * @param processorContext message processor context\r
- */\r
- protected void setTerminatingProcessingMessage(final String terminatingMessage,\r
- final P processorContext) {\r
-\r
- final String message = processorContext.getMessage();\r
- this.processingState = ProcessingState.PROCESSING_TERMINATED_EARLY;\r
- this.processingMessage = terminatingMessage;\r
- LOG.debug("Processor: {}, Early Terminating Message: {}, Incoming Message: {}",\r
- getProcessorInfo().getProcessorName(), terminatingMessage, message);\r
- }\r
-\r
- /**\r
- * Helper method that updates Processing state and logs completion message\r
- * passed\r
- *\r
- * @param processorPassingMessage Processor passing message\r
- * @param processorContext message processor context\r
- */\r
- protected void setFinishedProcessingMessage(final String processorPassingMessage, P processorContext) {\r
- final String message = processorContext.getMessage();\r
- processingState = ProcessingState.PROCESSING_FINISHED_SUCCESSFULLY;\r
- this.processingMessage = processorPassingMessage;\r
- LOG.debug("Processor: {}, Successful Completion Message: {}, Incoming Message: {}",\r
- getProcessorInfo().getProcessorName(), processorPassingMessage, message);\r
- }\r
-\r
-\r
-}\r