Added comments to the DeviceManagerService interface

components/device-mgt/org.wso2.carbon.device.mgt.common/src/main/java/org/wso2/carbon/device/mgt/common/spi/DeviceManagerService.java

@@ -63,7 +63,8 @@ public interface DeviceManagerService {
      *
      * @param deviceId  Fully qualified device identifier
      * @return Status of enrollment
-     * @throws DeviceManagementException If some unusual behaviour is observed while enrolling a device
+     * @throws DeviceManagementException If some unusual behaviour is observed while checking the enrollment
+     *                      status of the device
      */
     boolean isEnrolled(DeviceIdentifier deviceId) throws DeviceManagementException;
 
@@ -72,7 +73,8 @@ public interface DeviceManagerService {
      *
      * @param deviceId  Fully qualified device identifier
      * @return Returns if the device is active
-     * @throws DeviceManagementException If some unusual behaviour is observed while enrolling a device
+     * @throws DeviceManagementException If some unusual behaviour is observed while checking the status
+     * of the device
      */
     boolean isActive(DeviceIdentifier deviceId) throws DeviceManagementException;
 
@@ -82,7 +84,8 @@ public interface DeviceManagerService {
      *
      * @param deviceId  Fully qualified device identifier
      * @param status    Indicates whether the device is active
-     * @throws DeviceManagementException If some unusual behaviour is observed while enrolling a device
+     * @throws DeviceManagementException If some unusual behaviour is observed while updating the active status
+     * of the device
      */
     boolean setActive(DeviceIdentifier deviceId, boolean status) throws DeviceManagementException;
 
@@ -91,6 +94,7 @@ public interface DeviceManagerService {
      *
      * @param type  Device Type
      * @return List of metadata corresponding to all devices registered within CDM
+     * @throws DeviceManagementException If some unusual behaviour is observed while obtaining the enrolled device list
      */
     List<Device> getAllDevices(String type) throws DeviceManagementException;
 
@@ -99,14 +103,14 @@ public interface DeviceManagerService {
      *
      * @param deviceId  Fully qualified device identifier
      * @return          Metadata corresponding to a particular device
-     * @throws DeviceManagementException If some unusual behaviour is observed while enrolling a device
+     * @throws DeviceManagementException If some unusual behaviour is observed obtaining the device object
      */
     Device getDevice(DeviceIdentifier deviceId) throws DeviceManagementException;
 
     /**
      * Method to update device information.
      * @param device   Updated device information related data
-     * @throws DeviceManagementException If some unusual behaviour is observed while enrolling a device
+     * @throws DeviceManagementException If some unusual behaviour is observed while updating the device info
      */
     boolean updateDeviceInfo(Device device) throws DeviceManagementException;
 
@@ -115,7 +119,8 @@ public interface DeviceManagerService {
      *
      * @param deviceId          Fully qualified device identifier
      * @param ownershipType     Type of ownership
-     * @throws DeviceManagementException If some unusual behaviour is observed while enrolling a device
+     * @throws DeviceManagementException If some unusual behaviour is observed while setting the ownership
+     * of the device
      */
     boolean setOwnership(DeviceIdentifier deviceId, String ownershipType) throws DeviceManagementException;