Fix javadoc JDK8 compatibility 83/19683/2
authorRobert Varga <rovarga@cisco.com>
Tue, 5 May 2015 14:58:01 +0000 (16:58 +0200)
committerRobert Varga <rovarga@cisco.com>
Wed, 6 May 2015 09:16:41 +0000 (11:16 +0200)
JDK8 is more picky about javadoc correctness -- fix it up so we can pass
compilation.

Change-Id: Iae446e890afe91c6ca0b670c2ea53f18793b5e99
Signed-off-by: Robert Varga <rovarga@cisco.com>
22 files changed:
library/src/main/java/org/opendaylight/ovsdb/lib/LockAquisitionCallback.java
library/src/main/java/org/opendaylight/ovsdb/lib/LockStolenCallback.java
library/src/main/java/org/opendaylight/ovsdb/lib/OvsdbConnectionListener.java
library/src/main/java/org/opendaylight/ovsdb/lib/notation/Version.java
library/src/main/java/org/opendaylight/ovsdb/lib/schema/typed/TyperUtils.java
northbound/src/main/java/org/opendaylight/ovsdb/northbound/OvsdbNorthboundV2.java
openstack/net-virt/src/main/java/org/opendaylight/ovsdb/openstack/netvirt/AbstractHandler.java
openstack/net-virt/src/main/java/org/opendaylight/ovsdb/openstack/netvirt/FloatingIPHandler.java
openstack/net-virt/src/main/java/org/opendaylight/ovsdb/openstack/netvirt/NeutronCacheUtils.java
openstack/net-virt/src/main/java/org/opendaylight/ovsdb/openstack/netvirt/PortHandler.java
openstack/net-virt/src/main/java/org/opendaylight/ovsdb/openstack/netvirt/SouthboundHandler.java
openstack/net-virt/src/main/java/org/opendaylight/ovsdb/openstack/netvirt/api/BridgeConfigurationManager.java
openstack/net-virt/src/main/java/org/opendaylight/ovsdb/openstack/netvirt/api/ConfigurationService.java
openstack/net-virt/src/main/java/org/opendaylight/ovsdb/openstack/netvirt/api/NetworkingProviderManager.java
openstack/net-virt/src/main/java/org/opendaylight/ovsdb/openstack/netvirt/api/TenantNetworkManager.java
openstack/net-virt/src/main/java/org/opendaylight/ovsdb/openstack/netvirt/api/VlanConfigurationCache.java
ovsdb-plugin-compatibility-layer/src/main/java/org/opendaylight/ovsdb/compatibility/plugin/api/OvsdbConfigurationService.java
plugin/src/main/java/org/opendaylight/ovsdb/plugin/api/OvsdbConfigurationService.java
plugin/src/main/java/org/opendaylight/ovsdb/plugin/impl/ConfigurationServiceImpl.java
plugin/src/main/java/org/opendaylight/ovsdb/plugin/impl/ConnectionServiceImpl.java
utils/mdsal-openflow/src/main/java/org/opendaylight/ovsdb/utils/mdsal/openflow/InstructionUtils.java
utils/mdsal-openflow/src/main/java/org/opendaylight/ovsdb/utils/mdsal/openflow/MatchUtils.java

index 3b5f817f4141112af1c75a6d2c840f8440e1f5c0..23d49dcbf258483223da998ec3801766b6f24ecd 100644 (file)
@@ -16,8 +16,6 @@ package org.opendaylight.ovsdb.lib;
  *  Callback that can be registered with {@link OvsdbClient} to
  *  get notified of a lock stolen.
  *  @see <a href="http://tools.ietf.org/html/draft-pfaff-ovsdb-proto-04#section-4.1.10">ovsdb spec</a>
- *  <p/>
- *
  *  @see OvsdbClient
  */
 public interface LockAquisitionCallback {
index 64ff6f39d54b47bc4d1fd8c349a6127e5d8c22dc..5643d729d89ac7a86e4475b8fe98dc4bc24f60f9 100644 (file)
@@ -16,7 +16,7 @@ package org.opendaylight.ovsdb.lib;
  *  Callback that can be registered with {@link org.opendaylight.ovsdb.lib.OvsdbClient} to
  *  get notified of a lock stolen.
  *  @see <a href="http://tools.ietf.org/html/draft-pfaff-ovsdb-proto-04#section-4.1.10">ovsdb spec</a>
- *  <p/>
+ *  <p>
  *
  *  @see org.opendaylight.ovsdb.lib.OvsdbClient#lock(String, LockAquisitionCallback, LockStolenCallback)
  */
index 5026daf4c7851ecd7e2281fec87246ae1e6a272d..b6ccbd6b5bfb62816b474d7dd96ee14282223d77 100644 (file)
@@ -16,13 +16,13 @@ package org.opendaylight.ovsdb.lib;
 public interface OvsdbConnectionListener {
     /**
      * Event thrown to the connection listener when a new Passive connection is established.
-     * @param OvsdbClient that represents the connection.
+     * @param client OvsdbClient that represents the connection.
      */
     public void connected(OvsdbClient client);
 
     /**
      * Event thrown to the connection listener when an existing connection is terminated.
-     * @param OvsdbClient that represents the connection.
+     * @param client OvsdbClient that represents the connection.
      */
     public void disconnected(OvsdbClient client);
 }
index 53f05b4c4b76365a35a30925148c183a7296b2d3..267d7f553332191e43e47ef617ea1e096d1efadc 100644 (file)
@@ -16,7 +16,7 @@ import java.util.regex.Pattern;
 /**
  * This class represents a version according to RFC 7047
  * The default implementation assumes the left-most digit is most significant when performing comparisons
- * @see <a href-="http://tools.ietf.org/html/rfc7047#section-3.1">RFC7047 Section 3.1</a>
+ * @see <a href="http://tools.ietf.org/html/rfc7047#section-3.1">RFC7047 Section 3.1</a>
  */
 public class Version implements Comparable<Version> {
 
index 1131900fc71be700edbdedf52c7ac3bb9b981f05..114f3b3865e177ed5ec26281c17ab21388b1ac38 100644 (file)
@@ -233,7 +233,7 @@ public class TyperUtils {
      * provide a type-safe infrastructure for the applications to built on top of.
      * And this Typed infra is completely optional.
      *
-     * It is the applications responsibility to pass on the raw Row parameter & this method will
+     * It is the applications responsibility to pass on the raw Row parameter and this method will
      * return the appropriate Proxy wrapper for the passed klazz Type.
      * The raw Row parameter may be null if the caller is interested in just the ColumnSchema.
      * But that is not a very common use-case.
@@ -254,7 +254,7 @@ public class TyperUtils {
      * to provide a type-safe infrastructure for the applications to built on top of.
      * And this Typed infra is completely optional.
      *
-     * It is the applications responsibility to pass on the raw Row parameter & this method
+     * It is the applications responsibility to pass on the raw Row parameter and this method
      * will return the appropriate Proxy wrapper for the passed klazz Type.
      * The raw Row parameter may be null if the caller is interested in just the
      * ColumnSchema. But that is not a very common use-case.
@@ -427,17 +427,17 @@ public class TyperUtils {
     }
 
     /**
-     * This method extracts all row updates of Class<T> klazz from a TableUpdates
+     * This method extracts all row updates of Class&lt;T&gt; klazz from a TableUpdates
      * that correspond to insertion or updates of rows of type klazz.
      * Example:
      * <code>
-     * Map<UUID,Bridge> updatedBridges = extractRowsUpdated(Bridge.class,updates,dbSchema)
+     * Map&lt;UUID,Bridge&gt; updatedBridges = extractRowsUpdated(Bridge.class,updates,dbSchema)
      * </code>
      *
      * @param klazz Class for row type to be extracted
      * @param updates TableUpdates from which to extract rowUpdates
      * @param dbSchema Dbschema for the TableUpdates
-     * @return Map<UUID,T> for the type of things being sought
+     * @return Map&lt;UUID,T&gt; for the type of things being sought
      */
     public static <T> Map<UUID,T> extractRowsUpdated(Class<T> klazz,TableUpdates updates,DatabaseSchema dbSchema) {
         Preconditions.checkNotNull(klazz);
@@ -458,17 +458,17 @@ public class TyperUtils {
     }
 
     /**
-     * This method extracts all row updates of Class<T> klazz from a TableUpdates
+     * This method extracts all row updates of Class&lt;T&gt; klazz from a TableUpdates
      * that correspond to old version of rows of type klazz that have been updated
      * Example:
      * <code>
-     * Map<UUID,Bridge> oldBridges = extractRowsOld(Bridge.class,updates,dbSchema)
+     * Map&lt;UUID,Bridge&gt; oldBridges = extractRowsOld(Bridge.class,updates,dbSchema)
      * </code>
      *
      * @param klazz Class for row type to be extracted
      * @param updates TableUpdates from which to extract rowUpdates
      * @param dbSchema Dbschema for the TableUpdates
-     * @return Map<UUID,T> for the type of things being sought
+     * @return Map&lt;UUID,T&gt; for the type of things being sought
      */
     public static <T> Map<UUID,T> extractRowsOld(Class<T> klazz,TableUpdates updates,DatabaseSchema dbSchema) {
         Preconditions.checkNotNull(klazz);
@@ -489,17 +489,17 @@ public class TyperUtils {
     }
 
     /**
-     * This method extracts all row updates of Class<T> klazz from a TableUpdates
+     * This method extracts all row updates of Class&lt;T&gt; klazz from a TableUpdates
      * that correspond to removal of rows of type klazz.
      * Example:
      * <code>
-     * Map<UUID,Bridge> updatedBridges = extractRowsRemoved(Bridge.class,updates,dbSchema)
+     * Map&lt;UUID,Bridge&gt; updatedBridges = extractRowsRemoved(Bridge.class,updates,dbSchema)
      * </code>
      *
      * @param klazz Class for row type to be extracted
      * @param updates TableUpdates from which to extract rowUpdates
      * @param dbSchema Dbschema for the TableUpdates
-     * @return Map<UUID,T> for the type of things being sought
+     * @return Map&lt;UUID,T&gt; for the type of things being sought
      */
     public static <T> Map<UUID,T> extractRowsRemoved(Class<T> klazz,TableUpdates updates,DatabaseSchema dbSchema) {
         Preconditions.checkNotNull(klazz);
@@ -520,18 +520,18 @@ public class TyperUtils {
     }
 
     /**
-     * This method extracts all RowUpdates of Class<T> klazz from a TableUpdates
+     * This method extracts all RowUpdates of Class&lt;T&gt; klazz from a TableUpdates
      * that correspond to rows of type klazz.
      * Example:
      * <code>
-     * Map<UUID,TableUpdate<GenericTableSchema>.RowUpdate<GenericTableSchema>> updatedBridges =
+     * Map&lt;UUID,TableUpdate&lt;GenericTableSchema&gt;.RowUpdate&lt;GenericTableSchema&gt;&gt; updatedBridges =
      *     extractRowsUpdates(Bridge.class,updates,dbSchema)
      * </code>
      *
      * @param klazz Class for row type to be extracted
      * @param updates TableUpdates from which to extract rowUpdates
      * @param dbSchema Dbschema for the TableUpdates
-     * @return Map<UUID,TableUpdate<GenericTableSchema>.RowUpdate<GenericTableSchema>>
+     * @return Map&lt;UUID,TableUpdate&lt;GenericTableSchema&gt;.RowUpdate&lt;GenericTableSchema&gt;&gt;
      *     for the type of things being sought
      */
     public static Map<UUID,TableUpdate<GenericTableSchema>.RowUpdate<GenericTableSchema>>
index a5c83f28e83f8abb6dfa74f8b43758c03f50ded6..3e3b6674dd7eee17edfe71045950f6fd1d039d15 100644 (file)
@@ -107,7 +107,7 @@ public class OvsdbNorthboundV2 {
      * @param nodeType type of node e.g OVS
      * @param nodeId ID of the node
      * @param tableName name of the OVSDB table
-     * @param row the {@link OvsdbRow} Row that is being inserted
+     * @param rowJson the {@link OvsdbRow} Row that is being inserted
      *
      * @return Response as dictated by the HTTP Response Status code
      *
index 2283bc7b22659a12a24cda7934e63ef6d5576010..6e95c6911e67fc1f2de3085d589ad76d6b6cb1f6 100644 (file)
@@ -68,7 +68,7 @@ public abstract class AbstractHandler {
     /**
      * Enqueue the event.
      *
-     * @param event the {@link org.opendaylight.ovsdb.openstack.netvirt.AbstractEvent} event to be handled.
+     * @param abstractEvent the {@link org.opendaylight.ovsdb.openstack.netvirt.AbstractEvent} event to be handled.
      * @see org.opendaylight.ovsdb.openstack.netvirt.api.EventDispatcher
      */
     protected void enqueueEvent(AbstractEvent abstractEvent) {
@@ -79,7 +79,7 @@ public abstract class AbstractHandler {
     /**
      * Process the event.
      *
-     * @param event the {@link org.opendaylight.ovsdb.openstack.netvirt.AbstractEvent} event to be handled.
+     * @param abstractEvent the {@link org.opendaylight.ovsdb.openstack.netvirt.AbstractEvent} event to be handled.
      * @see org.opendaylight.ovsdb.openstack.netvirt.api.EventDispatcher
      */
     public abstract void processEvent(AbstractEvent abstractEvent);
index 55fc3a67f008fa688182fdce2742c8ac9d6cdc5d..d9bd0c08b5f5837d1b5f1026407c728d02916993 100644 (file)
@@ -119,7 +119,7 @@ public class FloatingIPHandler extends AbstractHandler
      * Process the event.
      *
      * @param abstractEvent the {@link org.opendaylight.ovsdb.openstack.netvirt.AbstractEvent} event to be handled.
-     * @see EventDispatcher
+     * @see org.opendaylight.ovsdb.openstack.netvirt.api.EventDispatcher
      */
     @Override
     public void processEvent(AbstractEvent abstractEvent) {
index 6615d8d0954dcfc83660f964c9d34ccd23b3134e..05b58aaebbc5c71863f9cd8ad910deb130d7b4d1 100755 (executable)
@@ -58,7 +58,7 @@ public class NeutronCacheUtils {
     /**
      * Look up in the NeutronNetworkCRUD cache and NeutronSubnetCRUD cache for
      * extracting the provider segmentation_type and segmentation_id
-     * @param subnetId Subnet UUID
+     * @param subnetID Subnet UUID
      * @return {Type: ID} pair for that subnet ID
      */
     public static Map.Entry<String,String> getProviderInformation(INeutronNetworkCRUD neutronNetworkCache,
index 78d9928fb36a7362e7f4951e46dfdcdc26d1532c..68916b9946269174ca092b3716f0313c56e2ab42 100644 (file)
@@ -62,7 +62,7 @@ public class PortHandler extends AbstractHandler
     /**
      * Invoked to take action after a port has been created.
      *
-     * @param port An instance of new Neutron Port object.
+     * @param neutronPort An instance of new Neutron Port object.
      */
     @Override
     public void neutronPortCreated(NeutronPort neutronPort) {
@@ -95,7 +95,7 @@ public class PortHandler extends AbstractHandler
     /**
      * Invoked to take action after a port has been updated.
      *
-     * @param port An instance of modified Neutron Port object.
+     * @param neutronPort An instance of modified Neutron Port object.
      */
     @Override
     public void neutronPortUpdated(NeutronPort neutronPort) {
@@ -184,7 +184,7 @@ public class PortHandler extends AbstractHandler
      * Process the event.
      *
      * @param abstractEvent the {@link org.opendaylight.ovsdb.openstack.netvirt.AbstractEvent} event to be handled.
-     * @see EventDispatcher
+     * @see org.opendaylight.ovsdb.openstack.netvirt.api.EventDispatcher
      */
     @Override
     public void processEvent(AbstractEvent abstractEvent) {
index 5b6d3be8b444af4c304430fb1dd01c2f4ba5f838..05b4525a874cb8e019bd94e683317cc664b99756 100644 (file)
@@ -329,7 +329,7 @@ public class SouthboundHandler extends AbstractHandler
      * Process the event.
      *
      * @param abstractEvent the {@link org.opendaylight.ovsdb.openstack.netvirt.AbstractEvent} event to be handled.
-     * @see EventDispatcher
+     * @see org.opendaylight.ovsdb.openstack.netvirt.api.EventDispatcher
      */
     @Override
     public void processEvent(AbstractEvent abstractEvent) {
index 73f8d6a345b20c2b7a4d195558d4a67ff1324179..2051f340440c65f7820570aa66bf08552713fd55 100644 (file)
@@ -20,7 +20,7 @@ import java.util.List;
  * OpenStack Neutron with the Open vSwitch plugin relies on a typical bridge configuration that
  * consists of br-int (Integration Bridge), br-net (Network bridge), br-ex (External bridge).
  *
- * This class ensures that the bridges on each {@link org.opendaylight.controller.sal.core.Node}
+ * This class ensures that the bridges on each {@link Node}
  * are correctly configured for OpenStack Neutron
  *
  */
@@ -28,7 +28,7 @@ public interface BridgeConfigurationManager {
 
     /**
      * A helper function to get the UUID of a given Bridge
-     * @param node the {@link org.opendaylight.controller.sal.core.Node} where the bridge is configured
+     * @param node the {@link Node} where the bridge is configured
      * @param bridgeName the name of the bridge
      * @return the UUID of the bridge
      */
@@ -36,21 +36,21 @@ public interface BridgeConfigurationManager {
 
     /**
      * Checks for the existence of the Integration Bridge on a given Node
-     * @param node the {@link org.opendaylight.controller.sal.core.Node} where the bridge should be configured
+     * @param node the {@link Node} where the bridge should be configured
      * @return True if the bridge exists, False if it does not
      */
     public boolean isNodeNeutronReady(Node node);
 
     /**
      * Checks for the existence of the Network Bridge on a given Node
-     * @param node the {@link org.opendaylight.controller.sal.core.Node} where the bridge should be configured
+     * @param node the {@link Node} where the bridge should be configured
      * @return True if the bridge exists, False if it does not
      */
     public boolean isNodeOverlayReady(Node node);
 
     /**
      * Checks for the existence of the Network Bridge on a given Node
-     * @param node the {@link org.opendaylight.controller.sal.core.Node} where the bridge should be configured
+     * @param node the {@link Node} where the bridge should be configured
      * @return True if the bridge exists, False if it does not
      */
 
@@ -58,7 +58,7 @@ public interface BridgeConfigurationManager {
      * Checks that a Node is ready for a Tunnel Network Provider
      * For OpenFlow 1.0 the Integration, Network Bridge and corresponding patch ports are required
      * For OpenFlow 1.3 only the Integration Bridge is required
-     * @param node the {@link org.opendaylight.controller.sal.core.Node} where the bridge is configured
+     * @param node the {@link Node} where the bridge is configured
      * @return True or False
      */
     public boolean isNodeTunnelReady(Node node);
@@ -74,7 +74,7 @@ public interface BridgeConfigurationManager {
      * For OpenFlow 1.0 the Integration Bridge, Network Bridge, patch ports and a physical device connected to the
      * Network Bridge are required.
      * For OpenFlow 1.3 the Integration Bridge is required and must have a physical device connected.
-     * @param node the {@link org.opendaylight.controller.sal.core.Node} where the bridge is configured
+     * @param node the {@link Node} where the bridge is configured
      * @param network the {@link org.opendaylight.neutron.spi.NeutronNetwork}
      * @return True or False
      */
@@ -82,7 +82,7 @@ public interface BridgeConfigurationManager {
 
     /**
      * A helper function to determine if a port exists on a given bridge
-     * @param node the {@link org.opendaylight.controller.sal.core.Node} where the bridge is configured
+     * @param node the {@link Node} where the bridge is configured
      * @param bridge the {@link org.opendaylight.ovsdb.schema.openvswitch.Bridge} to query
      * @param portName the name of the port to search for
      * @return True if the port exists, otherwise False
@@ -93,7 +93,7 @@ public interface BridgeConfigurationManager {
     /**
      * Returns true if the bridges required for the provider network type are created
      * If the bridges are not created, this method will attempt to create them
-     * @param node the {@link org.opendaylight.controller.sal.core.Node} to query
+     * @param node the {@link Node} to query
      * @param network the {@link org.opendaylight.neutron.spi.NeutronNetwork}
      * @return True or False
      */
@@ -101,7 +101,7 @@ public interface BridgeConfigurationManager {
 
     /**
      * Prepares the given Node for Neutron Networking by creating the Integration Bridge
-     * @param node the {@link org.opendaylight.controller.sal.core.Node} to prepare
+     * @param node the {@link Node} to prepare
      */
     public void prepareNode(Node node);
 
@@ -115,8 +115,8 @@ public interface BridgeConfigurationManager {
 
     /** Returns all physical interfaces configured in the bridge mapping
      * Bridge mappings will be of the following format:
-     * @param node the {@link org.opendaylight.controller.sal.core.Node} to query
+     * @param node the {@link Node} to query
      * @return a List in the format {eth1, eth2} given bridge_mappings=physnet1:eth1,physnet2:eth2
      */
     public List<String> getAllPhysicalInterfaceNames(Node node);
-}
\ No newline at end of file
+}
index 8dd66e3700c9bdbf2661001189b8402c3d80653a..f1edd8c7aed95ea444c82bf1ac7b40ebe6873fc1 100644 (file)
@@ -104,7 +104,7 @@ public interface ConfigurationService {
 
     /**
      * Gets the tunnel endpoint address for a given Node
-     * @param node a {@link org.opendaylight.controller.sal.core.Node}
+     * @param node a {@link Node}
      * @return the tunnel endpoint
      * @see java.net.InetAddress
      */
@@ -125,4 +125,4 @@ public interface ConfigurationService {
      * @return the MacAddress to use for the default gateway; or null if none is configured.
      */
     public String getDefaultGatewayMacAddress(Node node);
-}
\ No newline at end of file
+}
index 19be7ab2e0bb82eb7895c6151f11bc2a000ecd3f..804986cc3d015ddb3fe67a4b5149275eec6a6b3d 100644 (file)
@@ -13,13 +13,13 @@ package org.opendaylight.ovsdb.openstack.netvirt.api;
 import org.opendaylight.yang.gen.v1.urn.opendaylight.inventory.rev130819.nodes.Node;
 
 /**
- * The NetworkingProviderManager handles the mapping between {@link org.opendaylight.controller.sal.core.Node}
+ * The NetworkingProviderManager handles the mapping between {@link Node}
  * and registered {@link org.opendaylight.ovsdb.openstack.netvirt.api.NetworkingProvider} implementations
  */
 public interface NetworkingProviderManager {
     /**
      * Returns the Networking Provider for a given node
-     * @param node a {@link org.opendaylight.controller.sal.core.Node}
+     * @param node a {@link Node}
      * @return a NetworkProvider
      * @see NetworkingProvider
      */
index 5eaf9cc338a15a4c01d44e1cf45c2e45b5cf19f5..0eca6f5c2a5165c40bf4d42b37671158ab15ad83 100644 (file)
@@ -22,7 +22,7 @@ public interface TenantNetworkManager {
 
     /**
      * Get the VLAN assigned to the provided Network
-     * @param node the {@link org.opendaylight.controller.sal.core.Node} to query
+     * @param node the {@link Node} to query
      * @param networkId the Neutron Network ID
      * @return the assigned VLAN ID or 0 in case of an error
      */
@@ -30,7 +30,7 @@ public interface TenantNetworkManager {
 
     /**
      * Reclaim the assigned VLAN for the given Network
-     * @param node the {@link org.opendaylight.controller.sal.core.Node} to query
+     * @param node the {@link Node} to query
      * @param portUUID the UUID of the neutron Port
      * @param network the Neutron Network ID
      */
@@ -38,7 +38,7 @@ public interface TenantNetworkManager {
 
     /**
      * Configures the VLAN for a Tenant Network
-     * @param node the {@link org.opendaylight.controller.sal.core.Node} to configure
+     * @param node the {@link Node} to configure
      * @param portUUID the UUID of the port to configure
      * @param network the Neutron Network ID
      */
@@ -46,7 +46,7 @@ public interface TenantNetworkManager {
 
     /**
      * Check is the given network is present on a Node
-     * @param node the {@link org.opendaylight.controller.sal.core.Node} to query
+     * @param node the {@link Node} to query
      * @param segmentationId the Neutron Segementation ID
      * @return True or False
      */
@@ -71,4 +71,4 @@ public interface TenantNetworkManager {
      * Network Deleted Callback
      */
     public void networkDeleted(String id);
-}
\ No newline at end of file
+}
index 83497bf4de8e2e27eb29fe1ebcf6aa5fc2002d9a..dc109124fb59dfd48e190f3fa10bd34b15f89ad4 100644 (file)
@@ -20,7 +20,7 @@ public interface VlanConfigurationCache {
 
     /**
      * Assigns a free VLAN ID for the given tenant network
-     * @param node an Open vSwitch {@link org.opendaylight.controller.sal.core.Node}
+     * @param node an Open vSwitch {@link Node}
      * @param networkId the Neutron Network ID
      * @return a VLAN ID or 0 in case of an error
      */
@@ -28,7 +28,7 @@ public interface VlanConfigurationCache {
 
     /**
      * Recovers an assigned VLAN ID when it is no longer required
-     * @param node an Open vSwitch {@link org.opendaylight.controller.sal.core.Node}
+     * @param node an Open vSwitch {@link Node}
      * @param networkId the Neutron Network ID
      * @return the reclaimed VLAN ID or 0 in case of an error
      */
@@ -36,7 +36,7 @@ public interface VlanConfigurationCache {
 
     /**
      * Returns a VLAN ID assigned to a given tenant network
-     * @param node an Open vSwitch {@link org.opendaylight.controller.sal.core.Node}
+     * @param node an Open vSwitch {@link Node}
      * @param networkId the Neutron Network ID
      * @return the VLAN ID or 0 in case of an error
      */
index e702bc8162c8259a7144c8eefbf13c6b8190f0f8..81573803940af626f8f282bd07a267685d72a016 100644 (file)
@@ -24,12 +24,12 @@ import org.opendaylight.ovsdb.lib.schema.typed.TypedBaseTable;
 public interface OvsdbConfigurationService {
 
     /**
-     * @deprecated This version of insertRow is a short-term replacement for the older & now deprecated method of the same name.
+     * @deprecated This version of insertRow is a short-term replacement for the older and now deprecated method of the same name.
      * This API assumes an Open_vSwitch database Schema.
      *
      * This API is replaced by
-     * {@link #insertRow(Node, String, String, String, Row<GenericTableSchema>) insertRow} and
-     * {@link #insertTree(Node, String, String, String, Row<GenericTableSchema>) insertTree}
+     * {@link #insertRow(Node, String, String, UUID, Row) insertRow} and
+     * {@link #insertTree(Node, String, String, UUID, Row) insertTree}
      *
      * @param node OVSDB Node
      * @param tableName Table on which the row is inserted
@@ -42,18 +42,18 @@ public interface OvsdbConfigurationService {
 
     /**
      * insert a Row in a Table of a specified Database Schema. This is a convenience method on top of
-     * {@link insertRow(Node, String, String, String, UUID, String, Row<GenericTableSchema>) insertRow}
+     * {@link #insertRow(Node, String, String, String, UUID, String, Row) insertRow}
      * which assumes that OVSDB schema implementation that corresponds to the databaseName will provide
      * the necessary service to populate the Parent Table Name and Parent Column Name.
      *
      * This method can insert just a single Row specified in the row parameter.
-     * But {@link #insertTree(Node, String, String, UUID, Row<GenericTableSchema>) insertTree}
+     * But {@link #insertTree(Node, String, String, UUID, Row) insertTree}
      * can insert a hierarchy of rows with parent-child relationship.
      *
      * @param node OVSDB Node
      * @param databaseName Database Name that represents the Schema supported by the node.
      * @param tableName Table on which the row is inserted
-     * @param parentUuid UUID of the parent table to which this operation will result in attaching/mutating.
+     * @param parentRowUuid UUID of the parent table to which this operation will result in attaching/mutating.
      * @param row Row of table Content to be inserted
      * @throws OvsdbPluginException Any failure during the insert transaction will result in a specific exception.
      * @return UUID of the inserted Row
@@ -65,14 +65,14 @@ public interface OvsdbConfigurationService {
      * insert a Row in a Table of a specified Database Schema.
      *
      * This method can insert just a single Row specified in the row parameter.
-     * But {@link #insertTree(Node, String, String, UUID, Row<GenericTableSchema>) insertTree}
+     * But {@link #insertTree(Node, String, String, UUID, Row) insertTree}
      * can insert a hierarchy of rows with parent-child relationship.
      *
      * @param node OVSDB Node
      * @param databaseName Database Name that represents the Schema supported by the node.
      * @param tableName Table on which the row is inserted
      * @param parentTable Name of the Parent Table to which this operation will result in attaching/mutating.
-     * @param parentUuid UUID of a Row in parent table to which this operation will result in attaching/mutating.
+     * @param parentRowUuid UUID of a Row in parent table to which this operation will result in attaching/mutating.
      * @param parentColumn Name of the Column in the Parent Table to be mutated with the UUID that results from the insert operation.
      * @param row Row of table Content to be inserted
      * @throws OvsdbPluginException Any failure during the insert transaction will result in a specific exception.
@@ -83,12 +83,12 @@ public interface OvsdbConfigurationService {
 
     /**
      * inserts a Tree of Rows in multiple Tables that has parent-child relationships referenced through the OVSDB schema's refTable construct.
-     * This is a convenience method on top of {@link #insertTree(Node, String, String, String, UUID, String, Row<GenericTableSchema>) insertTree}
+     * This is a convenience method on top of {@link #insertTree(Node, String, String, String, UUID, String, Row) insertTree}
      *
      * @param node OVSDB Node
      * @param databaseName Database Name that represents the Schema supported by the node.
      * @param tableName Table on which the row is inserted
-     * @param parentUuid UUID of a Row in parent table to which this operation will result in attaching/mutating.
+     * @param parentRowUuid UUID of a Row in parent table to which this operation will result in attaching/mutating.
      * @param row Row Tree with parent-child relationships via column of type refTable.
      * @throws OvsdbPluginException Any failure during the insert transaction will result in a specific exception.
      * @return Returns the row tree with the UUID of every inserted Row populated in the _uuid column of every row in the tree
@@ -103,7 +103,7 @@ public interface OvsdbConfigurationService {
      * @param databaseName Database Name that represents the Schema supported by the node.
      * @param tableName Table on which the row is inserted
      * @param parentTable Name of the Parent Table to which this operation will result in attaching/mutating.
-     * @param parentUuid UUID of a Row in parent table to which this operation will result in attaching/mutating.
+     * @param parentRowUuid UUID of a Row in parent table to which this operation will result in attaching/mutating.
      * @param parentColumn Name of the Column in the Parent Table to be mutated with the UUID that results from the insert operation.
      * @param row Row Tree with parent-child relationships via column of type refTable.
      * @throws OvsdbPluginException Any failure during the insert transaction will result in a specific exception.
@@ -113,11 +113,11 @@ public interface OvsdbConfigurationService {
                                               String parentColumn, Row<GenericTableSchema> row) throws OvsdbPluginException;
 
     /**
-     * @deprecated This version of updateRow is a short-term replacement for the older & now deprecated method of the same name.
+     * @deprecated This version of updateRow is a short-term replacement for the older and now deprecated method of the same name.
      * This API assumes an Open_vSwitch database Schema.
      *
      * This API is replaced by
-     * {@link #updateRow(Node, String, String, UUID, Row<GenericTableSchema>, boolean) updateRow}
+     * {@link #updateRow(Node, String, String, UUID, Row, boolean) updateRow}
      *
      * @param node OVSDB Node
      * @param tableName Table on which the row is Updated
@@ -145,7 +145,7 @@ public interface OvsdbConfigurationService {
                             Row<GenericTableSchema> row, boolean overwrite) throws OvsdbPluginException;
 
     /**
-     * @deprecated This version of deleteRow is a short-term replacement for the older & now deprecated method of the same name.
+     * @deprecated This version of deleteRow is a short-term replacement for the older and now deprecated method of the same name.
      * This API assumes an Open_vSwitch database Schema.
      *
      * This API is replaced by {@link #deleteRow(Node, String, String, UUID) deleteRow}
@@ -185,14 +185,14 @@ public interface OvsdbConfigurationService {
                            UUID parentRowUuid, String parentColumn, UUID rowUuid) throws OvsdbPluginException;
 
     /**
-     * @deprecated This version of getRow is a short-term replacement for the older & now deprecated method of the same name.
+     * @deprecated This version of getRow is a short-term replacement for the older and now deprecated method of the same name.
      * This API assumes an Open_vSwitch database Schema.
      *
      * This API is replaced by {@link #getRow(Node, String, String, UUID) getRow}
      *
      * @param node OVSDB Node
      * @param tableName Table Name
-     * @param rowUuid UUID of the row being queried
+     * @param uuid UUID of the row being queried
      * @return a row with a list of Column data that corresponds to an unique Row-identifier called uuid in a given table.
      */
     @Deprecated
@@ -211,7 +211,7 @@ public interface OvsdbConfigurationService {
     public Row<GenericTableSchema> getRow(Node node, String databaseName, String tableName, UUID uuid) throws OvsdbPluginException;
 
     /**
-     * @Deprecated This version of getRows is a short-term replacement for the older & now deprecated method of the same name.
+     * @deprecated This version of getRows is a short-term replacement for the older and now deprecated method of the same name.
      * This API assumes an Open_vSwitch database Schema.
      *
      * This API is replaced by
@@ -241,14 +241,14 @@ public interface OvsdbConfigurationService {
      * @param node OVSDB Node
      * @param databaseName Database Name that represents the Schema supported by the node.
      * @param tableName Table Name
-     * @param fiqlQuery FIQL style String Query {@link http://tools.ietf.org/html/draft-nottingham-atompub-fiql-00} to filter rows
+     * @param fiqlQuery FIQL style String Query <a href="http://tools.ietf.org/html/draft-nottingham-atompub-fiql-00">draft-nottingham-atompub-fiql</a> to filter rows
      * @throws OvsdbPluginException Any failure during the get operation will result in a specific exception.
      * @return Map of rows to its UUID that makes the entire Table.
      */
     public ConcurrentMap<UUID, Row<GenericTableSchema>> getRows(Node node, String databaseName, String tableName, String fiqlQuery) throws OvsdbPluginException;
 
     /**
-     * @Deprecated Returns all the Tables in a given Ndoe.
+     * @deprecated Returns all the Tables in a given Ndoe.
      * This API assumes an Open_vSwitch database Schema.
      *
      * This API is replaced by
index ff63d5cd111af585e51c7216eded6e305eb89277..a34e4bb5293606107e92f3bb4fea2418345a88db 100644 (file)
@@ -23,12 +23,12 @@ import org.opendaylight.yang.gen.v1.urn.opendaylight.inventory.rev130819.nodes.N
 public interface OvsdbConfigurationService {
 
     /**
-     * @deprecated This version of insertRow is a short-term replacement for the older & now deprecated method of the same name.
+     * @deprecated This version of insertRow is a short-term replacement for the older and now deprecated method of the same name.
      * This API assumes an Open_vSwitch database Schema.
      *
      * This API is replaced by
-     * {@link #insertRow(Node, String, String, String, Row<GenericTableSchema>) insertRow} and
-     * {@link #insertTree(Node, String, String, String, Row<GenericTableSchema>) insertTree}
+     * {@link #insertRow(Node, String, String, Row)} and
+     * {@link #insertTree(Node, String, String, UUID, Row)}
      *
      * @param node OVSDB Node
      * @param tableName Table on which the row is inserted
@@ -41,18 +41,18 @@ public interface OvsdbConfigurationService {
 
     /**
      * insert a Row in a Table of a specified Database Schema. This is a convenience method on top of
-     * {@link insertRow(Node, String, String, String, UUID, String, Row<GenericTableSchema>) insertRow}
+     * {@link insertRow(Node, String, String, String, UUID, String, Row) insertRow}
      * which assumes that OVSDB schema implementation that corresponds to the databaseName will provide
      * the necessary service to populate the Parent Table Name and Parent Column Name.
      *
      * This method can insert just a single Row specified in the row parameter.
-     * But {@link #insertTree(Node, String, String, UUID, Row<GenericTableSchema>) insertTree}
+     * But {@link #insertTree(Node, String, String, UUID, Row) insertTree}
      * can insert a hierarchy of rows with parent-child relationship.
      *
      * @param node OVSDB Node
      * @param databaseName Database Name that represents the Schema supported by the node.
      * @param tableName Table on which the row is inserted
-     * @param parentUuid UUID of the parent table to which this operation will result in attaching/mutating.
+     * @param parentRowUuid UUID of the parent table to which this operation will result in attaching/mutating.
      * @param row Row of table Content to be inserted
      * @throws OvsdbPluginException Any failure during the insert transaction will result in a specific exception.
      * @return UUID of the inserted Row
@@ -64,14 +64,14 @@ public interface OvsdbConfigurationService {
      * insert a Row in a Table of a specified Database Schema.
      *
      * This method can insert just a single Row specified in the row parameter.
-     * But {@link #insertTree(Node, String, String, UUID, Row<GenericTableSchema>) insertTree}
+     * But {@link #insertTree(Node, String, String, UUID, Row)}
      * can insert a hierarchy of rows with parent-child relationship.
      *
      * @param node OVSDB Node
      * @param databaseName Database Name that represents the Schema supported by the node.
      * @param tableName Table on which the row is inserted
      * @param parentTable Name of the Parent Table to which this operation will result in attaching/mutating.
-     * @param parentUuid UUID of a Row in parent table to which this operation will result in attaching/mutating.
+     * @param parentRowUuid UUID of a Row in parent table to which this operation will result in attaching/mutating.
      * @param parentColumn Name of the Column in the Parent Table to be mutated with the UUID that results from the insert operation.
      * @param row Row of table Content to be inserted
      * @throws OvsdbPluginException Any failure during the insert transaction will result in a specific exception.
@@ -82,12 +82,12 @@ public interface OvsdbConfigurationService {
 
     /**
      * inserts a Tree of Rows in multiple Tables that has parent-child relationships referenced through the OVSDB schema's refTable construct.
-     * This is a convenience method on top of {@link #insertTree(Node, String, String, String, UUID, String, Row<GenericTableSchema>) insertTree}
+     * This is a convenience method on top of {@link #insertTree(Node, String, String, String, UUID, String, Row)}
      *
      * @param node OVSDB Node
      * @param databaseName Database Name that represents the Schema supported by the node.
      * @param tableName Table on which the row is inserted
-     * @param parentUuid UUID of a Row in parent table to which this operation will result in attaching/mutating.
+     * @param parentRowUuid UUID of a Row in parent table to which this operation will result in attaching/mutating.
      * @param row Row Tree with parent-child relationships via column of type refTable.
      * @throws OvsdbPluginException Any failure during the insert transaction will result in a specific exception.
      * @return Returns the row tree with the UUID of every inserted Row populated in the _uuid column of every row in the tree
@@ -102,7 +102,7 @@ public interface OvsdbConfigurationService {
      * @param databaseName Database Name that represents the Schema supported by the node.
      * @param tableName Table on which the row is inserted
      * @param parentTable Name of the Parent Table to which this operation will result in attaching/mutating.
-     * @param parentUuid UUID of a Row in parent table to which this operation will result in attaching/mutating.
+     * @param parentRowUuid UUID of a Row in parent table to which this operation will result in attaching/mutating.
      * @param parentColumn Name of the Column in the Parent Table to be mutated with the UUID that results from the insert operation.
      * @param row Row Tree with parent-child relationships via column of type refTable.
      * @throws OvsdbPluginException Any failure during the insert transaction will result in a specific exception.
@@ -112,15 +112,15 @@ public interface OvsdbConfigurationService {
                                               String parentColumn, Row<GenericTableSchema> row) throws OvsdbPluginException;
 
     /**
-     * @deprecated This version of updateRow is a short-term replacement for the older & now deprecated method of the same name.
+     * @deprecated This version of updateRow is a short-term replacement for the older and now deprecated method of the same name.
      * This API assumes an Open_vSwitch database Schema.
      *
      * This API is replaced by
-     * {@link #updateRow(Node, String, String, UUID, Row<GenericTableSchema>, boolean) updateRow}
+     * {@link #updateRow(Node, String, String, UUID, Row, boolean) updateRow}
      *
      * @param node OVSDB Node
      * @param tableName Table on which the row is Updated
-     * @param parentUuid UUID of the parent row on which this operation might result in mutating.
+     * @param rowUuid UUID of the parent row on which this operation might result in mutating.
      * @param rowUuid UUID of the row that is being updated
      * @param row Row of table Content to be Updated. Include just those columns that needs to be updated.
      */
@@ -144,10 +144,10 @@ public interface OvsdbConfigurationService {
                             Row<GenericTableSchema> row, boolean overwrite) throws OvsdbPluginException;
 
     /**
-     * @deprecated This version of deleteRow is a short-term replacement for the older & now deprecated method of the same name.
+     * @deprecated This version of deleteRow is a short-term replacement for the older and now deprecated method of the same name.
      * This API assumes an Open_vSwitch database Schema.
      *
-     * This API is replaced by {@link #deleteRow(Node, String, String, UUID) deleteRow}
+     * This API is replaced by {@link #deleteRow(Node, String, String, UUID)}
      *
      * @param node OVSDB Node
      * @param tableName Table on which the row is Updated
@@ -184,14 +184,14 @@ public interface OvsdbConfigurationService {
                            UUID parentRowUuid, String parentColumn, UUID rowUuid) throws OvsdbPluginException;
 
     /**
-     * @deprecated This version of getRow is a short-term replacement for the older & now deprecated method of the same name.
+     * @deprecated This version of getRow is a short-term replacement for the older and now deprecated method of the same name.
      * This API assumes an Open_vSwitch database Schema.
      *
      * This API is replaced by {@link #getRow(Node, String, String, UUID) getRow}
      *
      * @param node OVSDB Node
      * @param tableName Table Name
-     * @param rowUuid UUID of the row being queried
+     * @param uuid UUID of the row being queried
      * @return a row with a list of Column data that corresponds to an unique Row-identifier called uuid in a given table.
      */
     @Deprecated
@@ -210,7 +210,7 @@ public interface OvsdbConfigurationService {
     public Row<GenericTableSchema> getRow(Node node, String databaseName, String tableName, UUID uuid) throws OvsdbPluginException;
 
     /**
-     * @Deprecated This version of getRows is a short-term replacement for the older & now deprecated method of the same name.
+     * @deprecated This version of getRows is a short-term replacement for the older and now deprecated method of the same name.
      * This API assumes an Open_vSwitch database Schema.
      *
      * This API is replaced by
@@ -240,14 +240,14 @@ public interface OvsdbConfigurationService {
      * @param node OVSDB Node
      * @param databaseName Database Name that represents the Schema supported by the node.
      * @param tableName Table Name
-     * @param fiqlQuery FIQL style String Query {@link http://tools.ietf.org/html/draft-nottingham-atompub-fiql-00} to filter rows
+     * @param fiqlQuery FIQL style String Query <a href="http://tools.ietf.org/html/draft-nottingham-atompub-fiql-00">draft-nottingham-atompub-fiql</a> to filter rows
      * @throws OvsdbPluginException Any failure during the get operation will result in a specific exception.
      * @return Map of rows to its UUID that makes the entire Table.
      */
     public ConcurrentMap<UUID, Row<GenericTableSchema>> getRows(Node node, String databaseName, String tableName, String fiqlQuery) throws OvsdbPluginException;
 
     /**
-     * @Deprecated Returns all the Tables in a given Ndoe.
+     * @deprecated Returns all the Tables in a given Ndoe.
      * This API assumes an Open_vSwitch database Schema.
      *
      * This API is replaced by
index 9bb2ab250ec8ce7eef4c3315e544fe7814cc85f7..b45da2e778747fb384a4471d75be30310f16d6cf 100644 (file)
@@ -582,7 +582,7 @@ public class ConfigurationServiceImpl implements OvsdbConfigurationService
      * insert a Row in a Table of a specified Database Schema.
      *
      * This method can insert just a single Row specified in the row parameter.
-     * But {@link #insertTree(Node, String, String, UUID, Row<GenericTableSchema>) insertTree}
+     * But {@link #insertTree(Node, String, String, UUID, Row) insertTree}
      * can insert a hierarchy of rows with parent-child relationship.
      *
      * @param node OVSDB Node
@@ -612,18 +612,18 @@ public class ConfigurationServiceImpl implements OvsdbConfigurationService
 
     /**
      * insert a Row in a Table of a specified Database Schema. This is a convenience method on top of
-     * {@link insertRow(Node, String, String, String, UUID, String, Row<GenericTableSchema>) insertRow}
+     * {@link insertRow(Node, String, String, String, UUID, String, Row) insertRow}
      * which assumes that OVSDB schema implementation that corresponds to the databaseName will provide
      * the necessary service to populate the Parent Table Name and Parent Column Name.
      *
      * This method can insert just a single Row specified in the row parameter.
-     * But {@link #insertTree(Node, String, String, UUID, Row<GenericTableSchema>) insertTree}
+     * But {@link #insertTree(Node, String, String, UUID, Row) insertTree}
      * can insert a hierarchy of rows with parent-child relationship.
      *
      * @param node OVSDB Node
      * @param databaseName Database Name that represents the Schema supported by the node.
      * @param tableName Table on which the row is inserted
-     * @param parentUuid UUID of the parent table to which this operation will result in attaching/mutating.
+     * @param parentRowUuid UUID of the parent table to which this operation will result in attaching/mutating.
      * @param row Row of table Content to be inserted
      * @throws OvsdbPluginException Any failure during the insert transaction will result in a specific exception.
      * @return UUID of the inserted Row
@@ -711,12 +711,12 @@ public class ConfigurationServiceImpl implements OvsdbConfigurationService
 
     /**
      * inserts a Tree of Rows in multiple Tables that has parent-child relationships referenced through the OVSDB schema's refTable construct.
-     * This is a convenience method on top of {@link #insertTree(Node, String, String, String, UUID, String, Row<GenericTableSchema>) insertTree}
+     * This is a convenience method on top of {@link #insertTree(Node, String, String, String, UUID, String, Row) insertTree}
      *
      * @param node OVSDB Node
      * @param databaseName Database Name that represents the Schema supported by the node.
      * @param tableName Table on which the row is inserted
-     * @param parentUuid UUID of a Row in parent table to which this operation will result in attaching/mutating.
+     * @param parentRowUuid UUID of a Row in parent table to which this operation will result in attaching/mutating.
      * @param row Row Tree with parent-child relationships via column of type refTable.
      * @throws OvsdbPluginException Any failure during the insert transaction will result in a specific exception.
      * @return Returns the row tree with the UUID of every inserted Row populated in the _uuid column of every row in the tree
index 88aeb4c132e01d96bee09e965e97359af387bf6e..6aa9cd1f52d892297cedd158ab1557fde8a230ff 100644 (file)
@@ -290,7 +290,7 @@ public class ConnectionServiceImpl implements OvsdbConnectionService,
      * As per RFC 7047, section 4.1.5, if a Monitor request is sent without any columns, the update response will not include
      * the _uuid column.
      * ----------------------------------------------------------------------------------------------------------------------------------
-     * Each <monitor-request> specifies one or more columns and the manner in which the columns (or the entire table) are to be monitored.
+     * Each &lt;monitor-request&gt; specifies one or more columns and the manner in which the columns (or the entire table) are to be monitored.
      * The "columns" member specifies the columns whose values are monitored. It MUST NOT contain duplicates.
      * If "columns" is omitted, all columns in the table, except for "_uuid", are monitored.
      * ----------------------------------------------------------------------------------------------------------------------------------
index da480aa255f72158088f84b6c47182e6c2b1060a..b80bee0331ffa6f067fa0f8e38ba178b3b58c9ee 100644 (file)
@@ -306,7 +306,7 @@ public class InstructionUtils {
     }
 
     /**
-     * Create Set Vlan ID Instruction - This includes push vlan action, and set field -> vlan vid action
+     * Create Set Vlan ID Instruction - This includes push vlan action, and set field -&gt; vlan vid action
      *
      * @param ib     Map InstructionBuilder without any instructions
      * @param vlanId Integer representing a VLAN ID Integer representing a VLAN ID
index 89f6ca3a11d7bdc205f9fb2e1629ec297effdc71..47c26e395e93fd645438efd6f9c361facdaa8968 100644 (file)
@@ -279,7 +279,7 @@ public class MatchUtils {
     /**
      * Create Source TCP Port Match
      *
-     * @param matchBuilder @param matchbuilder MatchBuilder Object without a match yet
+     * @param matchBuilder MatchBuilder Object without a match yet
      * @param tcpport      Integer representing a source TCP port
      * @return matchBuilder Map MatchBuilder Object with a match
      */
@@ -336,7 +336,7 @@ public class MatchUtils {
      * @param tcpPort  PortNumber representing a destination TCP port
      * @param tcpFlag  int representing a tcp_flag
      * @return match containing TCP_Flag (), IP Protocol (TCP), TCP_Flag (SYN)
-     * <p/>
+     * <p>
      * Defined TCP Flag values in OVS v2.1+
      * TCP_FIN 0x001 / TCP_SYN 0x002 / TCP_RST 0x004
      * TCP_PSH 0x008 / TCP_ACK 0x010 / TCP_URG 0x020
@@ -388,8 +388,8 @@ public class MatchUtils {
     /**
      * Create  TCP Port Match
      *
-     * @param matchBuilder @param matchbuilder MatchBuilder Object without a match yet
-     * @param tcpport      Integer representing a source TCP port
+     * @param matchBuilder MatchBuilder Object without a match yet
+     * @param ipProtocol   Integer representing the IP protocol
      * @return matchBuilder Map MatchBuilder Object with a match
      */
     public static MatchBuilder createIpProtocolMatch(MatchBuilder matchBuilder, short ipProtocol) {