org.onosproject.net.pi.runtime

Interface PiPipeconfService

@Beta
public interface PiPipeconfService

A service to manage the configurations of protocol-independent pipelines.

Method Summary

Modifier and Type	Method and Description
void	bindToDevice(PiPipeconfId pipeconf, DeviceId deviceId) Binds the given pipeconf to the given infrastructure device.
Optional<PiPipeconf>	getPipeconf(PiPipeconfId id) Returns the pipeconf instance associated with the given identifier, if present.
Iterable<PiPipeconf>	getPipeconfs() Returns all pipeconfs registered.
Optional<PiPipeconfId>	ofDevice(DeviceId deviceId) Returns the pipeconf identifier currently associated with the given device identifier, if present.
void	register(PiPipeconf pipeconf) Registers the given pipeconf.

Method Detail

register

void register(PiPipeconf pipeconf)
       throws IllegalStateException

Registers the given pipeconf.

Parameters:

pipeconf - a pipeconf

Throws:

IllegalStateException - if the same pipeconf identifier is already registered.

getPipeconfs

Iterable<PiPipeconf> getPipeconfs()

Returns all pipeconfs registered.

Returns:

a collection of pipeconfs

getPipeconf

Optional<PiPipeconf> getPipeconf(PiPipeconfId id)

Returns the pipeconf instance associated with the given identifier, if present. If not present, it means that no pipeconf with such identifier has been registered so far.

Parameters:

id - a pipeconf identifier

Returns:

an optional pipeconf

bindToDevice

void bindToDevice(PiPipeconfId pipeconf,
                  DeviceId deviceId)

Binds the given pipeconf to the given infrastructure device. As a result of this method call, if the given pipeconf exposes any pipeline-specific behaviours, those will be merged to the device's driver.

Parameters:

deviceId - a device identifier

pipeconf - a pipeconf identifier

ofDevice

Optional<PiPipeconfId> ofDevice(DeviceId deviceId)

Returns the pipeconf identifier currently associated with the given device identifier, if present. If not present, it means no pipeconf has been associated with that device so far.

Parameters:

deviceId - device identifier

Returns:

an optional pipeconf identifier