org.onosproject.incubator.net.virtual

Interface VirtualNetworkFlowRuleStore

All Superinterfaces:

VirtualStore<FlowRuleBatchEvent,FlowRuleStoreDelegate>

public interface VirtualNetworkFlowRuleStore
extends VirtualStore<FlowRuleBatchEvent,FlowRuleStoreDelegate>

Manages inventory of flow rules for virtual networks; not intended for direct use.

Method Summary

Modifier and Type	Method and Description
FlowRuleEvent	addOrUpdateFlowRule(NetworkId networkId, FlowEntry rule) Stores a new flow rule, or updates an existing entry.
void	batchOperationComplete(NetworkId networkId, FlowRuleBatchEvent event) Invoked on the completion of a storeBatch operation.
void	deleteFlowRule(NetworkId networkId, FlowRule rule) Marks a flow rule for deletion.
Iterable<FlowEntry>	getFlowEntries(NetworkId networkId, DeviceId deviceId) Returns the flow entries associated with a device.
FlowEntry	getFlowEntry(NetworkId networkId, FlowRule rule) Returns the stored flow.
int	getFlowRuleCount(NetworkId networkId) Returns the number of flow rule in the store.
Iterable<TableStatisticsEntry>	getTableStatistics(NetworkId networkId, DeviceId deviceId) Returns the flow table statistics associated with a device.
FlowRuleEvent	pendingFlowRule(NetworkId networkId, FlowEntry rule) Marks a flow rule as PENDING_ADD during retry.
default void	purgeFlowRule(NetworkId networkId, DeviceId deviceId) Removes all flow entries of given device from store.
void	purgeFlowRules(NetworkId networkId) Removes all flow entries from store.
FlowRuleEvent	removeFlowRule(NetworkId networkId, FlowEntry rule) Removes an existing flow entry.
void	storeBatch(NetworkId networkId, FlowRuleBatchOperation batchOperation) Stores a batch of flow rules.
FlowRuleEvent	updateTableStatistics(NetworkId networkId, DeviceId deviceId, List<TableStatisticsEntry> tableStats) Updates the flow table statistics of the specified device using the given statistics.

Methods inherited from interface org.onosproject.incubator.net.virtual.VirtualStore

hasDelegate, setDelegate, unsetDelegate

Method Detail

getFlowRuleCount

int getFlowRuleCount(NetworkId networkId)

Returns the number of flow rule in the store.

Parameters:

networkId - virtual network identifier

Returns:

number of flow rules

getFlowEntry

FlowEntry getFlowEntry(NetworkId networkId,
                       FlowRule rule)

Returns the stored flow.

Parameters:

networkId - virtual network identifier

rule - the rule to look for

Returns:

a flow rule

getFlowEntries

Iterable<FlowEntry> getFlowEntries(NetworkId networkId,
                                   DeviceId deviceId)

Returns the flow entries associated with a device.

Parameters:

networkId - virtual network identifier

deviceId - the device ID

Returns:

the flow entries

storeBatch

void storeBatch(NetworkId networkId,
                FlowRuleBatchOperation batchOperation)

Stores a batch of flow rules.

Parameters:

networkId - virtual network identifier

batchOperation - batch of flow rules. A batch can contain flow rules for a single device only.

batchOperationComplete

void batchOperationComplete(NetworkId networkId,
                            FlowRuleBatchEvent event)

Invoked on the completion of a storeBatch operation.

Parameters:

networkId - virtual network identifier

event - flow rule batch event

deleteFlowRule

void deleteFlowRule(NetworkId networkId,
                    FlowRule rule)

Marks a flow rule for deletion. Actual deletion will occur when the provider indicates that the flow has been removed.

Parameters:

networkId - virtual network identifier

rule - the flow rule to delete

addOrUpdateFlowRule

FlowRuleEvent addOrUpdateFlowRule(NetworkId networkId,
                                  FlowEntry rule)

Stores a new flow rule, or updates an existing entry.

Parameters:

networkId - virtual network identifier

rule - the flow rule to add or update

Returns:

flow_added event, or null if just an update

removeFlowRule

FlowRuleEvent removeFlowRule(NetworkId networkId,
                             FlowEntry rule)

Removes an existing flow entry.

Parameters:

rule - the flow entry to remove

networkId - virtual network identifier

Returns:

flow_removed event, or null if nothing removed

pendingFlowRule

FlowRuleEvent pendingFlowRule(NetworkId networkId,
                              FlowEntry rule)

Marks a flow rule as PENDING_ADD during retry. Emits flow_update event if the state is changed

Parameters:

networkId - virtual network identifier

rule - the flow rule that is retrying

Returns:

flow_updated event, or null if nothing updated

purgeFlowRule

default void purgeFlowRule(NetworkId networkId,
                           DeviceId deviceId)

Removes all flow entries of given device from store.

Parameters:

networkId - virtual network identifier

deviceId - device id

purgeFlowRules

void purgeFlowRules(NetworkId networkId)

Removes all flow entries from store.

Parameters:

networkId - virtual network identifier

updateTableStatistics

FlowRuleEvent updateTableStatistics(NetworkId networkId,
                                    DeviceId deviceId,
                                    List<TableStatisticsEntry> tableStats)

Updates the flow table statistics of the specified device using the given statistics.

Parameters:

networkId - virtual network identifier

deviceId - device identifier

tableStats - list of table statistics

Returns:

ready to send event describing what occurred;

getTableStatistics

Iterable<TableStatisticsEntry> getTableStatistics(NetworkId networkId,
                                                  DeviceId deviceId)

Returns the flow table statistics associated with a device.

Parameters:

networkId - virtual network identifier

deviceId - the device ID

Returns:

the flow table statistics