org.onosproject.net.driver

Interface Driver

All Superinterfaces:

Annotations

All Known Implementing Classes:

DefaultDriver

public interface Driver
extends Annotations

Representation of a specific family of device drivers. Behaviour configuration data is stored using Annotations.

Method Summary

Modifier and Type	Method and Description
Set<Class<? extends Behaviour>>	behaviours() Returns the set of behaviours supported by this driver.
<T extends Behaviour> T	createBehaviour(DriverData data, Class<T> behaviourClass) Creates an instance of behaviour primed with the specified driver data.
<T extends Behaviour> T	createBehaviour(DriverHandler handler, Class<T> behaviourClass) Creates an instance of behaviour primed with the specified driver handler.
boolean	hasBehaviour(Class<? extends Behaviour> behaviourClass) Indicates whether or not the driver, or any of its parents, support the specified class of behaviour.
String	hwVersion() Returns the device hardware version.
Class<? extends Behaviour>	implementation(Class<? extends Behaviour> behaviour) Returns the implementation class for the specified behaviour.
String	manufacturer() Returns the device manufacturer name.
Driver	merge(Driver other) Merges the specified driver behaviours and properties into this one, giving preference to the other driver when dealing with conflicts.
String	name() Returns the driver name.
Driver	parent() Deprecated. 1.5.0 Falcon Release
List<Driver>	parents() Returns all the parent drivers from which this driver inherits behaviours and properties.
Map<String,String>	properties() Returns the set of annotations as map of key/value properties.
String	swVersion() Returns the device software version.

Methods inherited from interface org.onosproject.net.Annotations

keys, value

Method Detail

name

String name()

Returns the driver name. This is expected to be a reverse-DNS, Java package-like name.

Returns:

driver name

parent

@Deprecated
Driver parent()

Deprecated. 1.5.0 Falcon Release

Returns the parent driver from which this driver inherits behaviours and properties.

Returns:

parent driver; null if driver has no parent

parents

List<Driver> parents()

Returns all the parent drivers from which this driver inherits behaviours and properties.

Returns:

list of parent drivers

manufacturer

String manufacturer()

Returns the device manufacturer name.

Returns:

manufacturer name

hwVersion

String hwVersion()

Returns the device hardware version.

Returns:

hardware version

swVersion

String swVersion()

Returns the device software version.

Returns:

software version

behaviours

Set<Class<? extends Behaviour>> behaviours()

Returns the set of behaviours supported by this driver. It reflects behaviours of only this driver and not its parent.

Returns:

set of device driver behaviours

implementation

Class<? extends Behaviour> implementation(Class<? extends Behaviour> behaviour)

Returns the implementation class for the specified behaviour. It reflects behaviours of only this driver and not its parent.

Parameters:

behaviour - behaviour interface

Returns:

implementation class

hasBehaviour

boolean hasBehaviour(Class<? extends Behaviour> behaviourClass)

Indicates whether or not the driver, or any of its parents, support the specified class of behaviour.

Parameters:

behaviourClass - behaviour class

Returns:

true if behaviour is supported

createBehaviour

<T extends Behaviour> T createBehaviour(DriverData data,
                                        Class<T> behaviourClass)

Creates an instance of behaviour primed with the specified driver data. If the current driver does not support the specified behaviour and the driver has parent, the request is delegated to the parent driver.

Type Parameters:

T - type of behaviour

Parameters:

data - driver data context

behaviourClass - driver behaviour class

Returns:

behaviour instance

createBehaviour

<T extends Behaviour> T createBehaviour(DriverHandler handler,
                                        Class<T> behaviourClass)

Creates an instance of behaviour primed with the specified driver handler. If the current driver does not support the specified behaviour and the driver has parent, the request is delegated to the parent driver.

Type Parameters:

T - type of behaviour

Parameters:

handler - driver handler context

behaviourClass - driver behaviour class

Returns:

behaviour instance

properties

Map<String,String> properties()

Returns the set of annotations as map of key/value properties.

Returns:

map of properties

merge

Driver merge(Driver other)

Merges the specified driver behaviours and properties into this one, giving preference to the other driver when dealing with conflicts.

Parameters:

other - other driver

Returns:

merged driver