Merge branch 'master' of https://github.com/wso2/carbon-device-mgt

Adding swagger annotations to beans

components/device-mgt/org.wso2.carbon.device.mgt.api/pom.xml

@@ -207,6 +207,24 @@
         <dependency>
             <groupId>io.swagger</groupId>
             <artifactId>swagger-annotations</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.swagger</groupId>
+            <artifactId>swagger-core</artifactId>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.slf4j</groupId>
+                    <artifactId>slf4j-api</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+        <dependency>
+            <groupId>io.swagger</groupId>
+            <artifactId>swagger-jaxrs</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>javax.servlet</groupId>
+            <artifactId>servlet-api</artifactId>
             <scope>provided</scope>
         </dependency>
     </dependencies>

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/ApiOriginFilter.java

@@ -0,0 +1,44 @@
+/*
+ *   Copyright (c) 2016, WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
+ *
+ *   WSO2 Inc. licenses this file to you under the Apache License,
+ *   Version 2.0 (the "License"); you may not use this file except
+ *   in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing,
+ *   software distributed under the License is distributed on an
+ *   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ *   KIND, either express or implied.  See the License for the
+ *   specific language governing permissions and limitations
+ *   under the License.
+ *
+ */
+package org.wso2.carbon.device.mgt.jaxrs;
+
+import javax.servlet.*;
+import javax.servlet.http.HttpServletResponse;
+import java.io.IOException;
+
+public class ApiOriginFilter implements Filter {
+
+    public void doFilter(ServletRequest request, ServletResponse response,
+                         FilterChain chain) throws IOException, ServletException {
+        HttpServletResponse res = (HttpServletResponse) response;
+        res.addHeader("Access-Control-Allow-Origin", "*");
+        res.addHeader("Access-Control-Allow-Methods", "GET, POST, DELETE, PUT");
+        res.addHeader("Access-Control-Allow-Headers", "Content-Type");
+        chain.doFilter(request, response);
+    }
+
+    public void destroy() {
+        //do nothing
+    }
+
+    public void init(FilterConfig filterConfig) throws ServletException {
+        //do nothing
+    }
+
+}

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/api/Authentication.java

@@ -1,34 +0,0 @@
-/*
- * Copyright (c) 2016, WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
- *
- * WSO2 Inc. licenses this file to you under the Apache License,
- * Version 2.0 (the "License"); you may not use this file except
- * in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied. See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-package org.wso2.carbon.device.mgt.jaxrs.api;
-
-import io.swagger.annotations.Api;
-
-import javax.ws.rs.Consumes;
-import javax.ws.rs.Produces;
-
-/**
- * Authentication related REST-API interface.
- */
-@Api(value = "Authentication")
-@Produces({ "application/json", "application/xml" })
-@Consumes({ "application/json", "application/xml" })
-public interface Authentication {
-
-}

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/api/Certificate.java

@@ -18,15 +18,10 @@
 
 package org.wso2.carbon.device.mgt.jaxrs.api;
 
-import io.swagger.annotations.Api;
+import io.swagger.annotations.*;
-import io.swagger.annotations.ApiOperation;
-import io.swagger.annotations.ApiParam;
-import io.swagger.annotations.ApiResponse;
-import io.swagger.annotations.ApiResponses;
 import org.wso2.carbon.certificate.mgt.core.dto.CertificateResponse;
 import org.wso2.carbon.device.mgt.common.PaginationResult;
 import org.wso2.carbon.device.mgt.jaxrs.api.common.MDMAPIException;
-import org.wso2.carbon.device.mgt.jaxrs.api.util.ResponsePayload;
 import org.wso2.carbon.device.mgt.jaxrs.beans.EnrollmentCertificate;
 
 import javax.ws.rs.*;
@@ -39,6 +34,7 @@ import javax.ws.rs.core.Response;
 @Api(value = "Certificate", description = "Certificate related tasks such as saving certificates, " +
                                           "can be done through this API")
 @SuppressWarnings("NonJaxWsWebServices")
+@Path("/certificates")
 @Produces({ "application/json", "application/xml" })
 @Consumes({ "application/json", "application/xml" })
 public interface Certificate {
@@ -83,7 +79,7 @@ public interface Certificate {
             notes = "Get the client side SSL certificate details",
             response = CertificateResponse.class)
     @ApiResponses(value = {
-            @ApiResponse(code = 200, message = "OK"),
+            @ApiResponse(code = 200, message = "OK", response = CertificateResponse.class),
             @ApiResponse(code = 400, message = "Notification status updated successfully"),
             @ApiResponse(code = 500, message = "Error occurred while converting PEM file to X509Certificate")
             })
@@ -112,7 +108,7 @@ public interface Certificate {
                     + "page therefore the details are paginated",
             response = PaginationResult.class)
     @ApiResponses(value = {
-            @ApiResponse(code = 200, message = "OK"),
+            @ApiResponse(code = 200, message = "OK", response = PaginationResult.class),
             @ApiResponse(code = 400, message = "Invalid start index"),
             @ApiResponse(code = 400, message = "Invalid length value"),
             @ApiResponse(code = 500, message = "Error occurred while fetching all certificates")

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/api/Configuration.java

@@ -18,13 +18,8 @@
 
 package org.wso2.carbon.device.mgt.jaxrs.api;
 
-import io.swagger.annotations.Api;
+import io.swagger.annotations.*;
-import io.swagger.annotations.ApiOperation;
-import io.swagger.annotations.ApiParam;
-import io.swagger.annotations.ApiResponse;
-import io.swagger.annotations.ApiResponses;
 import org.wso2.carbon.device.mgt.common.configuration.mgt.TenantConfiguration;
-import org.wso2.carbon.device.mgt.jaxrs.api.util.ResponsePayload;
 
 import javax.ws.rs.*;
 import javax.ws.rs.core.MediaType;
@@ -34,9 +29,9 @@ import javax.ws.rs.core.Response;
  * General Tenant Configuration REST-API implementation.
  * All end points support JSON, XMl with content negotiation.
  */
+@Path("/configuration")
 @Api(value = "Configuration", description = "General Tenant Configuration management capabilities are exposed " +
-                                            "through " +
+                                            "through this API")
-                                            "this API")
 @SuppressWarnings("NonJaxWsWebServices")
 @Produces({ "application/json", "application/xml" })
 @Consumes({ "application/json", "application/xml" })

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/api/Device.java

@@ -29,7 +29,7 @@ import javax.ws.rs.core.Response;
 /**
  * Device related operations such as get all the available devices, etc.
  */
-
+@Path("/devices")
 @Api(value = "Device", description = "Device related operations such as get all the available devices, etc.")
 @SuppressWarnings("NonJaxWsWebServices")
 public interface Device {
@@ -41,6 +41,7 @@ public interface Device {
      * @return Device List
      */
     @GET
+    @Path("devices")
     @ApiOperation(
             consumes = MediaType.APPLICATION_JSON,
             produces = MediaType.APPLICATION_JSON,
@@ -95,7 +96,7 @@ public interface Device {
      */
     @GET
     @Path("user/{user}")
-    Response getDevice(@PathParam("user") String user);
+    Response getDeviceOfUser(@PathParam("user") String user);
 
     /**
      * Fetch device count of a given user.
@@ -105,7 +106,7 @@ public interface Device {
      */
     @GET
     @Path("user/{user}/count")
-    Response getDeviceCount(@PathParam("user") String user);
+    Response getDeviceCountOfUser(@PathParam("user") String user);
 
     /**
      * Get current device count
@@ -118,7 +119,7 @@ public interface Device {
             httpMethod = "GET",
             value = "Getting the Device Count",
             notes = "Get the number of devices that are registered with WSO2 EMM.",
-            response = Integer.class)
+            response = int.class)
     @ApiResponses(value = {
             @ApiResponse(code = 200, message = "Device count"),
             @ApiResponse(code = 500, message = "Error occurred while fetching the device count")

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/api/DeviceInformation.java

@@ -18,14 +18,9 @@
 
 package org.wso2.carbon.device.mgt.jaxrs.api;
 
-import io.swagger.annotations.Api;
+import io.swagger.annotations.*;
-import io.swagger.annotations.ApiOperation;
-import io.swagger.annotations.ApiParam;
-import io.swagger.annotations.ApiResponse;
-import io.swagger.annotations.ApiResponses;
 import org.wso2.carbon.device.mgt.common.device.details.DeviceInfo;
 import org.wso2.carbon.device.mgt.common.device.details.DeviceLocation;
-import org.wso2.carbon.device.mgt.jaxrs.beans.UserCredentialWrapper;
 
 import javax.ws.rs.GET;
 import javax.ws.rs.Path;
@@ -36,7 +31,7 @@ import javax.ws.rs.core.Response;
 /**
  * Device information related operations.
  */
-
+@Path("/information")
 @Api(value = "DeviceInformation", description = "Device information related operations can be found here.")
 @SuppressWarnings("NonJaxWsWebServices")
 public interface DeviceInformation {

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/api/DeviceNotification.java

@@ -42,8 +42,9 @@ import javax.ws.rs.core.Response;
  */
 @Api(value = "DeviceNotification", description = "Device notification related operations can be found here.")
 @SuppressWarnings("NonJaxWsWebServices")
+@Path("/notifications")
 @Produces({"application/json", "application/xml"})
-@Consumes({ "application/json", "application/xml" })
+@Consumes({"application/json", "application/xml"})
 public interface DeviceNotification {
 
     @GET
@@ -57,7 +58,8 @@ public interface DeviceNotification {
             response = Notification.class,
             responseContainer = "List")
     @ApiResponses(value = {
-            @ApiResponse(code = 200, message = "List of Notifications"),
+            @ApiResponse(code = 200, message = "List of Notifications", response = Notification.class,
+                    responseContainer = "List"),
             @ApiResponse(code = 500, message = "Error occurred while retrieving the notification list")
     })
     Response getNotifications();
@@ -74,7 +76,8 @@ public interface DeviceNotification {
             response = Notification.class,
             responseContainer = "List")
     @ApiResponses(value = {
-            @ApiResponse(code = 200, message = "List of Notifications"),
+            @ApiResponse(code = 200, message = "List of Notifications", response = Notification.class,
+                    responseContainer = "List"),
             @ApiResponse(code = 500, message = "Error occurred while retrieving the notification list")
     })
     Response getNotificationsByStatus(@ApiParam(name = "status", value = "Provide the notification status as"
@@ -94,7 +97,7 @@ public interface DeviceNotification {
             @ApiResponse(code = 201, message = "Notification status updated successfully"),
             @ApiResponse(code = 500, message = "Error occurred while updating notification status")
     })
-    Response updateNotificationStatus( @ApiParam(name = "id", value = "Provide the ID of the notification"
+    Response updateNotificationStatus(@ApiParam(name = "id", value = "Provide the ID of the notification"
             + " you wish you update", required = true) @PathParam("id") int id,
                                       @ApiParam(name = "status", value = "Provide the notification status as"
                                               + " the value", required = true) @PathParam("status")

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/api/DeviceSearch.java

@@ -18,23 +18,19 @@
 
 package org.wso2.carbon.device.mgt.jaxrs.api;
 
-import io.swagger.annotations.Api;
+import io.swagger.annotations.*;
-import io.swagger.annotations.ApiOperation;
-import io.swagger.annotations.ApiParam;
-import io.swagger.annotations.ApiResponse;
-import io.swagger.annotations.ApiResponses;
-import org.wso2.carbon.device.mgt.common.PaginationResult;
 import org.wso2.carbon.device.mgt.common.device.details.DeviceWrapper;
 import org.wso2.carbon.device.mgt.common.search.SearchContext;
 
 import javax.ws.rs.GET;
+import javax.ws.rs.Path;
 import javax.ws.rs.core.MediaType;
 import javax.ws.rs.core.Response;
 
 /**
  * Device search related operations such as getting device information.
  */
-
+@Path("/search")
 @Api(value = "DeviceSearch", description = "Device searching related operations can be found here.")
 @SuppressWarnings("NonJaxWsWebServices")
 public interface DeviceSearch {
@@ -48,9 +44,9 @@ public interface DeviceSearch {
             response = DeviceWrapper.class,
             responseContainer = "List")
     @ApiResponses(value = {
-            @ApiResponse(code = 200, message = "OK"),
+            @ApiResponse(code = 200, message = "OK", response = DeviceWrapper.class, responseContainer = "List"),
             @ApiResponse(code = 500, message = "Error occurred while searching the device information")
             })
-    Response getDeviceInfo(@ApiParam(name = "enrollmentCertificates", value = "List of search conditions",
+    Response getFilteredDeviceInfo(@ApiParam(name = "enrollmentCertificates", value = "List of search conditions",
                                     required = true) SearchContext searchContext);
 }

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/api/Feature.java

@@ -34,6 +34,7 @@ import javax.ws.rs.core.Response;
 
 @Api(value = "Feature", description = "Feature management related operations can be found here.")
 @SuppressWarnings("NonJaxWsWebServices")
+@Path("/features")
 @Produces({"application/json", "application/xml"})
 @Consumes({"application/json", "application/xml"})
 public interface Feature {

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/api/License.java

@@ -28,6 +28,7 @@ import javax.ws.rs.core.Response;
  * This class represents license related operations.
  */
 @Api(value = "License")
+@Path("/license")
 @SuppressWarnings("NonJaxWsWebServices")
 public interface License {
 

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/api/Operation.java

@@ -19,25 +19,19 @@
 package org.wso2.carbon.device.mgt.jaxrs.api;
 
 import io.swagger.annotations.*;
-import org.wso2.carbon.device.mgt.common.PaginationResult;
 import org.wso2.carbon.device.mgt.common.app.mgt.Application;
 import org.wso2.carbon.device.mgt.jaxrs.api.common.MDMAPIException;
 import org.wso2.carbon.device.mgt.jaxrs.api.context.DeviceOperationContext;
-import org.wso2.carbon.device.mgt.jaxrs.api.util.ResponsePayload;
 import org.wso2.carbon.device.mgt.jaxrs.beans.ApplicationWrapper;
 
-import javax.ws.rs.GET;
+import javax.ws.rs.*;
-import javax.ws.rs.POST;
-import javax.ws.rs.Path;
-import javax.ws.rs.PathParam;
-import javax.ws.rs.QueryParam;
 import javax.ws.rs.core.MediaType;
 import javax.ws.rs.core.Response;
 
 /**
  *
  */
-
+@Path("/operations")
 @Api(value = "Operation", description = "Operation management related operations can be found here.")
 public interface Operation {
 
@@ -51,7 +45,7 @@ public interface Operation {
             consumes = MediaType.APPLICATION_JSON + ", " + MediaType.APPLICATION_XML,
             produces = MediaType.APPLICATION_JSON + ", " + MediaType.APPLICATION_XML,
             httpMethod = "GET",
-            value = "Getting Pagination Details for Operations on a Device.",
+            value = "Getting Paginated Details for Operations on a Device.",
             notes = "You will carry out many operations on a device. In a situation where you wish to view the all" +
                     " the operations carried out on a device it is not feasible to show all the details on one page" +
                     " therefore the details are paginated." +
@@ -59,9 +53,9 @@ public interface Operation {
                     "carried out, the details of the 21 operations will be broken down into 3 pages with 10 operation" +
                     " details per page.",
             response = org.wso2.carbon.device.mgt.common.operation.mgt.Operation.class)
-    @ApiResponses(value = { @ApiResponse(code = 200, message = "List of Operations on a device."),
+    @ApiResponses(value = {@ApiResponse(code = 200, message = "List of Operations on a device."),
             @ApiResponse(code = 500, message = "Error occurred while fetching the operations for the " +
-                                                               "device.") })
+                    "device.")})
     Response getDeviceOperations(@ApiParam(name = "type", value = "Define the device type as the value for {type}. " +
             "Example: ios, android or windows.",
             required = true) @PathParam("type") String type,
@@ -88,10 +82,10 @@ public interface Operation {
             responseContainer = "List",
             notes = "Get the details of operations carried out on a selected device.",
             response = org.wso2.carbon.device.mgt.common.operation.mgt.Operation.class)
-    @ApiResponses(value = { @ApiResponse(code = 200, message = "List of Operations on a device."),
+    @ApiResponses(value = {@ApiResponse(code = 200, message = "List of Operations on a device."),
             @ApiResponse(code = 500, message = "Error occurred while fetching the operations for the " +
-                                                               "device.") })
+                    "device.")})
-    Response getDeviceOperations(@ApiParam(name = "type", value = "Define the device type as the value for {type}. " +
+    Response getAllDeviceOperations(@ApiParam(name = "type", value = "Define the device type as the value for {type}. " +
             "Example: ios, android or windows.",
             required = true) @PathParam("type") String type,
                                     @ApiParam(name = "id", value = "Define the device ID",
@@ -111,9 +105,9 @@ public interface Operation {
             responseContainer = "List",
             notes = "Get the list of applications that a device has subscribed.",
             response = Application.class)
-    @ApiResponses(value = { @ApiResponse(code = 200, message = "List of installed application details of a device."),
+    @ApiResponses(value = {@ApiResponse(code = 200, message = "List of installed application details of a device.", response = Application.class, responseContainer = "List"),
             @ApiResponse(code = 500, message = "Error occurred while fetching the apps of the device" +
-                                                               ".") })
+                    ".")})
     Response getInstalledApps(@ApiParam(name = "type", value = "Define the device type as the value for {type}. " +
             "Example: ios, android or windows.",
             required = true) @PathParam("type") String type,
@@ -128,8 +122,8 @@ public interface Operation {
             httpMethod = "POST",
             value = "Installing an Application on a Device.",
             notes = "Install a selected application on a device.")
-    @ApiResponses(value = { @ApiResponse(code = 200, message = "Operation was successfully added to the queue."),
+    @ApiResponses(value = {@ApiResponse(code = 200, message = "Operation was successfully added to the queue."),
-                            @ApiResponse(code = 500, message = "Error occurred while saving the operation.") })
+            @ApiResponse(code = 500, message = "Error occurred while saving the operation.")})
     Response installApplication(@ApiParam(name = "applicationWrapper", value = "Details about the application and the" +
             " users and roles it should be " +
             "installed on.",
@@ -147,8 +141,8 @@ public interface Operation {
             httpMethod = "POST",
             value = "Uninstalling an Application from a Device.",
             notes = "Uninstall a selected application from a device.")
-    @ApiResponses(value = { @ApiResponse(code = 200, message = "Operation was successfully added to the queue."),
+    @ApiResponses(value = {@ApiResponse(code = 200, message = "Operation was successfully added to the queue."),
-                            @ApiResponse(code = 500, message = "Error occurred while saving the operation.") })
+            @ApiResponse(code = 500, message = "Error occurred while saving the operation.")})
     Response uninstallApplication(@ApiParam(name = "applicationWrapper", value = "Details about the application and" +
             " the users and roles it should be " +
             "uninstalled.",
@@ -167,8 +161,8 @@ public interface Operation {
             httpMethod = "POST",
             value = "Retrieving the operation details.",
             notes = "This will return the operation details including the responses from the devices")
-    @ApiResponses(value = { @ApiResponse(code = 200, message = "Activity details provided successfully.."),
+    @ApiResponses(value = {@ApiResponse(code = 200, message = "Activity details provided successfully.."),
-            @ApiResponse(code = 500, message = "Error occurred while fetching the activity for the supplied id.") })
+            @ApiResponse(code = 500, message = "Error occurred while fetching the activity for the supplied id.")})
     Response getActivity(@ApiParam(name = "id", value = "Provide activity id {id} as ACTIVITY_(number)",
             required = true) @PathParam("id") String id)
             throws MDMAPIException;

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/api/Policy.java

@@ -20,25 +20,15 @@ package org.wso2.carbon.device.mgt.jaxrs.api;
 
 import io.swagger.annotations.*;
 import org.wso2.carbon.device.mgt.jaxrs.api.common.MDMAPIException;
-import org.wso2.carbon.device.mgt.jaxrs.api.util.ResponsePayload;
 import org.wso2.carbon.device.mgt.jaxrs.beans.PolicyWrapper;
 import org.wso2.carbon.device.mgt.jaxrs.beans.PriorityUpdatedPolicyWrapper;
 
-import javax.ws.rs.Consumes;
+import javax.ws.rs.*;
-import javax.ws.rs.GET;
-import javax.ws.rs.POST;
-import javax.ws.rs.PUT;
-import javax.ws.rs.Path;
-import javax.ws.rs.PathParam;
-import javax.ws.rs.Produces;
 import javax.ws.rs.core.MediaType;
 import javax.ws.rs.core.Response;
 import java.util.List;
 
-/**
+@Path("/policies")
- *
- */
-
 @Api(value = "Policy", description = "Policy management related operations can be found here.")
 public interface Policy {
 
@@ -52,9 +42,9 @@ public interface Policy {
             notes = "Add a policy using this REST API command. When adding a policy you will have the option of " +
                     "saving the policy or saving and publishing the policy. Using the REST API command given below " +
                     "you are able to save a created Policy and this policy will be in the inactive state")
-    @ApiResponses(value = { @ApiResponse(code = 201, message = "Created the policy."),
+    @ApiResponses(value = {@ApiResponse(code = 201, message = "Created the policy."),
             @ApiResponse(code = 500, message = "Policy Management related error occurred when " +
-                                                               "adding the policy") })
+                    "adding the policy")})
     Response addPolicy(@ApiParam(name = "policyWrapper", value = "Policy details related to the operation.",
             required = true) PolicyWrapper policyWrapper);
 
@@ -69,14 +59,14 @@ public interface Policy {
                     "will have the option of saving the policy or saving and publishing the policy. Using the REST " +
                     "API command given below you are able to save and publish a created policy and this policy will " +
                     "be in the active state.")
-    @ApiResponses(value = { @ApiResponse(code = 201, message = "Created the policy."),
+    @ApiResponses(value = {@ApiResponse(code = 201, message = "Created the policy."),
             @ApiResponse(code = 500, message = "Policy Management related error occurred when " +
-                                                               "adding the policy") })
+                    "adding the policy")})
     Response addActivePolicy(@ApiParam(name = "policyWrapper", value = "Policy details related to the operation.",
             required = true) PolicyWrapper policyWrapper);
 
     @GET
-    @Produces({ MediaType.APPLICATION_JSON})
+    @Produces({MediaType.APPLICATION_JSON})
     @ApiOperation(
             consumes = MediaType.APPLICATION_JSON,
             produces = MediaType.APPLICATION_JSON,
@@ -85,9 +75,10 @@ public interface Policy {
             responseContainer = "List",
             notes = "Retrieve the details of all the policies that you have created in WSO2 EMM.",
             response = org.wso2.carbon.policy.mgt.common.Policy.class)
-    @ApiResponses(value = { @ApiResponse(code = 200, message = "Fetched all policies."),
+    @ApiResponses(value = {@ApiResponse(code = 200, message = "Fetched all policies.",
+            response = org.wso2.carbon.policy.mgt.common.Policy.class, responseContainer = "List"),
             @ApiResponse(code = 500, message = "Policy Management related error occurred when " +
-                                                               "fetching the policies.") })
+                    "fetching the policies.")})
     Response getAllPolicies();
 
     @GET
@@ -100,9 +91,9 @@ public interface Policy {
             value = "Getting Details of a Policy.",
             notes = "Retrieve the details of a selected policy in WSO2 EMM.",
             response = org.wso2.carbon.policy.mgt.common.Policy.class)
-    @ApiResponses(value = { @ApiResponse(code = 200, message = "Fetched policy details."),
+    @ApiResponses(value = {@ApiResponse(code = 200, message = "Fetched policy details."),
             @ApiResponse(code = 500, message = "Policy Management related error occurred when " +
-                                                               "fetching the policies.") })
+                    "fetching the policies.")})
     Response getPolicy(@ApiParam(name = "id", value = "Policy ID value to identify a policy uniquely.",
             required = true) @PathParam("id") int policyId);
 
@@ -114,9 +105,9 @@ public interface Policy {
             httpMethod = "GET",
             value = "Getting the Policy Count.",
             notes = "Get the number of policies that are created in WSO2 EMM.",
-            response = Integer.class)
+            response = int.class)
-    @ApiResponses(value = { @ApiResponse(code = 200, message = "Fetched the policy count."),
+    @ApiResponses(value = {@ApiResponse(code = 200, message = "Fetched the policy count."),
-                            @ApiResponse(code = 500, message = "Error while Fetching the policy count.") })
+            @ApiResponse(code = 500, message = "Error while Fetching the policy count.")})
     Response getPolicyCount();
 
     @PUT
@@ -128,9 +119,9 @@ public interface Policy {
             value = "Updating a Policy.",
             notes = "If you wish to make changes to an existing policy, you can do so by updating the policy using " +
                     "this API")
-    @ApiResponses(value = { @ApiResponse(code = 201, message = "Policy has been updated successfully."),
+    @ApiResponses(value = {@ApiResponse(code = 201, message = "Policy has been updated successfully."),
             @ApiResponse(code = 500, message = "Policy Management related exception in policy " +
-                                                               "update") })
+                    "update")})
     Response updatePolicy(@ApiParam(name = "policyWrapper", value = "Policy details related to the operation.",
             required = true) PolicyWrapper policyWrapper,
                           @ApiParam(name = "id", value = "Policy ID value to identify a policy uniquely.",
@@ -147,9 +138,9 @@ public interface Policy {
             value = "Updating the Policy Priority.",
             notes = "If you wish to make changes to the existing policy priority order, " +
                     "you can do so by updating the priority order using this API")
-    @ApiResponses(value = { @ApiResponse(code = 200, message = "Policy Priorities successfully updated."),
+    @ApiResponses(value = {@ApiResponse(code = 200, message = "Policy Priorities successfully updated."),
             @ApiResponse(code = 400, message = "Policy priorities did not update."),
-                            @ApiResponse(code = 500, message = "Error in updating policy priorities.") })
+            @ApiResponse(code = 500, message = "Error in updating policy priorities.")})
     Response updatePolicyPriorities(@ApiParam(name = "priorityUpdatedPolicies",
             value = "List of policy update details..",
             required = true) List<PriorityUpdatedPolicyWrapper> priorityUpdatedPolicies);
@@ -164,9 +155,9 @@ public interface Policy {
             httpMethod = "POST",
             value = "Removing Multiple Policies.",
             notes = "In situations where you need to delete more than one policy you can do so using this API.")
-    @ApiResponses(value = { @ApiResponse(code = 200, message = "Policies have been successfully deleted."),
+    @ApiResponses(value = {@ApiResponse(code = 200, message = "Policies have been successfully deleted."),
             @ApiResponse(code = 400, message = "Policy does not exist."),
-                            @ApiResponse(code = 500, message = "Error in deleting policies.") })
+            @ApiResponse(code = 500, message = "Error in deleting policies.")})
     Response bulkRemovePolicy(@ApiParam(name = "policyIds", value = "Policy ID list to be deleted.",
             required = true) List<Integer> policyIds);
 
@@ -180,8 +171,8 @@ public interface Policy {
             value = "Activating Policies.",
             notes = "Using the REST API command you are able to publish a policy in order to bring a policy that is " +
                     "in the inactive state to the active state.")
-    @ApiResponses(value = { @ApiResponse(code = 200, message = "Policies have been successfully activated."),
+    @ApiResponses(value = {@ApiResponse(code = 200, message = "Policies have been successfully activated."),
-                            @ApiResponse(code = 500, message = "Error in activating policies.") })
+            @ApiResponse(code = 500, message = "Error in activating policies.")})
     Response activatePolicy(@ApiParam(name = "policyIds", value = "Policy ID list to be activated.",
             required = true) List<Integer> policyIds);
 
@@ -195,8 +186,8 @@ public interface Policy {
             value = "Deactivating Policies.",
             notes = "Using the REST API command you are able to unpublish a policy in order to bring a policy that " +
                     "is in the active state to the inactive state.")
-    @ApiResponses(value = { @ApiResponse(code = 200, message = "Policies have been successfully deactivated."),
+    @ApiResponses(value = {@ApiResponse(code = 200, message = "Policies have been successfully deactivated."),
-                            @ApiResponse(code = 500, message = "Error in deactivating policies.") })
+            @ApiResponse(code = 500, message = "Error in deactivating policies.")})
     Response inactivatePolicy(@ApiParam(name = "policyIds", value = "Policy ID list to be deactivated.",
             required = true) List<Integer> policyIds) throws MDMAPIException;
 
@@ -213,8 +204,8 @@ public interface Policy {
                     " policies (removing, activating, deactivating and updating) or add new policies, the existing" +
                     " devices will not receive these changes immediately. Once all the required changes are made" +
                     " you need to apply the changes to push the policy changes to the existing devices.")
-    @ApiResponses(value = { @ApiResponse(code = 200, message = "Changes have been successfully updated."),
+    @ApiResponses(value = {@ApiResponse(code = 200, message = "Changes have been successfully updated."),
-                            @ApiResponse(code = 500, message = "Error in updating policies.") })
+            @ApiResponse(code = 500, message = "Error in updating policies.")})
     Response applyChanges();
 
     @GET
@@ -229,9 +220,9 @@ public interface Policy {
                     "It will monitor the device based on the policy monitoring frequency that you define in " +
                     "milliseconds.Using this REST API to start the policy monitoring task is optional as " +
                     "WSO2 EMM uses an OSGI call to start the monitoring task")
-    @ApiResponses(value = { @ApiResponse(code = 200, message = "Policy monitoring service started successfully."),
+    @ApiResponses(value = {@ApiResponse(code = 200, message = "Policy monitoring service started successfully."),
             @ApiResponse(code = 500, message = "Policy Management related exception when starting " +
-                                                               "monitoring service.") })
+                    "monitoring service.")})
     Response startTaskService(@ApiParam(name = "milliseconds", value = "Policy monitoring frequency in milliseconds.",
             required = true) @PathParam("milliseconds") int monitoringFrequency);
 
@@ -258,8 +249,8 @@ public interface Policy {
                     "filters the policies based on the Platform (device type), filters based on the device ownership" +
                     " type , filters based on the user role or name and finally the policy is enforced on the device.",
             response = org.wso2.carbon.policy.mgt.common.Policy.class)
-    @ApiResponses(value = { @ApiResponse(code = 200, message = "Fetched current policy."),
+    @ApiResponses(value = {@ApiResponse(code = 200, message = "Fetched current policy."),
-                            @ApiResponse(code = 500, message = "Error occurred while getting the current policy.") })
+            @ApiResponse(code = 500, message = "Error occurred while getting the current policy.")})
     Response getDeviceActivePolicy(@ApiParam(name = "type", value = "Define the device type as the value for {type}." +
             " Example: ios, android, windows..",
             required = true) @PathParam("type") String type,

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/api/Profile.java

@@ -30,6 +30,7 @@ import javax.ws.rs.core.Response;
  * These end points provide profile related operations.
  */
 @Api(value = "Profile")
+@Path("/profiles")
 @SuppressWarnings("NonJaxWsWebServices")
 public interface Profile {
 

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/api/Role.java

@@ -19,26 +19,15 @@
 package org.wso2.carbon.device.mgt.jaxrs.api;
 
 import io.swagger.annotations.*;
-import org.wso2.carbon.device.mgt.common.app.mgt.Application;
-import org.wso2.carbon.device.mgt.jaxrs.api.util.ResponsePayload;
 import org.wso2.carbon.device.mgt.jaxrs.beans.RoleWrapper;
 import org.wso2.carbon.user.mgt.common.UIPermissionNode;
 
-import javax.ws.rs.DELETE;
+import javax.ws.rs.*;
-import javax.ws.rs.GET;
-import javax.ws.rs.POST;
-import javax.ws.rs.PUT;
-import javax.ws.rs.Path;
-import javax.ws.rs.PathParam;
-import javax.ws.rs.Produces;
-import javax.ws.rs.QueryParam;
 import javax.ws.rs.core.MediaType;
 import javax.ws.rs.core.Response;
 import java.util.List;
 
-/**
+@Path("/roles")
- *
- */
 @Api(value = "Role", description = "Role management related operations can be found here.")
 public interface Role {
 
@@ -54,7 +43,7 @@ public interface Role {
             response = String.class)
     @ApiResponses(value = { @ApiResponse(code = 200, message = "List of available roles"),
                             @ApiResponse(code = 500, message = "Error occurred while fetching the role list.") })
-    Response getRoles();
+    Response getAllRoles();
 
     @GET
     @Path("{userStore}")
@@ -69,7 +58,7 @@ public interface Role {
             response = String.class)
     @ApiResponses(value = { @ApiResponse(code = 200, message = "List of available roles"),
                             @ApiResponse(code = 500, message = "Error occurred while fetching the role list.") })
-    Response getRoles(@ApiParam(name = "userStore", value = "Provide the name of the UserStore you wish to get the" +
+    Response getRolesOfUserStore(@ApiParam(name = "userStore", value = "Provide the name of the UserStore you wish to get the" +
                                                             " details from ",
                                  required = true) @PathParam("userStore") String userStore);
 
@@ -203,9 +192,10 @@ public interface Role {
             produces = MediaType.APPLICATION_JSON,
             httpMethod = "GET",
             value = "Getting the Role Count.",
-            response = Integer.class,
+            response = int.class,
             notes = "Get the number of roles in WSO2 EMM.")
     @ApiResponses(value = { @ApiResponse(code = 200, message = "Retrieved the role count."),
                             @ApiResponse(code = 500, message = "Error occurred while retrieving the role count.") })
     Response getRoleCount();
+
 }

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/api/User.java

@@ -18,25 +18,12 @@
 
 package org.wso2.carbon.device.mgt.jaxrs.api;
 
-import io.swagger.annotations.Api;
+import io.swagger.annotations.*;
-import io.swagger.annotations.ApiOperation;
-import io.swagger.annotations.ApiParam;
-import io.swagger.annotations.ApiResponse;
-import io.swagger.annotations.ApiResponses;
 import org.apache.axis2.databinding.types.soapencoding.Integer;
-import org.wso2.carbon.device.mgt.jaxrs.api.util.ResponsePayload;
 import org.wso2.carbon.device.mgt.jaxrs.beans.UserCredentialWrapper;
 import org.wso2.carbon.device.mgt.jaxrs.beans.UserWrapper;
 
-import javax.ws.rs.Consumes;
+import javax.ws.rs.*;
-import javax.ws.rs.DELETE;
-import javax.ws.rs.GET;
-import javax.ws.rs.POST;
-import javax.ws.rs.PUT;
-import javax.ws.rs.Path;
-import javax.ws.rs.PathParam;
-import javax.ws.rs.Produces;
-import javax.ws.rs.QueryParam;
 import javax.ws.rs.core.MediaType;
 import javax.ws.rs.core.Response;
 import java.util.List;
@@ -44,6 +31,7 @@ import java.util.List;
 /**
  * This represents the JAX-RS services of User related functionality.
  */
+@Path("/users")
 @Api(value = "User", description = "User management related operations can be found here.")
 public interface User {
 
@@ -138,7 +126,7 @@ public interface User {
             @ApiResponse(code = 400, message = "User by username: 'username' does not exist for role retrieval"),
             @ApiResponse(code = 500, message = "Exception in trying to retrieve roles for user by username: 'username'")
             })
-    Response getRoles(@ApiParam(name = "username", value = "Provide the user name of the user you wish to get"
+    Response getRolesOfUser(@ApiParam(name = "username", value = "Provide the user name of the user you wish to get"
                             + " the role details", required = true) @QueryParam("username") String username);
 
     @GET
@@ -253,7 +241,7 @@ public interface User {
             httpMethod = "GET",
             value = "Getting the User Count",
             notes = "Get the number of users in WSO2 EMM",
-            response = Integer.class)
+            response = int.class)
     @ApiResponses(value = {
             @ApiResponse(code = 200, message = "OK"),
             @ApiResponse(code = 500, message = "Error occurred while retrieving the list of users that exist"
@@ -264,7 +252,7 @@ public interface User {
     @PUT
     @Path("{roleName}/users")
     @Produces({MediaType.APPLICATION_JSON})
-    Response updateRoles(@PathParam("username") String username, List<String> userList);
+    Response updateRoles(@PathParam("roleName") String roleName, List<String> userList);
 
     @POST
     @Path("change-password")

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/api/impl/AuthenticationImpl.java

@@ -1,36 +0,0 @@
-/*
- * Copyright (c) 2016, WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
- *
- * WSO2 Inc. licenses this file to you under the Apache License,
- * Version 2.0 (the "License"); you may not use this file except
- * in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied. See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-package org.wso2.carbon.device.mgt.jaxrs.api.impl;
-
-import org.apache.commons.logging.Log;
-import org.apache.commons.logging.LogFactory;
-
-import javax.ws.rs.Consumes;
-import javax.ws.rs.Produces;
-
-/**
- * Authentication related REST-API implementation.
- */
-@Produces({ "application/json", "application/xml" })
-@Consumes({ "application/json", "application/xml" })
-public class AuthenticationImpl {
-
-    private static Log log = LogFactory.getLog(AuthenticationImpl.class);
-}
-

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/api/impl/DeviceImpl.java

@@ -142,7 +142,7 @@ public class DeviceImpl implements Device{
      */
     @GET
     @Path("user/{user}")
-    public Response getDevice(@PathParam("user") String user) {
+    public Response getDeviceOfUser(@PathParam("user") String user) {
         List<org.wso2.carbon.device.mgt.common.Device> devices;
         try {
             devices = DeviceMgtAPIUtils.getDeviceManagementService().getDevicesOfUser(user);
@@ -165,7 +165,7 @@ public class DeviceImpl implements Device{
      */
     @GET
     @Path("user/{user}/count")
-    public Response getDeviceCount(@PathParam("user") String user) {
+    public Response getDeviceCountOfUser(@PathParam("user") String user) {
         try {
             Integer count = DeviceMgtAPIUtils.getDeviceManagementService().getDeviceCount(user);
             return Response.status(Response.Status.OK).entity(count).build();

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/api/impl/DeviceSearchImpl.java

@@ -38,7 +38,7 @@ public class DeviceSearchImpl implements DeviceSearch {
     private static Log log = LogFactory.getLog(DeviceSearchImpl.class);
 
     @GET
-    public Response getDeviceInfo(SearchContext searchContext) {
+    public Response getFilteredDeviceInfo(SearchContext searchContext) {
         SearchManagerService searchManagerService;
         List<DeviceWrapper> devices;
         try {

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/api/impl/OperationImpl.java

@@ -103,7 +103,7 @@ public class OperationImpl implements org.wso2.carbon.device.mgt.jaxrs.api.Opera
     @Override
     @GET
     @Path("{type}/{id}")
-    public Response getDeviceOperations(@PathParam("type") String type, @PathParam("id") String id) {
+    public Response getAllDeviceOperations(@PathParam("type") String type, @PathParam("id") String id) {
         List<? extends org.wso2.carbon.device.mgt.common.operation.mgt.Operation> operations;
         DeviceManagementProviderService dmService;
         DeviceIdentifier deviceIdentifier = new DeviceIdentifier();

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/api/impl/RoleImpl.java

@@ -65,7 +65,7 @@ public class RoleImpl implements org.wso2.carbon.device.mgt.jaxrs.api.Role {
     @Override
     @GET
     @Produces({MediaType.APPLICATION_JSON})
-    public Response getRoles() {
+    public Response getAllRoles() {
         List<String> filteredRoles;
         try {
             filteredRoles = getRolesFromUserStore();
@@ -89,7 +89,7 @@ public class RoleImpl implements org.wso2.carbon.device.mgt.jaxrs.api.Role {
     @GET
     @Path("{userStore}")
     @Produces({MediaType.APPLICATION_JSON})
-    public Response getRoles(@PathParam("userStore") String userStore) {
+    public Response getRolesOfUserStore(@PathParam("userStore") String userStore) {
         String[] roles;
         try {
             AbstractUserStoreManager abstractUserStoreManager =

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/api/impl/UserImpl.java

@@ -371,7 +371,7 @@ public class UserImpl implements org.wso2.carbon.device.mgt.jaxrs.api.User {
     @GET
     @Path("roles")
     @Produces({MediaType.APPLICATION_JSON})
-    public Response getRoles(@QueryParam("username") String username) {
+    public Response getRolesOfUser(@QueryParam("username") String username) {
         ResponsePayload responsePayload = new ResponsePayload();
         try {
             UserStoreManager userStoreManager = DeviceMgtAPIUtils.getUserStoreManager();
@@ -716,7 +716,7 @@ public class UserImpl implements org.wso2.carbon.device.mgt.jaxrs.api.User {
     @PUT
     @Path("{roleName}/users")
     @Produces({MediaType.APPLICATION_JSON})
-    public Response updateRoles(@PathParam("username") String username, List<String> userList) {
+    public Response updateRoles(@PathParam("roleName") String username, List<String> userList) {
         try {
             final UserStoreManager userStoreManager = DeviceMgtAPIUtils.getUserStoreManager();
             if (log.isDebugEnabled()) {

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/beans/ApplicationWrapper.java

@@ -21,6 +21,7 @@ package org.wso2.carbon.device.mgt.jaxrs.beans;
 import io.swagger.annotations.ApiModel;
 import io.swagger.annotations.ApiModelProperty;
 import org.wso2.carbon.device.mgt.common.DeviceIdentifier;
+
 import java.util.List;
 
 
@@ -28,13 +29,14 @@ import java.util.List;
         "role or devices the application is associated with.")
 public class ApplicationWrapper {
 
-    @ApiModelProperty(name = "userNameList", value = "List of user names.", required = true )
+    @ApiModelProperty(name = "userNameList", value = "List of user names.", required = true)
     private List<String> userNameList;
-    @ApiModelProperty(name = "roleNameList", value = "List of role names.", required = true )
+    @ApiModelProperty(name = "roleNameList", value = "List of role names.", required = true)
     private List<String> roleNameList;
-    @ApiModelProperty(name = "deviceIdentifiers", value = "List of device identifiers.", required = true )
+    @ApiModelProperty(name = "deviceIdentifiers", value = "List of device identifiers.", required = true,
+            dataType = "List[org.wso2.carbon.device.mgt.common.DeviceIdentifier]")
     private List<DeviceIdentifier> deviceIdentifiers;
-    @ApiModelProperty(name = "application", value = "Details of the mobile application.", required = true )
+    @ApiModelProperty(name = "application", value = "Details of the mobile application.", required = true)
     private MobileApp application;
 
     public MobileApp getApplication() {
@@ -44,6 +46,7 @@ public class ApplicationWrapper {
     public void setApplication(MobileApp application) {
         this.application = application;
     }
+
     public List<String> getUserNameList() {
         return userNameList;
     }

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/beans/MobileApp.java

@@ -27,23 +27,23 @@ import java.util.Properties;
  * This class represents the generic mobile AuthenticationImpl information
  * which is used by AppM.
  */
-@ApiModel(value = "ApplicationWrapper", description = "Details of a mobile application.")
+@ApiModel(value = "MobileApp", description = "Details of a mobile application.")
 public class MobileApp {
 
-    @ApiModelProperty(name = "id", value = "Id of the app used internally.", required = true )
+    @ApiModelProperty(name = "id", value = "Id of the app used internally.", required = true)
     private String id;
-    @ApiModelProperty(name = "name", value = "The name of the application.", required = true )
+    @ApiModelProperty(name = "name", value = "The name of the application.", required = true)
     private String name;
     @ApiModelProperty(name = "type", value = "The type of the application. The following types of applications are " +
-                                             "supported: enterprise, public and webapp..", required = true )
+            "supported: enterprise, public and webapp..", required = true)
     private MobileAppTypes type;
-    @ApiModelProperty(name = "platform", value = "Platform the app can be installed on  .", required = true )
+    @ApiModelProperty(name = "platform", value = "Platform the app can be installed on  .", required = true)
     private String platform;
-    @ApiModelProperty(name = "version", value = "Version of the application.", required = true )
+    @ApiModelProperty(name = "version", value = "Version of the application.", required = true)
     private String version;
-    @ApiModelProperty(name = "identifier", value = "The package name of the application.", required = true )
+    @ApiModelProperty(name = "identifier", value = "The package name of the application.", required = true)
     private String identifier;
-    @ApiModelProperty(name = "iconImage", value = "Link to the icon of the app.", required = true )
+    @ApiModelProperty(name = "iconImage", value = "Link to the icon of the app.", required = true)
     private String iconImage;
     @ApiModelProperty(name = "packageName", value = "Define the exact name of the application package. You can use one " +
             "of the following methods to get the package name.\n" +
@@ -57,12 +57,12 @@ public class MobileApp {
             " play store. \n" +
             "Once the application is successfully installed go to the Tasks " +
             "tab and you will see the package name under the respective " +
-                                                    "application..", required = true )
+            "application..", required = true)
     private String packageName;
-    @ApiModelProperty(name = "appIdentifier", value = "The package name of the application.", required = true )
+    @ApiModelProperty(name = "appIdentifier", value = "The package name of the application.", required = true)
     private String appIdentifier;
     private String location;
-    @ApiModelProperty(name = "properties", value = "List of meta data.", required = true )
+    @ApiModelProperty(name = "properties", value = "List of meta data.", required = true)
     private Properties properties;
 
     public MobileAppTypes getType() {

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/beans/Profile.java

@@ -18,11 +18,10 @@
 
 package org.wso2.carbon.device.mgt.jaxrs.beans;
 
-
-
 import io.swagger.annotations.ApiModel;
 import io.swagger.annotations.ApiModelProperty;
 import org.wso2.carbon.device.mgt.core.dto.DeviceType;
+
 import javax.xml.bind.annotation.XmlElement;
 import javax.xml.bind.annotation.XmlRootElement;
 import java.sql.Timestamp;
@@ -118,4 +117,5 @@ public class Profile {
     public void setProfileFeaturesList(List<ProfileFeature> profileFeaturesList) {
         this.profileFeaturesList = profileFeaturesList;
     }
+
 }

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/java/org/wso2/carbon/device/mgt/jaxrs/beans/RoleWrapper.java

@@ -29,10 +29,10 @@ public class RoleWrapper {
     @ApiModelProperty(name = "roleName", value = "The name of the role.", required = true)
     private String roleName;
     @ApiModelProperty(name = "permissions", value = "Lists out all the permissions associated with roles.",
-                      required = true)
+            required = true, dataType = "List[java.lang.String]")
     private String[] permissions;
     @ApiModelProperty(name = "users", value = "The list of users assigned to the selected role.",
-                      required = true)
+            required = true, dataType = "List[java.lang.String]")
     private String[] users;
     @ApiModelProperty(name = "permissionList", value = "This contain the following, " +
             "\n resourcePath\tThe path related to the API.\n " +

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/webapp/WEB-INF/cxf-servlet.xml

@@ -24,145 +24,46 @@
          http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
          http://cxf.apache.org/jaxrs http://cxf.apache.org/schemas/jaxrs.xsd">
 
-    <jaxrs:server id="operationService" address="/operations">
+    <jaxrs:server id="services" address="/">
         <jaxrs:serviceBeans>
             <ref bean="operationServiceBean"/>
-        </jaxrs:serviceBeans>
-        <jaxrs:providers>
-            <ref bean="jsonProvider"/>
-            <ref bean="errorHandler"/>
-        </jaxrs:providers>
-    </jaxrs:server>
-    <jaxrs:server id="featureService" address="/features">
-        <jaxrs:serviceBeans>
             <ref bean="featureServiceBean"/>
-        </jaxrs:serviceBeans>
-        <jaxrs:providers>
-            <ref bean="jsonProvider"/>
-            <ref bean="errorHandler"/>
-        </jaxrs:providers>
-    </jaxrs:server>
-    <jaxrs:server id="deviceService" address="/devices">
-        <jaxrs:serviceBeans>
             <ref bean="deviceServiceBean"/>
-        </jaxrs:serviceBeans>
-        <jaxrs:providers>
-            <ref bean="jsonProvider"/>
-            <ref bean="errorHandler"/>
-        </jaxrs:providers>
-    </jaxrs:server>
-    <jaxrs:server id="deviceGroupService" address="/groups">
-        <jaxrs:serviceBeans>
             <ref bean="groupServiceBean"/>
-        </jaxrs:serviceBeans>
-        <jaxrs:providers>
-            <ref bean="jsonProvider"/>
-            <ref bean="errorHandler"/>
-        </jaxrs:providers>
-    </jaxrs:server>
-    <jaxrs:server id="userService" address="/users">
-        <jaxrs:serviceBeans>
             <ref bean="userServiceBean"/>
-        </jaxrs:serviceBeans>
-        <jaxrs:providers>
-            <ref bean="jsonProvider"/>
-            <ref bean="errorHandler"/>
-        </jaxrs:providers>
-    </jaxrs:server>
-    <jaxrs:server id="roleService" address="/roles">
-        <jaxrs:serviceBeans>
             <ref bean="roleServiceBean"/>
-        </jaxrs:serviceBeans>
-        <jaxrs:providers>
-            <ref bean="jsonProvider"/>
-            <ref bean="errorHandler"/>
-        </jaxrs:providers>
-    </jaxrs:server>
-    <jaxrs:server id="policyService" address="/policies">
-        <jaxrs:serviceBeans>
             <ref bean="policyServiceBean"/>
-        </jaxrs:serviceBeans>
-        <jaxrs:providers>
-            <ref bean="jsonProvider"/>
-            <ref bean="errorHandler"/>
-        </jaxrs:providers>
-    </jaxrs:server>
-    <jaxrs:server id="profileService" address="/profiles">
-        <jaxrs:serviceBeans>
             <ref bean="profileServiceBean"/>
-        </jaxrs:serviceBeans>
-        <jaxrs:providers>
-            <ref bean="jsonProvider"/>
-            <ref bean="errorHandler"/>
-        </jaxrs:providers>
-    </jaxrs:server>
-    <jaxrs:server id="configurationService" address="/configuration">
-        <jaxrs:serviceBeans>
             <ref bean="configurationServiceBean"/>
-        </jaxrs:serviceBeans>
-        <jaxrs:providers>
-            <ref bean="jsonProvider"/>
-            <ref bean="errorHandler"/>
-        </jaxrs:providers>
-    </jaxrs:server>
-    <jaxrs:server id="licenseService" address="/license">
-        <jaxrs:serviceBeans>
             <ref bean="licenseServiceBean"/>
-        </jaxrs:serviceBeans>
-        <jaxrs:providers>
-            <ref bean="jsonProvider"/>
-            <ref bean="errorHandler"/>
-        </jaxrs:providers>
-    </jaxrs:server>
-    <jaxrs:server id="certificateService" address="/certificates">
-        <jaxrs:serviceBeans>
             <ref bean="certificateServiceBean"/>
-        </jaxrs:serviceBeans>
-        <jaxrs:providers>
-            <ref bean="jsonProvider"/>
-            <ref bean="errorHandler"/>
-        </jaxrs:providers>
-    </jaxrs:server>
-    <jaxrs:server id="notificationService" address="/notifications">
-        <jaxrs:serviceBeans>
             <ref bean="notificationServiceBean"/>
-        </jaxrs:serviceBeans>
-        <jaxrs:providers>
-            <ref bean="jsonProvider"/>
-            <ref bean="errorHandler"/>
-        </jaxrs:providers>
-    </jaxrs:server>
-
-    <jaxrs:server id="informationService" address="/information">
-        <jaxrs:serviceBeans>
             <ref bean="informationServiceBean"/>
+            <ref bean="searchingServiceBean"/>
+            <ref bean="swaggerResource"/>
         </jaxrs:serviceBeans>
         <jaxrs:providers>
             <ref bean="jsonProvider"/>
             <ref bean="errorHandler"/>
+            <ref bean="swaggerWriter"/>
         </jaxrs:providers>
     </jaxrs:server>
 
-    <jaxrs:server id="searchService" address="/search">
+    <bean id="swaggerWriter" class="io.swagger.jaxrs.listing.SwaggerSerializers" />
-        <jaxrs:serviceBeans>
+    <bean id="swaggerResource" class="io.swagger.jaxrs.listing.ApiListingResource" />
-            <ref bean="searchingServiceBean"/>
+
-        </jaxrs:serviceBeans>
+    <bean id="swaggerConfig" class="io.swagger.jaxrs.config.BeanConfig">
-        <jaxrs:providers>
+        <property name="resourcePackage" value="org.wso2.carbon.device.mgt.jaxrs"/>
-            <ref bean="jsonProvider"/>
+        <property name="version" value="1.0.0"/>
-            <ref bean="errorHandler"/>
+        <property name="host" value="localhost:9443"/>
-        </jaxrs:providers>
+        <property name="basePath" value="/"/>
-    </jaxrs:server>
+        <property name="title" value="Device Management Admin Service API Definitions"/>
-    <!--
+        <property name="contact" value="dev@wso2.org"/>
-    <jaxrs:server id="authenticationService" address="/authentication">
+        <property name="license" value="Apache 2.0"/>
-        <jaxrs:serviceBeans>
+        <property name="licenseUrl" value="http://www.apache.org/licenses/LICENSE-2.0.html"/>
-            <ref bean="authenticationServiceBean"/>
+        <property name="scan" value="true"/>
-        </jaxrs:serviceBeans>
+    </bean>
-        <jaxrs:providers>
+
-            <ref bean="jsonProvider"/>
-            <ref bean="errorHandler"/>
-        </jaxrs:providers>
-    </jaxrs:server>
--->
     <bean id="operationServiceBean" class="org.wso2.carbon.device.mgt.jaxrs.api.impl.OperationImpl"/>
     <bean id="deviceServiceBean" class="org.wso2.carbon.device.mgt.jaxrs.api.impl.DeviceImpl"/>
     <bean id="groupServiceBean" class="org.wso2.carbon.device.mgt.jaxrs.api.impl.GroupImpl"/>
@@ -175,9 +76,6 @@
     <bean id="certificateServiceBean" class="org.wso2.carbon.device.mgt.jaxrs.api.impl.CertificateImpl"/>
     <bean id="informationServiceBean" class="org.wso2.carbon.device.mgt.jaxrs.api.impl.DeviceInformationImpl"/>
     <bean id="searchingServiceBean" class="org.wso2.carbon.device.mgt.jaxrs.api.impl.DeviceSearchImpl"/>
-    <!--
-    <bean id="authenticationServiceBean" class="AuthenticationImpl"/>
-    -->
     <bean id="policyServiceBean" class="org.wso2.carbon.device.mgt.jaxrs.api.impl.PolicyImpl"/>
     <bean id="profileServiceBean" class="org.wso2.carbon.device.mgt.jaxrs.api.impl.ProfileImpl"/>
     <bean id="jsonProvider" class="org.wso2.carbon.device.mgt.jaxrs.common.GsonMessageBodyHandler"/>

components/device-mgt/org.wso2.carbon.device.mgt.api/src/main/webapp/WEB-INF/web.xml

@@ -25,6 +25,16 @@
         <servlet-class>
             org.apache.cxf.transport.servlet.CXFServlet
         </servlet-class>
+        <!--<init-param>-->
+            <!--<param-name>swagger.api.basepath</param-name>-->
+            <!--<param-value>http://localhost:9763/test</param-value>-->
+        <!--</init-param>-->
+
+        <!-- configure a security filter -->
+        <init-param>
+            <param-name>swagger.security.filter</param-name>
+            <param-value>ApiAuthorizationFilterImpl</param-value>
+        </init-param>
         <load-on-startup>1</load-on-startup>
     </servlet>
     <servlet-mapping>
@@ -41,7 +51,7 @@
     </context-param>
     <context-param>
         <param-name>doAuthentication</param-name>
-        <param-value>true</param-value>
+        <param-value>false</param-value>
     </context-param>
     <!--context-param>
         <param-name>managed-api-enabled</param-name>
@@ -71,4 +81,13 @@
         </user-data-constraint>
     </security-constraint>
 
+    <filter>
+        <filter-name>ApiOriginFilter</filter-name>
+        <filter-class>org.wso2.carbon.device.mgt.jaxrs.ApiOriginFilter</filter-class>
+    </filter>
+    <filter-mapping>
+        <filter-name>ApiOriginFilter</filter-name>
+        <url-pattern>/*</url-pattern>
+    </filter-mapping>
+
 </web-app>

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

@@ -24,7 +24,7 @@ import java.io.Serializable;
 import java.util.List;
 
 @ApiModel(value = "Device", description = "This class carries all information related to a managed device.")
-public class Device implements Serializable{
+public class Device implements Serializable {
 
     private static final long serialVersionUID = 1998101711L;
 
@@ -52,7 +52,8 @@ public class Device implements Serializable{
     private List<Feature> features;
     private List<Device.Property> properties;
 
-    public Device() {}
+    public Device() {
+    }
 
     public Device(String name, String type, String description, String deviceId, EnrolmentInfo enrolmentInfo,
                   List<Feature> features, List<Property> properties) {

pom.xml

@@ -1456,10 +1456,23 @@
                 <artifactId>swagger-annotations</artifactId>
                 <version>${swagger.version}</version>
             </dependency>
+            <dependency>
+                <groupId>io.swagger</groupId>
+                <artifactId>swagger-core</artifactId>
+                <version>${swagger.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.swagger</groupId>
+                <artifactId>swagger-jaxrs</artifactId>
+                <version>${swagger.version}</version>
+            </dependency>
+
+            <dependency>
+                <groupId>javax.servlet</groupId>
+                <artifactId>servlet-api</artifactId>
+                <version>${servlet-api.version}</version>
+            </dependency>
         </dependencies>
-
-
-
     </dependencyManagement>
 
     <scm>
@@ -1823,6 +1836,7 @@
         <nimbus.orbit.version.range>[2.26.1, 3.0.0)</nimbus.orbit.version.range>
 
         <swagger.version>1.5.8</swagger.version>
+        <servlet-api.version>2.5</servlet-api.version>
     </properties>
 
 </project>