ONOS-5917 SNMP Alarm Provider

Change-Id: I9eb39021584f3b1a5baed9dfa638569818901197
diff --git a/protocols/snmp/api/src/main/java/org/onosproject/snmp/SnmpController.java b/protocols/snmp/api/src/main/java/org/onosproject/snmp/SnmpController.java
index 0369fc2..4868ea0 100644
--- a/protocols/snmp/api/src/main/java/org/onosproject/snmp/SnmpController.java
+++ b/protocols/snmp/api/src/main/java/org/onosproject/snmp/SnmpController.java
@@ -17,15 +17,19 @@
 package org.onosproject.snmp;
 
 import com.btisystems.pronx.ems.core.snmp.ISnmpSession;
+import com.google.common.annotations.Beta;
+
 import org.onosproject.incubator.net.faultmanagement.alarm.DefaultAlarm;
 import org.onosproject.net.DeviceId;
 
 import java.io.IOException;
+import java.net.URI;
 import java.util.Collection;
 
 /**
  * Snmp Controller.
  */
+@Beta
 public interface SnmpController {
 
     /**
@@ -42,6 +46,14 @@
     SnmpDevice getDevice(DeviceId deviceId);
 
     /**
+     * Gets a device for a specific host address.
+     *
+     * @param uri URI of the device
+     * @return SnmpDevice for given deviceId
+     */
+    SnmpDevice getDevice(URI uri);
+
+    /**
      * Removes a specific device.
      * @param deviceId device id of the device to be removed
      */
@@ -50,9 +62,18 @@
     /**
      * Add a device with a specific DeviceId.
      * @param deviceId deviceId of the device
+     * @param device   device to add to this controller
+     * @deprecated 1.10.0 moved to single parameter method with boolean return
+     */
+    @Deprecated
+    void addDevice(DeviceId deviceId, SnmpDevice device);
+
+    /**
+     * Add a snmp device.
+     *
      * @param device device to add to this controller
      */
-    void addDevice(DeviceId deviceId, SnmpDevice device);
+    void addDevice(SnmpDevice device);
 
     /**
      * Gets an Instance of ISnmpSession for a specific device.
@@ -60,7 +81,9 @@
      * @param deviceId device to retrieve the session for.
      * @return ISnmp session.
      * @throws IOException if the session can't be established.
+     * @deprecated 1.14.0 moved to snmp4j
      */
+    @Deprecated
     ISnmpSession getSession(DeviceId deviceId) throws IOException;
 
     /**
@@ -70,4 +93,6 @@
      * @return default alarm error
      */
     DefaultAlarm buildWalkFailedAlarm(DeviceId deviceId);
+
+
 }