Package org.onosproject.netconf

Class NetconfSessionAdapter

java.lang.Object

org.onosproject.netconf.AbstractNetconfSession

org.onosproject.netconf.NetconfSessionAdapter

All Implemented Interfaces:

NetconfSession

public class NetconfSessionAdapter
extends AbstractNetconfSession
implements NetconfSession

Adapter mainly intended for usage in tests.

Constructor Summary

Constructors

Constructor	Description
NetconfSessionAdapter()

Method Summary

Modifier and Type	Method	Description
void	addDeviceOutputListener(NetconfDeviceOutputEventListener listener)	Add a listener to the underlying stream handler implementation.
boolean	close()	Closes the Netconf session with the device.
boolean	copyConfig(java.lang.String netconfTargetConfig, java.lang.String newConfiguration)	Copies the new configuration, an Url or a complete configuration xml tree to the target configuration.
boolean	copyConfig(DatastoreId netconfTargetConfig, java.lang.String newConfiguration)	Copies the new configuration, an Url or a complete configuration xml tree to the target configuration.
boolean	copyConfig(DatastoreId destination, DatastoreId source)	Copies the configuration between configuration datastores.
boolean	deleteConfig(DatastoreId netconfTargetConfig)	Deletes part of the specified configuration based on the filterSchema.
java.lang.String	doWrappedRpc(java.lang.String request)	Executes an synchronous RPC to the server and wrap the request in RPC header.
boolean	editConfig(java.lang.String newConfiguration)	Retrieves part of the specified configuration based on the filterSchema.
boolean	editConfig(DatastoreId netconfTargetConfig, java.lang.String mode, java.lang.String newConfiguration)	Retrieves part of the specified configuration based on the filterSchema.
void	endSubscription()	Ends subscription to the device's notifications.
java.lang.String	get(java.lang.String request)	Retrieves the requested configuration, different from get-config.
java.lang.String	get(java.lang.String filterSchema, java.lang.String withDefaultsMode)	Retrieves the requested data.
java.lang.String	getConfig(DatastoreId netconfTargetConfig)	Retrieves the specified configuration.
java.lang.String	getConfig(DatastoreId netconfTargetConfig, java.lang.String configurationFilterSchema)	Retrieves part of the specified configuration based on the filterSchema.
java.util.Set<java.lang.String>	getDeviceCapabilitiesSet()	Gets the capabilities of the remote Netconf device associated to this session.
java.lang.String	getSessionId()	Gets the session ID of the Netconf session.
boolean	lock(DatastoreId datastore)	Locks the specified configuration.
void	removeDeviceOutputListener(NetconfDeviceOutputEventListener listener)	Remove a listener from the underlying stream handler implementation.
java.util.concurrent.CompletableFuture<java.lang.String>	request(java.lang.String request)	Executes an asynchronous RPC to the server and obtains a future to be completed.
java.lang.String	requestSync(java.lang.String request)	Executes an synchronous RPC to the server.
java.util.concurrent.CompletableFuture<java.lang.String>	rpc(java.lang.String request)	Executes an asynchronous RPC request to the server and obtains a future for it's response.
void	startSubscription()	Starts subscription to the device's notifications.
void	startSubscription(java.lang.String filterSchema)	Starts subscription to the device's notifications.
boolean	unlock(DatastoreId datastore)	Unlocks the specified configuration.

Methods inherited from class org.onosproject.netconf.AbstractNetconfSession

asyncGet, asyncGetConfig, checkReply, commit, executeRpc

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.onosproject.netconf.NetconfSession

asyncGet, asyncGetConfig, checkAndReestablish, commit, lock, requestSync, setOnosCapabilities, timeoutConnectSec, timeoutIdleSec, timeoutReplySec, unlock

Constructor Detail

NetconfSessionAdapter

public NetconfSessionAdapter()

Method Detail

startSubscription

public void startSubscription(java.lang.String filterSchema)
                       throws NetconfException

Description copied from interface: NetconfSession

Starts subscription to the device's notifications.

Specified by:

startSubscription in interface NetconfSession

Specified by:

startSubscription in class AbstractNetconfSession

Parameters:

filterSchema - XML subtrees to indicate specific notification

Throws:

NetconfException - when there is a problem starting the subscription

startSubscription

public void startSubscription()
                       throws NetconfException

Description copied from interface: NetconfSession

Starts subscription to the device's notifications.

Specified by:

startSubscription in interface NetconfSession

Overrides:

startSubscription in class AbstractNetconfSession

Throws:

NetconfException - when there is a problem starting the subscription

requestSync

public java.lang.String requestSync(java.lang.String request)
                             throws NetconfException

Description copied from interface: NetconfSession

Executes an synchronous RPC to the server.

Specified by:

requestSync in interface NetconfSession

Specified by:

requestSync in class AbstractNetconfSession

Parameters:

request - the XML containing the RPC for the server.

Returns:

Server response or ERROR

Throws:

NetconfException - when there is a problem in the communication process on the underlying connection

request

public java.util.concurrent.CompletableFuture<java.lang.String> request(java.lang.String request)
                                                                 throws NetconfException

Description copied from interface: NetconfSession

Executes an asynchronous RPC to the server and obtains a future to be completed. The caller must ensure that the message-id in any request is unique for the session

Specified by:

request in interface NetconfSession

Specified by:

request in class AbstractNetconfSession

Parameters:

request - the XML containing the RPC for the server.

Returns:

Server response or ERROR

Throws:

NetconfException - when there is a problem in the communication process on the underlying connection

rpc

public java.util.concurrent.CompletableFuture<java.lang.String> rpc(java.lang.String request)
                                                             throws NetconfException

Description copied from interface: NetconfSession

Executes an asynchronous RPC request to the server and obtains a future for it's response.

Specified by:

rpc in interface NetconfSession

Specified by:

rpc in class AbstractNetconfSession

Parameters:

request - the XML containing the RPC request for the server.

Returns:

Server response or ERROR

Throws:

NetconfException - when there is a problem in the communication process on the underlying connection

removeDeviceOutputListener

public void removeDeviceOutputListener(NetconfDeviceOutputEventListener listener)

Description copied from interface: NetconfSession

Remove a listener from the underlying stream handler implementation.

Specified by:

removeDeviceOutputListener in interface NetconfSession

Overrides:

removeDeviceOutputListener in class AbstractNetconfSession

Parameters:

listener - event listener.

getSessionId

public java.lang.String getSessionId()

Description copied from interface: NetconfSession

Gets the session ID of the Netconf session.

Specified by:

getSessionId in interface NetconfSession

Specified by:

getSessionId in class AbstractNetconfSession

Returns:

Session ID as a string.

get

public java.lang.String get(java.lang.String filterSchema,
                            java.lang.String withDefaultsMode)
                     throws NetconfException

Description copied from interface: NetconfSession

Retrieves the requested data.

Specified by:

get in interface NetconfSession

Overrides:

get in class AbstractNetconfSession

Parameters:

filterSchema - XML subtrees to include in the reply

withDefaultsMode - with-defaults mode

Returns:

Server response

Throws:

NetconfException - when there is a problem in the communication process on the underlying connection

get

public java.lang.String get(java.lang.String request)
                     throws NetconfException

Description copied from interface: NetconfSession

Retrieves the requested configuration, different from get-config.

Specified by:

get in interface NetconfSession

Overrides:

get in class AbstractNetconfSession

Parameters:

request - the XML containing the request to the server.

Returns:

device running configuration

Throws:

NetconfException - when there is a problem in the communication process on the underlying connection

endSubscription

public void endSubscription()
                     throws NetconfException

Description copied from interface: NetconfSession

Ends subscription to the device's notifications.

Specified by:

endSubscription in interface NetconfSession

Specified by:

endSubscription in class AbstractNetconfSession

Throws:

NetconfException - when there is a problem ending the subscription

editConfig

public boolean editConfig(java.lang.String newConfiguration)
                   throws NetconfException

Description copied from interface: NetconfSession

Retrieves part of the specified configuration based on the filterSchema.

Specified by:

editConfig in interface NetconfSession

Overrides:

editConfig in class AbstractNetconfSession

Parameters:

newConfiguration - configuration to set

Returns:

true if the configuration was edited correctly

Throws:

NetconfException - when there is a problem in the communication process on the underlying connection

doWrappedRpc

public java.lang.String doWrappedRpc(java.lang.String request)
                              throws NetconfException

Description copied from interface: NetconfSession

Executes an synchronous RPC to the server and wrap the request in RPC header.

Specified by:

doWrappedRpc in interface NetconfSession

Overrides:

doWrappedRpc in class AbstractNetconfSession

Parameters:

request - the XML containing the request to the server.

Returns:

Server response or ERROR

Throws:

NetconfException - when there is a problem in the communication process on the underlying connection

copyConfig

public boolean copyConfig(DatastoreId destination,
                          DatastoreId source)
                   throws NetconfException

Description copied from interface: NetconfSession

Copies the configuration between configuration datastores.

The target configuration can't be the running one

Specified by:

copyConfig in interface NetconfSession

Overrides:

copyConfig in class AbstractNetconfSession

Parameters:

destination - configuration datastore

source - configuration datastore

Returns:

true if the configuration was copied correctly

Throws:

NetconfException - when there is a problem in the communication process on the underlying connection

copyConfig

public boolean copyConfig(DatastoreId netconfTargetConfig,
                          java.lang.String newConfiguration)
                   throws NetconfException

Description copied from interface: NetconfSession

Copies the new configuration, an Url or a complete configuration xml tree to the target configuration. The target configuration can't be the running one

Specified by:

copyConfig in interface NetconfSession

Overrides:

copyConfig in class AbstractNetconfSession

Parameters:

netconfTargetConfig - the type of configuration to retrieve.

newConfiguration - configuration XML to set or URL tag to the configuration

Returns:

true if the configuration was copied correctly

Throws:

NetconfException - when there is a problem in the communication process on the underlying connection

copyConfig

public boolean copyConfig(java.lang.String netconfTargetConfig,
                          java.lang.String newConfiguration)
                   throws NetconfException

Description copied from interface: NetconfSession

Copies the new configuration, an Url or a complete configuration xml tree to the target configuration. The target configuration can't be the running one

Specified by:

copyConfig in interface NetconfSession

Overrides:

copyConfig in class AbstractNetconfSession

Parameters:

netconfTargetConfig - the type of configuration to retrieve.

newConfiguration - configuration to set

Returns:

true if the configuration was copied correctly

Throws:

NetconfException - when there is a problem in the communication process on the underlying connection

close

public boolean close()
              throws NetconfException

Description copied from interface: NetconfSession

Closes the Netconf session with the device. the first time it tries gracefully, then kills it forcefully

Specified by:

close in interface NetconfSession

Overrides:

close in class AbstractNetconfSession

Returns:

true if closed

Throws:

NetconfException - when there is a problem in the communication process on the underlying connection

addDeviceOutputListener

public void addDeviceOutputListener(NetconfDeviceOutputEventListener listener)

Description copied from interface: NetconfSession

Add a listener to the underlying stream handler implementation.

Specified by:

addDeviceOutputListener in interface NetconfSession

Overrides:

addDeviceOutputListener in class AbstractNetconfSession

Parameters:

listener - event listener.

getConfig

public java.lang.String getConfig(DatastoreId netconfTargetConfig)
                           throws NetconfException

Description copied from interface: NetconfSession

Retrieves the specified configuration.

Specified by:

getConfig in interface NetconfSession

Overrides:

getConfig in class AbstractNetconfSession

Parameters:

netconfTargetConfig - the type of configuration to retrieve.

Returns:

specified configuration.

Throws:

NetconfException - when there is a problem in the communication process on the underlying connection

getConfig

public java.lang.String getConfig(DatastoreId netconfTargetConfig,
                                  java.lang.String configurationFilterSchema)
                           throws NetconfException

Description copied from interface: NetconfSession

Retrieves part of the specified configuration based on the filterSchema.

Specified by:

getConfig in interface NetconfSession

Overrides:

getConfig in class AbstractNetconfSession

Parameters:

netconfTargetConfig - the type of configuration to retrieve.

configurationFilterSchema - XML schema to filter the configuration elements we are interested in

Returns:

device running configuration.

Throws:

NetconfException - when there is a problem in the communication process on the underlying connection

editConfig

public boolean editConfig(DatastoreId netconfTargetConfig,
                          java.lang.String mode,
                          java.lang.String newConfiguration)
                   throws NetconfException

Description copied from interface: NetconfSession

Retrieves part of the specified configuration based on the filterSchema.

Specified by:

editConfig in interface NetconfSession

Overrides:

editConfig in class AbstractNetconfSession

Parameters:

netconfTargetConfig - the targetConfiguration to change

mode - default-operation mode

newConfiguration - configuration to set

Returns:

true if the configuration was edited correctly

Throws:

NetconfException - when there is a problem in the communication process on the underlying connection

deleteConfig

public boolean deleteConfig(DatastoreId netconfTargetConfig)
                     throws NetconfException

Description copied from interface: NetconfSession

Deletes part of the specified configuration based on the filterSchema.

Specified by:

deleteConfig in interface NetconfSession

Overrides:

deleteConfig in class AbstractNetconfSession

Parameters:

netconfTargetConfig - the name of the configuration to delete

Returns:

true if the configuration was copied correctly

Throws:

NetconfException - when there is a problem in the communication process on the underlying connection

lock

public boolean lock(DatastoreId datastore)
             throws NetconfException

Description copied from interface: NetconfSession

Locks the specified configuration.

Specified by:

lock in interface NetconfSession

Overrides:

lock in class AbstractNetconfSession

Parameters:

datastore - configuration datastore to be locked

Returns:

true if successful.

Throws:

NetconfException - when there is a problem in the communication process on the underlying connection

unlock

public boolean unlock(DatastoreId datastore)
               throws NetconfException

Description copied from interface: NetconfSession

Unlocks the specified configuration.

Specified by:

unlock in interface NetconfSession

Overrides:

unlock in class AbstractNetconfSession

Parameters:

datastore - configuration datastore to be unlocked

Returns:

true if successful.

Throws:

NetconfException - when there is a problem in the communication process on the underlying connection

getDeviceCapabilitiesSet

public java.util.Set<java.lang.String> getDeviceCapabilitiesSet()

Description copied from interface: NetconfSession

Gets the capabilities of the remote Netconf device associated to this session.

Specified by:

getDeviceCapabilitiesSet in interface NetconfSession

Specified by:

getDeviceCapabilitiesSet in class AbstractNetconfSession

Returns:

Network capabilities as strings in a Set.