Fix checkstyle issues to enforce it
[controller.git] / opendaylight / config / config-api / src / main / java / org / opendaylight / controller / config / api / ServiceReferenceWritableRegistry.java
index f7b56fe4c2240c4b7ac80a54f7c372db6205b448..77fc8dc3c785f1b4c42b60ce83ecb879041d777b 100644 (file)
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2013 Cisco Systems, Inc. and others.  All rights reserved.
+ * Copyright (c) 2013, 2017 Cisco Systems, Inc. and others.  All rights reserved.
  *
  * This program and the accompanying materials are made available under the
  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
@@ -12,16 +12,25 @@ import javax.management.ObjectName;
 
 public interface ServiceReferenceWritableRegistry extends ServiceReferenceReadableRegistry {
     /**
-     * Create or update reference name to objectName. Reference name is unique per service interface name.
-     * @return created or updated object name containing service name and reference name
-     * @throws IllegalArgumentException if there is a mismatch between serviceInterfaceName and objectName
-     * @throws InstanceNotFoundException if search did not find exactly one instance
+     * Create or update reference name to objectName. Reference name is unique per
+     * service interface name.
+     *
+     * @return created or updated object name containing service name and reference
+     *         name
+     * @throws IllegalArgumentException
+     *             if there is a mismatch between serviceInterfaceName and
+     *             objectName
+     * @throws InstanceNotFoundException
+     *             if search did not find exactly one instance
      */
-    ObjectName saveServiceReference(String serviceInterfaceName, String refName, ObjectName moduleON) throws InstanceNotFoundException;
+    ObjectName saveServiceReference(String serviceInterfaceName, String refName, ObjectName moduleON)
+            throws InstanceNotFoundException;
 
     /**
      * Remove service reference.
-     * @throws IllegalArgumentException if service interface name is not advertised by any module
+     *
+     * @throws IllegalArgumentException
+     *             if service interface name is not advertised by any module
      */
     void removeServiceReference(String serviceInterfaceName, String refName) throws InstanceNotFoundException;
 
@@ -32,6 +41,7 @@ public interface ServiceReferenceWritableRegistry extends ServiceReferenceReadab
 
     /**
      * Remove all service references attached to given module.
+     *
      * @return true iif at least one reference was removed
      */
     boolean removeServiceReferences(ObjectName objectName) throws InstanceNotFoundException;