Cisco Cisco Configuration Engine 3.5 开发者指南

下载
页码 344
7-3
Cisco Configuration Engine Software Development Kit API Reference and Programmer Guide 3.5
OL-17661-02
Chapter 7      Device Administration Interface API
End User Interface
Figure 7-1
Sequence of Operations for Remote Client API
1.
The client application makes a call to the CNSDeviceManager which is a part of the SDK. 
2.
The device manager object communicates the request to the Device Administration Server running 
in Cisco Configuration Engine over HTTP transport. 
3.
The server then modifies the data store to service the request and responds with the status of the data 
store operation.
End User Interface
This section describes the methods in the Administrative interface.
The Device Administration Interface has been designed based on the following principles:
  •
All attributes of the device common to all services are administered by the class 
CNSDeviceManager
  •
All attributes specific to a service are administered by classes derived from 
DeviceServiceAttributes
  •
The device name is used as the key to look up device objects. Therefore, this string must be unique 
to every device in the data store.
Status of Operations
The method of indicating the status of each operation is through error codes in the C++ implementation. 
When a client written in C++ receives an error code, it can examine an DeviceErrorInfo object that can 
be obtained from the getDeviceErrorInfo method. This object contains information about the precise 
nature of the error.
In the Java implementation, an exception is thrown for each type of error.
For the function signatures, please refer to 
 or 
createDevice (attributes)
createDeviceRequest (attributes)
createDeviceObject (attributes)
Sequence of operations for Remote Client API
Client 
Applic ation
CNSDevice
Manager
CNS Device 
Admin Server
Data Store