src/main/java/com/att/dmf/mr/backends/Publisher.java

   1 /*******************************************************************************
   2  *  ============LICENSE_START=======================================================
   3  *  org.onap.dmaap
   4  *  ================================================================================
   5  *  Copyright © 2017 AT&T Intellectual Property. All rights reserved.
   6  *  ================================================================================
   7  *  Licensed under the Apache License, Version 2.0 (the "License");
   8  *  you may not use this file except in compliance with the License.
   9  *  You may obtain a copy of the License at
  10  *        http://www.apache.org/licenses/LICENSE-2.0
  11 *
  12  *  Unless required by applicable law or agreed to in writing, software
  13  *  distributed under the License is distributed on an "AS IS" BASIS,
  14  *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15  *  See the License for the specific language governing permissions and
  16  *  limitations under the License.
  17  *  ============LICENSE_END=========================================================
  18  *
  19  *  ECOMP is a trademark and service mark of AT&T Intellectual Property.
  20  *
  21  *******************************************************************************/
  22 package com.att.dmf.mr.backends;
  23
  24 import java.io.IOException;
  25 import java.util.ArrayList;
  26 import java.util.List;
  27
  28 import org.apache.kafka.clients.producer.ProducerRecord;
  29
  30 import com.att.dmf.mr.beans.LogDetails;
  31
  32 //import kafka.producer.KeyedMessage;
  33 /**
  34  * A publisher interface. Publishers receive messages and post them to a topic.
  35  * @author peter
  36  */
  37 public interface Publisher
  38 {
  39         /**
  40          * A message interface. The message has a key and a body.
  41          * @author peter
  42          */
  43         public interface message
  44         {
  45                 /**
  46                  * Get the key for this message. The key is used to partition messages
  47                  * into "sub-streams" that have guaranteed order. The key can be null,
  48                  * which means the message can be processed without any concern for order.
  49                  *
  50                  * @return a key, possibly null
  51                  */
  52                 String getKey();
  53
  54                 /**
  55                  * Get the message body.
  56                  * @return a message body
  57                  */
  58                 String getMessage();
  59                 /**
  60                  * set the logging params for transaction enabled logging
  61                  * @param logDetails
  62                  */
  63                 void setLogDetails (LogDetails logDetails);
  64                 /**
  65                  * Get the log details for transaction enabled logging
  66                  * @return LogDetails
  67                  */
  68                 LogDetails getLogDetails ();
  69
  70                 /**
  71                  * boolean transactionEnabled
  72                  * @return true/false
  73                  */
  74                 boolean isTransactionEnabled();
  75                 /**
  76                  * Set the transaction enabled flag from prop file or topic based implementation
  77                  * @param transactionEnabled
  78                  */
  79                 void setTransactionEnabled(boolean transactionEnabled);
  80         }
  81
  82         /**
  83          * Send a single message to a topic. Equivalent to sendMessages with a list of size 1.
  84          * @param topic
  85          * @param msg
  86          * @throws IOException
  87          */
  88         public void sendMessage ( String topic, message msg ) throws IOException;
  89
  90         /**
  91          * Send messages to a topic.
  92          * @param topic
  93          * @param msgs
  94          * @throws IOException
  95          */
  96         public void sendMessages ( String topic, List<? extends message> msgs ) throws IOException;
  97
  98         //public void sendBatchMessage(String topic ,ArrayList<KeyedMessage<String,String>> kms) throws IOException;
  99         public void sendBatchMessageNew(String topic ,ArrayList<ProducerRecord<String,String>> kms) throws IOException;
 100         public void sendMessagesNew( String topic, List<? extends message> msgs ) throws IOException;
 101 }