From cf86a1ca9b936ee3313614b5ff3b465971dff899 Mon Sep 17 00:00:00 2001
From: rn509j <rn509j@att.com>
Date: Tue, 10 Oct 2017 12:22:25 -0400
Subject: [PATCH] commiting code for document changes

DMAAP-153
Signed-off-by: rn509j <rn509j@att.com>
Change-Id: I55c02ec2b963fa1721ffca83d2f6bbd9551be103
---
 docs/message router.jpg                | Bin 0 -> 38995 bytes
 docs/message-router/message-router.rst |  60 ++++++++++++++++++++++++++++++---
 2 files changed, 55 insertions(+), 5 deletions(-)
 create mode 100644 docs/message router.jpg

diff --git a/docs/message router.jpg b/docs/message router.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..100973dcd07b48ff8a3250fd56a794478dc8dccd
GIT binary patch
literal 38995
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

literal 0
HcmV?d00001

diff --git a/docs/message-router/message-router.rst b/docs/message-router/message-router.rst
index 4289a61..fbd7015 100644
--- a/docs/message-router/message-router.rst
+++ b/docs/message-router/message-router.rst
@@ -1,6 +1,18 @@
 ============================================
 Message Router (MR) API Guide
 ============================================
+Architecture
+-------------
+
+In DMaaP Message Router, Restful web service is exposed to client to perform any needed action with Kafka. After getting the request it calls the Message router service layer which is created using AJSC ( AT&T Java Service Container) . AJSC finally calls Kafka services and response is sent back.
+
+|image0|
+
+.. |image0| image:: message router.jpg
+   :height: 600px
+   :width: 800px
+
+
 
 HTTP Service APIs
 ------------------
@@ -206,7 +218,7 @@ Request Parameters:
 +-------------+---------------------------------+------------------+------------+--------------+-------------+-------------+-------------------------------------------------+
 | Name        | Description                     |  Param Type      |  data type |   MaxLen     |  Req’d      |  Format     |  Valid/Example Values                           |
 | 			  | 								|				   |            |              |             |             | 												 |
-+-------------+---------------------------------+------------------+------------+--------------+-------------+-------------+-------------------------------------------------+
++=============+=================================+==================+============+==============+=============+=============+=================================================+
 | Topicname   | topic name to be posted         |     Path         |   String   |        40    |     Y       | namespace.  |												 |
 |			  |									| 				   |            |              |             |  String     |                                                 |
 +-------------+---------------------------------+------------------+------------+--------------+-------------+-------------+-------------------------------------------------+	       
@@ -259,7 +271,7 @@ Response Parameters:
 |
 +-------------------------+-----------------+----------------------------+----------------------------------------------------------------------------------------------------+
 | Error code              |  HTTP Code      |  Description               |Issue reason                                                                                        |
-+-------------------------+-----------------+----------------------------+----------------------------------------------------------------------------------------------------+
++=========================+=================+============================+====================================================================================================+
 | DMaaP\_MR\_ERR\_3008    | 413             | Request Entity too large   | Message size exceeds the batch limit <limit>.Reduce the batch size and try again                   | +-------------------------+-----------------+----------------------------+----------------------------------------------------------------------------------------------------+
 | DMaaP\_MR\_ERR\_3009    | 500             | Internal Server Error      | Unable to publish messages. Please contact administartor                                           | +-------------------------+-----------------+----------------------------+----------------------------------------------------------------------------------------------------+
 | DMaaP\_MR\_ERR\_3010    | 400             | Bad Request                | Incorrect Batching format. Please correct the batching format and try again                        | +-------------------------+-----------------+----------------------------+----------------------------------------------------------------------------------------------------+
@@ -295,7 +307,7 @@ Request Parameters:
 +----------------+---------------------------------+------------------+------------+--------------+-------------+-------------+-----------------------------------+
 | Name           | Description                     |  Param Type      |  data type |   MaxLen     |  Req’d      |  Format     |  Valid/Example Values             |
 | 			     | 								   |				  |            |              |             |             | 					              |
-+----------------+---------------------------------+------------------+------------+--------------+-------------+-------------+-----------------------------------+
++================+=================================+==================+============+==============+=============+=============+===================================+
 | Topicname      | topicname to be created in MR   |     Body         |   String   |        20    |     Y       | Json        |		com.att.dmaap.mr.metrics      |
 +----------------+---------------------------------+------------------+------------+--------------+-------------+-------------+-----------------------------------+       
 |topicDescription|   description for topic         |      Body        |   String   |     15       | Y           |             |                                   |
@@ -323,7 +335,7 @@ Request Parameters:
 
 +-------------------------+-----------------+--------------------------------------------------+
 | Error code              |  HTTP Code      |  Description                                     |
-+-------------------------+-----------------+--------------------------------------------------+
++=========================+=================+==================================================+
 | DMaaP\_MR\_ERR\_5001    | 500             | Failed to retrieve list of all topics            | +-------------------------+-----------------+--------------------------------------------------+
 | DMaaP\_MR\_ERR\_5002    | 500             | Failed to retrieve details of topic:<topicName>  |     |+-------------------------+----------------+--------------------------------------------------+
 | DMaaP\_MR\_ERR\_5003    | 500             |Failed to create topic:<topicName>                | +-------------------------+-----------------+--------------------------------------------------+
@@ -466,7 +478,45 @@ ex: http://<hostname>:3904/dmaap/v1/topics/com.att.dmaap.mr.testopic
 
 +-------------------------+---------------------------------------------+----------------------+
 | Error code              |    Description                              |HTTP code             |
-+-------------------------+---------------------------------------------+----------------------+
++=========================+=============================================+======================+
 |  DMaaP\_MR\_ERR\_5004   |  Failed to delete topic:<topicName>         |   500                |   
 +-------------------------+---------------------------------------------+----------------------+
 
+API Inventory
+------------- 
+
++-----------+-------------------+-----------------------------------------+---------------------------------------+----------------+----------------------------------+
+|           |   API Name        |   API Method                            |   REST API Path                       |                | Comments                         |
++===========+===================+=========================================+=======================================+================+==================================+
+| Topics    | GetAll Topics List|  getTopics()                            | /topics                               | GET            |                                  |
+|           +-------------------+-----------------------------------------+---------------------------------------+----------------+----------------------------------+
+|           | Get All Topics    |                                         |                                       |                |                                  |
+|           |List with details  | getAllTopics()                          | /topics/listAll                       | GET            |                                  |
+|           +-------------------+-----------------------------------------+---------------------------------------+----------------+----------------------------------+
+|           | Get individual    |                                         |                                       |                |                                  |
+|           | Topic Details     | getTopic(String topicName)              | /topics/{topicName}                   | GET            |                                  |
+|           +-------------------+-----------------------------------------+---------------------------------------+----------------+----------------------------------+
+|           | Create Topic      | createTopic(TopicBean topicBean)        | /topics/create                        | POST           |                                  |
+|           +-------------------+-----------------------------------------+---------------------------------------+----------------+----------------------------------+
+|           | Delete Topic      | deleteTopicString topicName)            | /topics/{topicName}                   | DELETE         |  Not used in current MR version  |
+|           +-------------------+-----------------------------------------+---------------------------------------+----------------+----------------------------------+
+|           | Get Publishers for| getPublishersByTopicName                |                                       |                |                                  |
+|           | a Topic           | (String topicName)                      | /topics/{topicName}/producers         | GET            |  UEB Backward Compatibility      |
+|           +-------------------+-----------------------------------------+---------------------------------------+----------------+                                  |
+|           | Add a Publisher to|permitPublisherForTopic(String topicName,| /topics/{topicName}/producers/        |                |                                  |
+|           |write ACLon a Topic|     String producerId)                  |    {producerId}                       | PUT            |                                  |
+|           +-------------------+-----------------------------------------+---------------------------------------+----------------+                                  |
+|           | Remove a Publisher|denyPublisherForTopic(String   topicName,|/topics/{topicName}/producers/         |                |                                  | 
+|           |from write   ACL on|String producerId)                       |{producerId}                           |   DELETE       |                                  |
+|           | a Topic           |                                         |                                       |                |                                  |
+|           +-------------------+-----------------------------------------+---------------------------------------+----------------+                                  |
+|           |Get Consumers for a| getConsumersByTopicName                 |  /topics/{topicName}/consumers        |       GET      |                                  |
+|           |  Topic            | (String topicName)                      |                                       |                |                                  |
+|           +-------------------+-----------------------------------------+---------------------------------------+----------------+                                  |
+|           | Add a Consumer to | permitConsumerForTopic(String topicName,|   /topics/{topicName}/consumers/      |      PUT       |                                  |
+|           |read ACL on a Topic|      String consumerId)                 |       {consumerId}                    |                |                                  |    
+|           +-------------------+-----------------------------------------+---------------------------------------+----------------+                                  |
+|           | Remove a consumer |denyPublisherForTopic(String   topicName,|/topics/{topicName}/consumers/         |                |                                  | 
+|           |from write   ACL on|String consumerId)                       |{consumerId}                           |                |                                  |
+|           | a Topic           |                                         |                                       |    DELETE      |                                  |
++-----------+-------------------+-----------------------------------------+---------------------------------------+----------------+----------------------------------+
-- 
2.16.6