Sho SHIMIZU
Committed by Gerrit Code Review

Follow the convention of javadoc used in the project

Insert a blank line between the brief desciption and paramter description.

Change-Id: Iad27f20aa862f84a4278624f0df75f98ab9e543f
......@@ -22,24 +22,28 @@ public interface Load {
/**
* Obtain the current observed rate (in bytes/s) on a link.
*
* @return long value
*/
long rate();
/**
* Obtain the latest bytes counter viewed on that link.
*
* @return long value
*/
long latest();
/**
* Indicates whether this load was built on valid values.
*
* @return boolean
*/
boolean isValid();
/**
* Returns when this value was seen.
*
* @return epoch time
*/
long time();
......
......@@ -29,6 +29,7 @@ public interface StatisticService {
/**
* Obtain the load for a the ingress to the given link.
*
* @param link the link to query.
* @return a {@link org.onlab.onos.net.statistic.Load Load}
*/
......@@ -36,6 +37,7 @@ public interface StatisticService {
/**
* Obtain the load for the given port.
*
* @param connectPoint the port to query
* @return a {@link org.onlab.onos.net.statistic.Load}
*/
......@@ -43,6 +45,7 @@ public interface StatisticService {
/**
* Find the most loaded link along a path.
*
* @param path the path to search in
* @return the most loaded {@link org.onlab.onos.net.Link}.
*/
......@@ -50,6 +53,7 @@ public interface StatisticService {
/**
* Find the least loaded link along a path.
*
* @param path the path to search in
* @return the least loaded {@link org.onlab.onos.net.Link}.
*/
......@@ -58,6 +62,7 @@ public interface StatisticService {
/**
* Returns the highest hitter (a flow rule) for a given port, ie. the
* flow rule which is generating the most load.
*
* @param connectPoint the port
* @return the flow rule
*/
......
......@@ -28,24 +28,28 @@ public interface StatisticStore {
/**
* Lay the foundation for receiving flow stats for this rule.
*
* @param rule a {@link org.onlab.onos.net.flow.FlowRule}
*/
void prepareForStatistics(FlowRule rule);
/**
* Remove entries associated with this rule.
*
* @param rule {@link org.onlab.onos.net.flow.FlowRule}
*/
void removeFromStatistics(FlowRule rule);
/**
* Adds a stats observation for a flow rule.
*
* @param rule a {@link org.onlab.onos.net.flow.FlowEntry}
*/
void addOrUpdateStatistic(FlowEntry rule);
/**
* Fetches the current observed stats values.
*
* @param connectPoint the port to fetch information for
* @return set of current flow rules
*/
......@@ -53,6 +57,7 @@ public interface StatisticStore {
/**
* Fetches the current observed stats values.
*
* @param connectPoint the port to fetch information for
* @return set of current values
*/
......