Fix for bugs 446 and 456
[controller.git] / opendaylight / northbound / networkconfiguration / neutron / src / main / java / org / opendaylight / controller / networkconfig / neutron / northbound / NeutronSubnetsNorthbound.java
index 699aee9fc3a7d3503e7b1a6d464926da1aefd24f..224fcb5f01ceaaaa662d2c9bbe0655892da463a2 100644 (file)
-/*\r
- * Copyright IBM Corporation, 2013.  All rights reserved.\r
- *\r
- * This program and the accompanying materials are made available under the\r
- * terms of the Eclipse Public License v1.0 which accompanies this distribution,\r
- * and is available at http://www.eclipse.org/legal/epl-v10.html\r
- */\r
-\r
-package org.opendaylight.controller.networkconfig.neutron.northbound;\r
-\r
-\r
-import java.util.ArrayList;\r
-import java.util.HashMap;\r
-import java.util.Iterator;\r
-import java.util.List;\r
-import javax.ws.rs.Consumes;\r
-import javax.ws.rs.DELETE;\r
-import javax.ws.rs.GET;\r
-import javax.ws.rs.POST;\r
-import javax.ws.rs.PUT;\r
-import javax.ws.rs.Path;\r
-import javax.ws.rs.PathParam;\r
-import javax.ws.rs.Produces;\r
-import javax.ws.rs.QueryParam;\r
-import javax.ws.rs.core.MediaType;\r
-import javax.ws.rs.core.Response;\r
-\r
-import org.codehaus.enunciate.jaxrs.ResponseCode;\r
-import org.codehaus.enunciate.jaxrs.StatusCodes;\r
-import org.opendaylight.controller.networkconfig.neutron.INeutronNetworkCRUD;\r
-import org.opendaylight.controller.networkconfig.neutron.INeutronSubnetAware;\r
-import org.opendaylight.controller.networkconfig.neutron.INeutronSubnetCRUD;\r
-import org.opendaylight.controller.networkconfig.neutron.NeutronCRUDInterfaces;\r
-import org.opendaylight.controller.networkconfig.neutron.NeutronSubnet;\r
-import org.opendaylight.controller.northbound.commons.RestMessages;\r
-import org.opendaylight.controller.northbound.commons.exception.InternalServerErrorException;\r
-import org.opendaylight.controller.northbound.commons.exception.ServiceUnavailableException;\r
-import org.opendaylight.controller.sal.utils.ServiceHelper;\r
-\r
-/**\r
- * Open DOVE Northbound REST APIs.<br>\r
- * This class provides REST APIs for managing open DOVE internals related to Subnets\r
- *\r
- * <br>\r
- * <br>\r
- * Authentication scheme : <b>HTTP Basic</b><br>\r
- * Authentication realm : <b>opendaylight</b><br>\r
- * Transport : <b>HTTP and HTTPS</b><br>\r
- * <br>\r
- * HTTPS Authentication is disabled by default. Administrator can enable it in\r
- * tomcat-server.xml after adding a proper keystore / SSL certificate from a\r
- * trusted authority.<br>\r
- * More info :\r
- * http://tomcat.apache.org/tomcat-7.0-doc/ssl-howto.html#Configuration\r
- *\r
- */\r
-\r
-@Path("/subnets")\r
-public class NeutronSubnetsNorthbound {\r
-\r
-    private NeutronSubnet extractFields(NeutronSubnet o, List<String> fields) {\r
-        return o.extractFields(fields);\r
-    }\r
-\r
-\r
-    /**\r
-     * Returns a list of all Subnets */\r
-    @GET\r
-    @Produces({ MediaType.APPLICATION_JSON })\r
-    //@TypeHint(OpenStackSubnets.class)\r
-    @StatusCodes({\r
-            @ResponseCode(code = 200, condition = "Operation successful"),\r
-            @ResponseCode(code = 401, condition = "Unauthorized"),\r
-            @ResponseCode(code = 501, condition = "Not Implemented") })\r
-    public Response listSubnets(\r
-            // return fields\r
-            @QueryParam("fields") List<String> fields,\r
-            // note: openstack isn't clear about filtering on lists, so we aren't handling them\r
-            @QueryParam("id") String queryID,\r
-            @QueryParam("network_id") String queryNetworkID,\r
-            @QueryParam("name") String queryName,\r
-            @QueryParam("ip_version") String queryIPVersion,\r
-            @QueryParam("cidr") String queryCIDR,\r
-            @QueryParam("gateway_ip") String queryGatewayIP,\r
-            @QueryParam("enable_dhcp") String queryEnableDHCP,\r
-            @QueryParam("tenant_id") String queryTenantID,\r
-            // pagination\r
-            @QueryParam("limit") String limit,\r
-            @QueryParam("marker") String marker,\r
-            @QueryParam("page_reverse") String pageReverse\r
-            // sorting not supported\r
-            ) {\r
-        INeutronSubnetCRUD subnetInterface = NeutronCRUDInterfaces.getINeutronSubnetCRUD( this);\r
-        if (subnetInterface == null) {\r
-            throw new ServiceUnavailableException("Subnet CRUD Interface "\r
-                    + RestMessages.SERVICEUNAVAILABLE.toString());\r
-        }\r
-        List<NeutronSubnet> allNetworks = subnetInterface.getAllSubnets();\r
-        List<NeutronSubnet> ans = new ArrayList<NeutronSubnet>();\r
-        Iterator<NeutronSubnet> i = allNetworks.iterator();\r
-        while (i.hasNext()) {\r
-            NeutronSubnet oSS = i.next();\r
-            if ((queryID == null || queryID.equals(oSS.getID())) &&\r
-                    (queryNetworkID == null || queryNetworkID.equals(oSS.getNetworkUUID())) &&\r
-                    (queryName == null || queryName.equals(oSS.getName())) &&\r
-                    (queryIPVersion == null || queryIPVersion.equals(oSS.getIpVersion())) &&\r
-                    (queryCIDR == null || queryCIDR.equals(oSS.getCidr())) &&\r
-                    (queryGatewayIP == null || queryGatewayIP.equals(oSS.getGatewayIP())) &&\r
-                    (queryEnableDHCP == null || queryEnableDHCP.equals(oSS.getEnableDHCP())) &&\r
-                    (queryTenantID == null || queryTenantID.equals(oSS.getTenantID()))) {\r
-                if (fields.size() > 0) {\r
-                    ans.add(extractFields(oSS,fields));\r
-                } else {\r
-                    ans.add(oSS);\r
-                }\r
-            }\r
-        }\r
-        //TODO: apply pagination to results\r
-        return Response.status(200).entity(\r
-                new NeutronSubnetRequest(ans)).build();\r
-    }\r
-\r
-    /**\r
-     * Returns a specific Subnet */\r
-\r
-    @Path("{subnetUUID}")\r
-    @GET\r
-    @Produces({ MediaType.APPLICATION_JSON })\r
-    //@TypeHint(OpenStackSubnets.class)\r
-    @StatusCodes({\r
-            @ResponseCode(code = 200, condition = "Operation successful"),\r
-            @ResponseCode(code = 401, condition = "Unauthorized"),\r
-            @ResponseCode(code = 404, condition = "Not Found"),\r
-            @ResponseCode(code = 501, condition = "Not Implemented") })\r
-    public Response showSubnet(\r
-            @PathParam("subnetUUID") String subnetUUID,\r
-            // return fields\r
-            @QueryParam("fields") List<String> fields) {\r
-        INeutronSubnetCRUD subnetInterface = NeutronCRUDInterfaces.getINeutronSubnetCRUD(this);\r
-        if (subnetInterface == null) {\r
-            throw new ServiceUnavailableException("Subnet CRUD Interface "\r
-                    + RestMessages.SERVICEUNAVAILABLE.toString());\r
-        }\r
-        if (!subnetInterface.subnetExists(subnetUUID)) {\r
-            return Response.status(404).build();\r
-        }\r
-        if (fields.size() > 0) {\r
-            NeutronSubnet ans = subnetInterface.getSubnet(subnetUUID);\r
-            return Response.status(200).entity(\r
-                    new NeutronSubnetRequest(extractFields(ans, fields))).build();\r
-        } else {\r
-            return Response.status(200).entity(\r
-                    new NeutronSubnetRequest(subnetInterface.getSubnet(subnetUUID))).build();\r
-        }\r
-    }\r
-\r
-    /**\r
-     * Creates new Subnets */\r
-\r
-    @POST\r
-    @Produces({ MediaType.APPLICATION_JSON })\r
-    @Consumes({ MediaType.APPLICATION_JSON })\r
-    //@TypeHint(OpenStackSubnets.class)\r
-    @StatusCodes({\r
-            @ResponseCode(code = 201, condition = "Created"),\r
-            @ResponseCode(code = 400, condition = "Bad Request"),\r
-            @ResponseCode(code = 401, condition = "Unauthorized"),\r
-            @ResponseCode(code = 403, condition = "Forbidden"),\r
-            @ResponseCode(code = 404, condition = "Not Found"),\r
-            @ResponseCode(code = 409, condition = "Conflict"),\r
-            @ResponseCode(code = 501, condition = "Not Implemented") })\r
-    public Response createSubnets(final NeutronSubnetRequest input) {\r
-        INeutronSubnetCRUD subnetInterface = NeutronCRUDInterfaces.getINeutronSubnetCRUD(this);\r
-        if (subnetInterface == null) {\r
-            throw new ServiceUnavailableException("Subnet CRUD Interface "\r
-                    + RestMessages.SERVICEUNAVAILABLE.toString());\r
-        }\r
-        INeutronNetworkCRUD networkInterface = NeutronCRUDInterfaces.getINeutronNetworkCRUD( this);\r
-        if (networkInterface == null) {\r
-            throw new ServiceUnavailableException("Network CRUD Interface "\r
-                    + RestMessages.SERVICEUNAVAILABLE.toString());\r
-        }\r
-        if (input.isSingleton()) {\r
-            NeutronSubnet singleton = input.getSingleton();\r
-\r
-            /*\r
-             *  Verify that the subnet doesn't already exist (Issue: is a deeper check necessary?)\r
-             *  the specified network exists, the subnet has a valid network address,\r
-             *  and that the gateway IP doesn't overlap with the allocation pools\r
-             *  *then* add the subnet to the cache\r
-             */\r
-            if (subnetInterface.subnetExists(singleton.getID())) {\r
-                return Response.status(400).build();\r
-            }\r
-            if (!networkInterface.networkExists(singleton.getNetworkUUID())) {\r
-                return Response.status(404).build();\r
-            }\r
-            if (!singleton.isValidCIDR()) {\r
-                return Response.status(400).build();\r
-            }\r
-            if (!singleton.initDefaults()) {\r
-                throw new InternalServerErrorException("subnet object could not be initialized properly");\r
-            }\r
-            if (singleton.gatewayIP_Pool_overlap()) {\r
-                return Response.status(409).build();\r
-            }\r
-            Object[] instances = ServiceHelper.getGlobalInstances(INeutronSubnetAware.class, this, null);\r
-            if (instances != null) {\r
-                for (Object instance : instances) {\r
-                    INeutronSubnetAware service = (INeutronSubnetAware) instance;\r
-                    int status = service.canCreateSubnet(singleton);\r
-                    if (status < 200 || status > 299) {\r
-                        return Response.status(status).build();\r
-                    }\r
-                }\r
-            }\r
-            subnetInterface.addSubnet(singleton);\r
-            if (instances != null) {\r
-                for (Object instance : instances) {\r
-                    INeutronSubnetAware service = (INeutronSubnetAware) instance;\r
-                    service.neutronSubnetCreated(singleton);\r
-                }\r
-            }\r
-        } else {\r
-            List<NeutronSubnet> bulk = input.getBulk();\r
-            Iterator<NeutronSubnet> i = bulk.iterator();\r
-            HashMap<String, NeutronSubnet> testMap = new HashMap<String, NeutronSubnet>();\r
-            Object[] instances = ServiceHelper.getGlobalInstances(INeutronSubnetAware.class, this, null);\r
-            while (i.hasNext()) {\r
-                NeutronSubnet test = i.next();\r
-\r
-                /*\r
-                 *  Verify that the subnet doesn't already exist (Issue: is a deeper check necessary?)\r
-                 *  the specified network exists, the subnet has a valid network address,\r
-                 *  and that the gateway IP doesn't overlap with the allocation pools,\r
-                 *  and that the bulk request doesn't already contain a subnet with this id\r
-                 */\r
-\r
-                if (!test.initDefaults()) {\r
-                    throw new InternalServerErrorException("subnet object could not be initialized properly");\r
-                }\r
-                if (subnetInterface.subnetExists(test.getID())) {\r
-                    return Response.status(400).build();\r
-                }\r
-                if (testMap.containsKey(test.getID())) {\r
-                    return Response.status(400).build();\r
-                }\r
-                testMap.put(test.getID(), test);\r
-                if (!networkInterface.networkExists(test.getNetworkUUID())) {\r
-                    return Response.status(404).build();\r
-                }\r
-                if (!test.isValidCIDR()) {\r
-                    return Response.status(400).build();\r
-                }\r
-                if (test.gatewayIP_Pool_overlap()) {\r
-                    return Response.status(409).build();\r
-                }\r
-                if (instances != null) {\r
-                    for (Object instance : instances) {\r
-                        INeutronSubnetAware service = (INeutronSubnetAware) instance;\r
-                        int status = service.canCreateSubnet(test);\r
-                        if (status < 200 || status > 299) {\r
-                            return Response.status(status).build();\r
-                        }\r
-                    }\r
-                }\r
-            }\r
-\r
-            /*\r
-             * now, each element of the bulk request can be added to the cache\r
-             */\r
-            i = bulk.iterator();\r
-            while (i.hasNext()) {\r
-                NeutronSubnet test = i.next();\r
-                subnetInterface.addSubnet(test);\r
-                if (instances != null) {\r
-                    for (Object instance : instances) {\r
-                        INeutronSubnetAware service = (INeutronSubnetAware) instance;\r
-                        service.neutronSubnetCreated(test);\r
-                    }\r
-                }\r
-            }\r
-        }\r
-        return Response.status(201).entity(input).build();\r
-    }\r
-\r
-    /**\r
-     * Updates a Subnet */\r
-\r
-    @Path("{subnetUUID}")\r
-    @PUT\r
-    @Produces({ MediaType.APPLICATION_JSON })\r
-    @Consumes({ MediaType.APPLICATION_JSON })\r
-    //@TypeHint(OpenStackSubnets.class)\r
-    @StatusCodes({\r
-            @ResponseCode(code = 200, condition = "Operation successful"),\r
-            @ResponseCode(code = 400, condition = "Bad Request"),\r
-            @ResponseCode(code = 401, condition = "Unauthorized"),\r
-            @ResponseCode(code = 403, condition = "Forbidden"),\r
-            @ResponseCode(code = 404, condition = "Not Found"),\r
-            @ResponseCode(code = 501, condition = "Not Implemented") })\r
-    public Response updateSubnet(\r
-            @PathParam("subnetUUID") String subnetUUID, final NeutronSubnetRequest input\r
-            ) {\r
-        INeutronSubnetCRUD subnetInterface = NeutronCRUDInterfaces.getINeutronSubnetCRUD( this);\r
-        if (subnetInterface == null) {\r
-            throw new ServiceUnavailableException("Subnet CRUD Interface "\r
-                    + RestMessages.SERVICEUNAVAILABLE.toString());\r
-        }\r
-\r
-        /*\r
-         * verify the subnet exists and there is only one delta provided\r
-         */\r
-        if (!subnetInterface.subnetExists(subnetUUID)) {\r
-            return Response.status(404).build();\r
-        }\r
-        if (!input.isSingleton()) {\r
-            return Response.status(400).build();\r
-        }\r
-        NeutronSubnet delta = input.getSingleton();\r
-        NeutronSubnet original = subnetInterface.getSubnet(subnetUUID);\r
-\r
-        /*\r
-         * updates restricted by Neutron\r
-         */\r
-        if (delta.getID() != null || delta.getTenantID() != null ||\r
-                delta.getIpVersion() != null || delta.getCidr() != null ||\r
-                delta.getAllocationPools() != null) {\r
-            return Response.status(400).build();\r
-        }\r
-\r
-        Object[] instances = ServiceHelper.getGlobalInstances(INeutronSubnetAware.class, this, null);\r
-        if (instances != null) {\r
-            for (Object instance : instances) {\r
-                INeutronSubnetAware service = (INeutronSubnetAware) instance;\r
-                int status = service.canUpdateSubnet(delta, original);\r
-                if (status < 200 || status > 299) {\r
-                    return Response.status(status).build();\r
-                }\r
-            }\r
-        }\r
-\r
-        /*\r
-         * update the object and return it\r
-         */\r
-        subnetInterface.updateSubnet(subnetUUID, delta);\r
-        NeutronSubnet updatedSubnet = subnetInterface.getSubnet(subnetUUID);\r
-        if (instances != null) {\r
-            for (Object instance : instances) {\r
-                INeutronSubnetAware service = (INeutronSubnetAware) instance;\r
-                service.neutronSubnetUpdated(updatedSubnet);\r
-            }\r
-        }\r
-        return Response.status(200).entity(\r
-                new NeutronSubnetRequest(subnetInterface.getSubnet(subnetUUID))).build();\r
-    }\r
-\r
-    /**\r
-     * Deletes a Subnet */\r
-\r
-    @Path("{subnetUUID}")\r
-    @DELETE\r
-    @StatusCodes({\r
-            @ResponseCode(code = 204, condition = "No Content"),\r
-            @ResponseCode(code = 401, condition = "Unauthorized"),\r
-            @ResponseCode(code = 404, condition = "Not Found"),\r
-            @ResponseCode(code = 409, condition = "Conflict"),\r
-            @ResponseCode(code = 501, condition = "Not Implemented") })\r
-    public Response deleteSubnet(\r
-            @PathParam("subnetUUID") String subnetUUID) {\r
-        INeutronSubnetCRUD subnetInterface = NeutronCRUDInterfaces.getINeutronSubnetCRUD( this);\r
-        if (subnetInterface == null) {\r
-            throw new ServiceUnavailableException("Network CRUD Interface "\r
-                    + RestMessages.SERVICEUNAVAILABLE.toString());\r
-        }\r
-\r
-        /*\r
-         * verify the subnet exists and it isn't currently in use\r
-         */\r
-        if (!subnetInterface.subnetExists(subnetUUID)) {\r
-            return Response.status(404).build();\r
-        }\r
-        if (subnetInterface.subnetInUse(subnetUUID)) {\r
-            return Response.status(409).build();\r
-        }\r
-        NeutronSubnet singleton = subnetInterface.getSubnet(subnetUUID);\r
-        Object[] instances = ServiceHelper.getGlobalInstances(INeutronSubnetAware.class, this, null);\r
-        if (instances != null) {\r
-            for (Object instance : instances) {\r
-                INeutronSubnetAware service = (INeutronSubnetAware) instance;\r
-                int status = service.canDeleteSubnet(singleton);\r
-                if (status < 200 || status > 299) {\r
-                    return Response.status(status).build();\r
-                }\r
-            }\r
-        }\r
-\r
-        /*\r
-         * remove it and return 204 status\r
-         */\r
-        subnetInterface.removeSubnet(subnetUUID);\r
-        if (instances != null) {\r
-            for (Object instance : instances) {\r
-                INeutronSubnetAware service = (INeutronSubnetAware) instance;\r
-                service.neutronSubnetDeleted(singleton);\r
-            }\r
-        }\r
-        return Response.status(204).build();\r
-    }\r
-}\r
+/*
+ * Copyright IBM Corporation, 2013.  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,
+ * and is available at http://www.eclipse.org/legal/epl-v10.html
+ */
+
+package org.opendaylight.controller.networkconfig.neutron.northbound;
+
+
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.Iterator;
+import java.util.List;
+import javax.ws.rs.Consumes;
+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 org.codehaus.enunciate.jaxrs.ResponseCode;
+import org.codehaus.enunciate.jaxrs.StatusCodes;
+import org.opendaylight.controller.networkconfig.neutron.INeutronNetworkCRUD;
+import org.opendaylight.controller.networkconfig.neutron.INeutronSubnetAware;
+import org.opendaylight.controller.networkconfig.neutron.INeutronSubnetCRUD;
+import org.opendaylight.controller.networkconfig.neutron.NeutronCRUDInterfaces;
+import org.opendaylight.controller.networkconfig.neutron.NeutronSubnet;
+import org.opendaylight.controller.northbound.commons.RestMessages;
+import org.opendaylight.controller.northbound.commons.exception.BadRequestException;
+import org.opendaylight.controller.northbound.commons.exception.ResourceConflictException;
+import org.opendaylight.controller.northbound.commons.exception.ResourceNotFoundException;
+import org.opendaylight.controller.northbound.commons.exception.InternalServerErrorException;
+import org.opendaylight.controller.northbound.commons.exception.ServiceUnavailableException;
+import org.opendaylight.controller.sal.utils.ServiceHelper;
+
+/**
+ * Neutron Northbound REST APIs for Subnets.<br>
+ * This class provides REST APIs for managing neutron Subnets
+ *
+ * <br>
+ * <br>
+ * Authentication scheme : <b>HTTP Basic</b><br>
+ * Authentication realm : <b>opendaylight</b><br>
+ * Transport : <b>HTTP and HTTPS</b><br>
+ * <br>
+ * HTTPS Authentication is disabled by default. Administrator can enable it in
+ * tomcat-server.xml after adding a proper keystore / SSL certificate from a
+ * trusted authority.<br>
+ * More info :
+ * http://tomcat.apache.org/tomcat-7.0-doc/ssl-howto.html#Configuration
+ *
+ */
+
+@Path("/subnets")
+public class NeutronSubnetsNorthbound {
+
+    private NeutronSubnet extractFields(NeutronSubnet o, List<String> fields) {
+        return o.extractFields(fields);
+    }
+
+
+    /**
+     * Returns a list of all Subnets */
+    @GET
+    @Produces({ MediaType.APPLICATION_JSON })
+    //@TypeHint(OpenStackSubnets.class)
+    @StatusCodes({
+            @ResponseCode(code = 200, condition = "Operation successful"),
+            @ResponseCode(code = 401, condition = "Unauthorized"),
+            @ResponseCode(code = 501, condition = "Not Implemented") })
+    public Response listSubnets(
+            // return fields
+            @QueryParam("fields") List<String> fields,
+            // note: openstack isn't clear about filtering on lists, so we aren't handling them
+            @QueryParam("id") String queryID,
+            @QueryParam("network_id") String queryNetworkID,
+            @QueryParam("name") String queryName,
+            @QueryParam("ip_version") String queryIPVersion,
+            @QueryParam("cidr") String queryCIDR,
+            @QueryParam("gateway_ip") String queryGatewayIP,
+            @QueryParam("enable_dhcp") String queryEnableDHCP,
+            @QueryParam("tenant_id") String queryTenantID,
+            // pagination
+            @QueryParam("limit") String limit,
+            @QueryParam("marker") String marker,
+            @QueryParam("page_reverse") String pageReverse
+            // sorting not supported
+            ) {
+        INeutronSubnetCRUD subnetInterface = NeutronCRUDInterfaces.getINeutronSubnetCRUD( this);
+        if (subnetInterface == null) {
+            throw new ServiceUnavailableException("Subnet CRUD Interface "
+                    + RestMessages.SERVICEUNAVAILABLE.toString());
+        }
+        List<NeutronSubnet> allNetworks = subnetInterface.getAllSubnets();
+        List<NeutronSubnet> ans = new ArrayList<NeutronSubnet>();
+        Iterator<NeutronSubnet> i = allNetworks.iterator();
+        while (i.hasNext()) {
+            NeutronSubnet oSS = i.next();
+            if ((queryID == null || queryID.equals(oSS.getID())) &&
+                    (queryNetworkID == null || queryNetworkID.equals(oSS.getNetworkUUID())) &&
+                    (queryName == null || queryName.equals(oSS.getName())) &&
+                    (queryIPVersion == null || queryIPVersion.equals(oSS.getIpVersion())) &&
+                    (queryCIDR == null || queryCIDR.equals(oSS.getCidr())) &&
+                    (queryGatewayIP == null || queryGatewayIP.equals(oSS.getGatewayIP())) &&
+                    (queryEnableDHCP == null || queryEnableDHCP.equals(oSS.getEnableDHCP())) &&
+                    (queryTenantID == null || queryTenantID.equals(oSS.getTenantID()))) {
+                if (fields.size() > 0) {
+                    ans.add(extractFields(oSS,fields));
+                } else {
+                    ans.add(oSS);
+                }
+            }
+        }
+        //TODO: apply pagination to results
+        return Response.status(200).entity(
+                new NeutronSubnetRequest(ans)).build();
+    }
+
+    /**
+     * Returns a specific Subnet */
+
+    @Path("{subnetUUID}")
+    @GET
+    @Produces({ MediaType.APPLICATION_JSON })
+    //@TypeHint(OpenStackSubnets.class)
+    @StatusCodes({
+            @ResponseCode(code = 200, condition = "Operation successful"),
+            @ResponseCode(code = 401, condition = "Unauthorized"),
+            @ResponseCode(code = 404, condition = "Not Found"),
+            @ResponseCode(code = 501, condition = "Not Implemented") })
+    public Response showSubnet(
+            @PathParam("subnetUUID") String subnetUUID,
+            // return fields
+            @QueryParam("fields") List<String> fields) {
+        INeutronSubnetCRUD subnetInterface = NeutronCRUDInterfaces.getINeutronSubnetCRUD(this);
+        if (subnetInterface == null) {
+            throw new ServiceUnavailableException("Subnet CRUD Interface "
+                    + RestMessages.SERVICEUNAVAILABLE.toString());
+        }
+        if (!subnetInterface.subnetExists(subnetUUID)) {
+            throw new ResourceNotFoundException("subnet UUID does not exist.");
+        }
+        if (fields.size() > 0) {
+            NeutronSubnet ans = subnetInterface.getSubnet(subnetUUID);
+            return Response.status(200).entity(
+                    new NeutronSubnetRequest(extractFields(ans, fields))).build();
+        } else {
+            return Response.status(200).entity(
+                    new NeutronSubnetRequest(subnetInterface.getSubnet(subnetUUID))).build();
+        }
+    }
+
+    /**
+     * Creates new Subnets */
+
+    @POST
+    @Produces({ MediaType.APPLICATION_JSON })
+    @Consumes({ MediaType.APPLICATION_JSON })
+    //@TypeHint(OpenStackSubnets.class)
+    @StatusCodes({
+            @ResponseCode(code = 201, condition = "Created"),
+            @ResponseCode(code = 400, condition = "Bad Request"),
+            @ResponseCode(code = 401, condition = "Unauthorized"),
+            @ResponseCode(code = 403, condition = "Forbidden"),
+            @ResponseCode(code = 404, condition = "Not Found"),
+            @ResponseCode(code = 409, condition = "Conflict"),
+            @ResponseCode(code = 501, condition = "Not Implemented") })
+    public Response createSubnets(final NeutronSubnetRequest input) {
+        INeutronSubnetCRUD subnetInterface = NeutronCRUDInterfaces.getINeutronSubnetCRUD(this);
+        if (subnetInterface == null) {
+            throw new ServiceUnavailableException("Subnet CRUD Interface "
+                    + RestMessages.SERVICEUNAVAILABLE.toString());
+        }
+        INeutronNetworkCRUD networkInterface = NeutronCRUDInterfaces.getINeutronNetworkCRUD( this);
+        if (networkInterface == null) {
+            throw new ServiceUnavailableException("Network CRUD Interface "
+                    + RestMessages.SERVICEUNAVAILABLE.toString());
+        }
+        if (input.isSingleton()) {
+            NeutronSubnet singleton = input.getSingleton();
+
+            /*
+             *  Verify that the subnet doesn't already exist (Issue: is a deeper check necessary?)
+             *  the specified network exists, the subnet has a valid network address,
+             *  and that the gateway IP doesn't overlap with the allocation pools
+             *  *then* add the subnet to the cache
+             */
+            if (subnetInterface.subnetExists(singleton.getID())) {
+                throw new BadRequestException("subnet UUID already exists");
+            }
+            if (!networkInterface.networkExists(singleton.getNetworkUUID())) {
+                throw new ResourceNotFoundException("network UUID does not exist.");
+            }
+            if (!singleton.isValidCIDR()) {
+                throw new BadRequestException("invaild CIDR");
+            }
+            if (!singleton.initDefaults()) {
+                throw new InternalServerErrorException("subnet object could not be initialized properly");
+            }
+            if (singleton.gatewayIP_Pool_overlap()) {
+                throw new ResourceConflictException("IP pool overlaps with gateway");
+            }
+            Object[] instances = ServiceHelper.getGlobalInstances(INeutronSubnetAware.class, this, null);
+            if (instances != null) {
+                for (Object instance : instances) {
+                    INeutronSubnetAware service = (INeutronSubnetAware) instance;
+                    int status = service.canCreateSubnet(singleton);
+                    if (status < 200 || status > 299) {
+                        return Response.status(status).build();
+                    }
+                }
+            }
+            subnetInterface.addSubnet(singleton);
+            if (instances != null) {
+                for (Object instance : instances) {
+                    INeutronSubnetAware service = (INeutronSubnetAware) instance;
+                    service.neutronSubnetCreated(singleton);
+                }
+            }
+        } else {
+            List<NeutronSubnet> bulk = input.getBulk();
+            Iterator<NeutronSubnet> i = bulk.iterator();
+            HashMap<String, NeutronSubnet> testMap = new HashMap<String, NeutronSubnet>();
+            Object[] instances = ServiceHelper.getGlobalInstances(INeutronSubnetAware.class, this, null);
+            while (i.hasNext()) {
+                NeutronSubnet test = i.next();
+
+                /*
+                 *  Verify that the subnet doesn't already exist (Issue: is a deeper check necessary?)
+                 *  the specified network exists, the subnet has a valid network address,
+                 *  and that the gateway IP doesn't overlap with the allocation pools,
+                 *  and that the bulk request doesn't already contain a subnet with this id
+                 */
+
+                if (!test.initDefaults()) {
+                    throw new InternalServerErrorException("subnet object could not be initialized properly");
+                }
+                if (subnetInterface.subnetExists(test.getID())) {
+                    throw new BadRequestException("subnet UUID already exists");
+                }
+                if (testMap.containsKey(test.getID())) {
+                    throw new BadRequestException("subnet UUID already exists");
+                }
+                testMap.put(test.getID(), test);
+                if (!networkInterface.networkExists(test.getNetworkUUID())) {
+                    throw new ResourceNotFoundException("network UUID does not exist.");
+                }
+                if (!test.isValidCIDR()) {
+                    throw new BadRequestException("Invalid CIDR");
+                }
+                if (test.gatewayIP_Pool_overlap()) {
+                    throw new ResourceConflictException("IP pool overlaps with gateway");
+                }
+                if (instances != null) {
+                    for (Object instance : instances) {
+                        INeutronSubnetAware service = (INeutronSubnetAware) instance;
+                        int status = service.canCreateSubnet(test);
+                        if (status < 200 || status > 299) {
+                            return Response.status(status).build();
+                        }
+                    }
+                }
+            }
+
+            /*
+             * now, each element of the bulk request can be added to the cache
+             */
+            i = bulk.iterator();
+            while (i.hasNext()) {
+                NeutronSubnet test = i.next();
+                subnetInterface.addSubnet(test);
+                if (instances != null) {
+                    for (Object instance : instances) {
+                        INeutronSubnetAware service = (INeutronSubnetAware) instance;
+                        service.neutronSubnetCreated(test);
+                    }
+                }
+            }
+        }
+        return Response.status(201).entity(input).build();
+    }
+
+    /**
+     * Updates a Subnet */
+
+    @Path("{subnetUUID}")
+    @PUT
+    @Produces({ MediaType.APPLICATION_JSON })
+    @Consumes({ MediaType.APPLICATION_JSON })
+    //@TypeHint(OpenStackSubnets.class)
+    @StatusCodes({
+            @ResponseCode(code = 200, condition = "Operation successful"),
+            @ResponseCode(code = 400, condition = "Bad Request"),
+            @ResponseCode(code = 401, condition = "Unauthorized"),
+            @ResponseCode(code = 403, condition = "Forbidden"),
+            @ResponseCode(code = 404, condition = "Not Found"),
+            @ResponseCode(code = 501, condition = "Not Implemented") })
+    public Response updateSubnet(
+            @PathParam("subnetUUID") String subnetUUID, final NeutronSubnetRequest input
+            ) {
+        INeutronSubnetCRUD subnetInterface = NeutronCRUDInterfaces.getINeutronSubnetCRUD( this);
+        if (subnetInterface == null) {
+            throw new ServiceUnavailableException("Subnet CRUD Interface "
+                    + RestMessages.SERVICEUNAVAILABLE.toString());
+        }
+
+        /*
+         * verify the subnet exists and there is only one delta provided
+         */
+        if (!subnetInterface.subnetExists(subnetUUID)) {
+            throw new ResourceNotFoundException("subnet UUID does not exist.");
+        }
+        if (!input.isSingleton()) {
+            throw new BadRequestException("Only singleton edit supported");
+        }
+        NeutronSubnet delta = input.getSingleton();
+        NeutronSubnet original = subnetInterface.getSubnet(subnetUUID);
+
+        /*
+         * updates restricted by Neutron
+         */
+        if (delta.getID() != null || delta.getTenantID() != null ||
+                delta.getIpVersion() != null || delta.getCidr() != null ||
+                delta.getAllocationPools() != null) {
+            throw new BadRequestException("Attribute edit blocked by Neutron");
+        }
+
+        Object[] instances = ServiceHelper.getGlobalInstances(INeutronSubnetAware.class, this, null);
+        if (instances != null) {
+            for (Object instance : instances) {
+                INeutronSubnetAware service = (INeutronSubnetAware) instance;
+                int status = service.canUpdateSubnet(delta, original);
+                if (status < 200 || status > 299) {
+                    return Response.status(status).build();
+                }
+            }
+        }
+
+        /*
+         * update the object and return it
+         */
+        subnetInterface.updateSubnet(subnetUUID, delta);
+        NeutronSubnet updatedSubnet = subnetInterface.getSubnet(subnetUUID);
+        if (instances != null) {
+            for (Object instance : instances) {
+                INeutronSubnetAware service = (INeutronSubnetAware) instance;
+                service.neutronSubnetUpdated(updatedSubnet);
+            }
+        }
+        return Response.status(200).entity(
+                new NeutronSubnetRequest(subnetInterface.getSubnet(subnetUUID))).build();
+    }
+
+    /**
+     * Deletes a Subnet */
+
+    @Path("{subnetUUID}")
+    @DELETE
+    @StatusCodes({
+            @ResponseCode(code = 204, condition = "No Content"),
+            @ResponseCode(code = 401, condition = "Unauthorized"),
+            @ResponseCode(code = 404, condition = "Not Found"),
+            @ResponseCode(code = 409, condition = "Conflict"),
+            @ResponseCode(code = 501, condition = "Not Implemented") })
+    public Response deleteSubnet(
+            @PathParam("subnetUUID") String subnetUUID) {
+        INeutronSubnetCRUD subnetInterface = NeutronCRUDInterfaces.getINeutronSubnetCRUD( this);
+        if (subnetInterface == null) {
+            throw new ServiceUnavailableException("Network CRUD Interface "
+                    + RestMessages.SERVICEUNAVAILABLE.toString());
+        }
+
+        /*
+         * verify the subnet exists and it isn't currently in use
+         */
+        if (!subnetInterface.subnetExists(subnetUUID)) {
+            throw new ResourceNotFoundException("subnet UUID does not exist.");
+        }
+        if (subnetInterface.subnetInUse(subnetUUID)) {
+            return Response.status(409).build();
+        }
+        NeutronSubnet singleton = subnetInterface.getSubnet(subnetUUID);
+        Object[] instances = ServiceHelper.getGlobalInstances(INeutronSubnetAware.class, this, null);
+        if (instances != null) {
+            for (Object instance : instances) {
+                INeutronSubnetAware service = (INeutronSubnetAware) instance;
+                int status = service.canDeleteSubnet(singleton);
+                if (status < 200 || status > 299) {
+                    return Response.status(status).build();
+                }
+            }
+        }
+
+        /*
+         * remove it and return 204 status
+         */
+        subnetInterface.removeSubnet(subnetUUID);
+        if (instances != null) {
+            for (Object instance : instances) {
+                INeutronSubnetAware service = (INeutronSubnetAware) instance;
+                service.neutronSubnetDeleted(singleton);
+            }
+        }
+        return Response.status(204).build();
+    }
+}