org.onosproject.yms.app.ych

Class DefaultYangCodecHandler

java.lang.Object

org.onosproject.yms.app.ych.DefaultYangCodecHandler

All Implemented Interfaces:

YangCodecHandler

public class DefaultYangCodecHandler
extends Object
implements YangCodecHandler

Represents implementation of YANG SBI broker interfaces. YCH acts as a broker between YMS and driver/provider.

Constructor Summary

Constructors

Constructor and Description
DefaultYangCodecHandler(YangSchemaRegistry registry) Creates a new YANG codec handler.

Method Summary

Modifier and Type	Method and Description
void	addDeviceSchema(Class<?> yangModule) Provider / driver needs to register the device schema with code handler.
List<Object>	decode(String inputString, YangProtocolEncodingFormat dataFormat, YmsOperationType opType) When the driver or provider receive the data from the SBI protocol, It will be in the protocol specific data representation.
Object	decode(YangCompositeEncoding protoData, YangProtocolEncodingFormat dataFormat, YmsOperationType opType) When the driver or provider receive the composite data from the SBI protocol, It will be in the protocol specific data representation.
YangCompositeEncoding	encodeCompositeOperation(String rootName, String rootNamespace, Object moduleObject, YangProtocolEncodingFormat dataFormat, YmsOperationType opType) When the drivers / providers need to encode protocol composite operation requests, which is split in a composite blocks, this encode composite operation API is used.
String	encodeOperation(String rootName, String rootNamespace, Map<String,String> tagAttrMap, List<Object> moduleList, YangProtocolEncodingFormat dataFormat, YmsOperationType opType) When the drivers / providers need to encode a protocol operation requests, which is in a single block, this encode API is used.
YangModuleLibrary	getLibrary() Returns module library for YSR.
void	registerOverriddenCodec(YangDataTreeCodec overrideCodec, YangProtocolEncodingFormat dataFormat) Register the provider / driver specific overridden codec.
void	setLibrary(YangModuleLibrary library) Sets module library for YSR.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultYangCodecHandler

public DefaultYangCodecHandler(YangSchemaRegistry registry)

Creates a new YANG codec handler.

Parameters:

registry - YANG schema registry

Method Detail

addDeviceSchema

public void addDeviceSchema(Class<?> yangModule)

Description copied from interface: YangCodecHandler

Provider / driver needs to register the device schema with code handler. Then the provider / driver can use the codec handler to perform the codec operation. When the codec operation is being performed, the codec utility finds the mapping registered device model and perform the translation against the device schema.

Specified by:

addDeviceSchema in interface YangCodecHandler

Parameters:

yangModule - YANG utils generated class corresponding to SBI device schema module

encodeOperation

public String encodeOperation(String rootName,
                              String rootNamespace,
                              Map<String,String> tagAttrMap,
                              List<Object> moduleList,
                              YangProtocolEncodingFormat dataFormat,
                              YmsOperationType opType)

Description copied from interface: YangCodecHandler

When the drivers / providers need to encode a protocol operation requests, which is in a single block, this encode API is used. A single protocol operation can span across multiple application, then the driver / provider need to provide the list of application(s) module object. Each module object contains the request information corresponding to that application.

The protocols can have a logical root node which acts as a container of applications module node. For example in NETCONF, it could be data/filter/config, etc. Protocols needs to pass this parameter in the encode request, so that it is part of the encoded protocol packet. There is no validation done on the value of this parameter. It is up to the protocol to use it. It is a mandatory parameter and protocols must pass this parameter. In protocols like NETCONF, these logical root node may be in a specific name space, in such cases, it needs to be passed to encode it as part of the request. There could be additional tags that can be attached to the root node, for example in NETCONF, the tag type="subtree" can be specified. In such scenarios the required tags should be sent as a parameter.

The provider / driver would require to operate on multiple schema nodes in a single request, for example it may be require to configure a tunnel and associate a QOS to this tunnel, in this scenario, it needs to have the tunnel related information in the tunnel module's Java object and and QOS related information in QOS modules Java object. So in a single request, it can send the list of Java objects corresponding to the modules which need to participate in the operation. If the request to be generated needs to be a wild card for no application(s), then this parameter needs to be null. For example a "empty filter" request in NETCONF get request.

If the request to be generated needs to be a wild card for all application(s), then the driver / provider should not invoke this API, as there is no encoding of application related information for the operation, it is only limited to the protocol operation. For example a "no filter" request in NETCONF get request.

Specified by:

encodeOperation in interface YangCodecHandler

Parameters:

rootName - name of logical root node as required by the protocol

rootNamespace - namespace of logical root node as required by the protocol encoding. It is an optional parameter.

tagAttrMap - Specifies the list of attributes that needs to be tagged with the logical root node. It is an optional parameter if not required for the protocol.

moduleList - list of YANG module's object(s) participating in the operation.

dataFormat - data format to which encoding to be done.

opType - protocol operation being performed

Returns:

string containing the requested applications object information encoded in protocol format.

encodeCompositeOperation

public YangCompositeEncoding encodeCompositeOperation(String rootName,
                                                      String rootNamespace,
                                                      Object moduleObject,
                                                      YangProtocolEncodingFormat dataFormat,
                                                      YmsOperationType opType)

Description copied from interface: YangCodecHandler

When the drivers / providers need to encode protocol composite operation requests, which is split in a composite blocks, this encode composite operation API is used. The application module object containing the request information has both the resource identifier part and the resource information part.

The protocols can have a logical root node which acts as a container of applications module node. For example in RESTCONF, it could be RootResource/data, etc. There is no validation done on the value of this parameter. It is upto the protocol to use it. It is a mandatory parameter and protocols must pass this parameter.

The resource to be operated upon in the device is identified in a module's schema object. This modules object should contain the information about the resource on which the operation needs to be performed. The resource is identified by initial chain of objects for which operation type is none. Once the resource is reached using none operations, the actual information about the operation on the device is encoded.

Specified by:

encodeCompositeOperation in interface YangCodecHandler

Parameters:

rootName - name of logical root node as required by the protocol

rootNamespace - namespace of logical root node as required by the protocol encoding. It is optional, and there is no namespace set to the logical root node

moduleObject - object containing the information about the resource on which the operation is being performed

dataFormat - data format to which request needs to be encoded

opType - protocol operation being performed

Returns:

the composite protocol operation request.

decode

public List<Object> decode(String inputString,
                           YangProtocolEncodingFormat dataFormat,
                           YmsOperationType opType)

Description copied from interface: YangCodecHandler

When the driver or provider receive the data from the SBI protocol, It will be in the protocol specific data representation. Drivers / provider need to interact with the device using native JAVA objects. Drivers use this decode method to translate the received protocol specific simple data to YANG modeled Java objects. If the response received is not in line with the schema, for example, there is some error info, etc, then the decode operation will throw an exception and decode operation will fail.

Specified by:

decode in interface YangCodecHandler

Parameters:

inputString - input string containing the resource information in protocol format

dataFormat - data format from which decoding has to be done

opType - protocol operation being performed

Returns:

list of applications module/notification objects corresponding to the protocol data input

decode

public Object decode(YangCompositeEncoding protoData,
                     YangProtocolEncodingFormat dataFormat,
                     YmsOperationType opType)

Description copied from interface: YangCodecHandler

When the driver or provider receive the composite data from the SBI protocol, It will be in the protocol specific data representation. Drivers / provider need to interact with the device using native JAVA objects. Drivers use this Decode method to translate the received protocol specific composite data to YANG modeled Java objects.

If the response received is not in line with the schema, for example, there is some error info, etc, then the decode operation will throw an exception and decode operation will fail.

Specified by:

decode in interface YangCodecHandler

Parameters:

protoData - composite protocol data containing the resource information

dataFormat - data format from which decoding has to be done

opType - protocol operation being performed

Returns:

application module/notification object corresponding to the protocol data infput

registerOverriddenCodec

public void registerOverriddenCodec(YangDataTreeCodec overrideCodec,
                                    YangProtocolEncodingFormat dataFormat)

Description copied from interface: YangCodecHandler

Register the provider / driver specific overridden codec. This is can be used by provider to support any protocol specific extension or vendor specific implementation. This framework can also be used by providers / drivers to support any new protocol data format which is not supported by default in YANG codec utility.

Specified by:

registerOverriddenCodec in interface YangCodecHandler

Parameters:

overrideCodec - provider / driver specific overridden instance of the codec

dataFormat - data format to which encoding to be done.

getLibrary

public YangModuleLibrary getLibrary()

Returns module library for YSR.

Returns:

module library for YSR

setLibrary

public void setLibrary(YangModuleLibrary library)

Sets module library for YSR.

Parameters:

library - module library for YSR