+.. ============LICENSE_START==========================================
+.. ===================================================================
+.. Copyright © 2017 AT&T Intellectual Property. All rights reserved.
+.. ===================================================================
+.. Licensed under the Creative Commons License, Attribution 4.0 Intl. (the "License");
+.. you may not use this documentation except in compliance with the License.
+.. You may obtain a copy of the License at
+..
+.. https://creativecommons.org/licenses/by/4.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.
+.. ============LICENSE_END============================================
+.. ECOMP is a trademark and service mark of AT&T Intellectual Property.
+
.. _appc_client_library:
==================================================
==================================================
-Revision History
-----------------
-
-+--------------+------------+---------------+--------------------------------------------------+
-| Date | Revision | Author | Changes |
-+--------------+------------+---------------+--------------------------------------------------+
-| 2017-08-22 | 1.0.0 | Paul Miller | First draft |
-+--------------+------------+---------------+--------------------------------------------------+
-+--------------+------------+---------------+--------------------------------------------------+
-
Introduction
============
Related Documentation
---------------------
-For additional information, see the ONAP Application Controller (APPC) API Guide.
+For additional information, see
+
+ :ref:`appc_api_guide`
Client Library Background
|image0|
-**Asynchronous Flow**
+Asynchronous Flow
+^^^^^^^^^^^^^^^^^
- The APPC Client Library is called using an asynchronous API using a full command object, which is mapped to a JSON representation.
- The APPC client calls the UEB client and sends the JSON command to a configured topic.
- The APPC client pulls response messages from the configured topic.
- On receiving the response for the command, the APPC client runs the relevant callback method of the consumer ResponseHandler.
-**Synchronous Flow**
+Synchronous Flow
+^^^^^^^^^^^^^^^^
- The APPC Client Library is called using a synchronous API using a full command object, which is mapped to a JSON representation.
- The APPC client calls the UEB client and sends the JSON command to a configured topic.
Client Library Usage
====================
-
+
Jar Files
---------
The client library JAR files are located in the repository under ``com\\att\\appc\\client``.
-Initialization
+Initialization
--------------
Initialize the client by calling the following method:
LifeCycleManagerStateful Interface
----------------------------------
-Generated from the APPC Yang model, this interface defines the services and request/response requirements for the ECOMP APPC component. For example, for LCM Command Audit, the following is defined:
+Generated from the APPC Yang model, this interface defines the services and request/response requirements for the ONAP APPC component. For example, for LCM Command Audit, the following is defined:
``@RPC(name="audit", outputType=AuditOutput.class)``
This defines the services and request/response requirements for the APPC component.
-Methods
---------
+Methods
+-------
The methods should match the actions described in the LCM API Guide. For each method: