checkstyle: enable SummaryJavadoc
[neutron.git] / northbound-api / src / main / java / org / opendaylight / neutron / northbound / api / NeutronBgpvpnsNorthbound.java
1 /*
2  * Copyright (c) 2015 Ericsson India Global Services Pvt Ltd. and others. All rights reserved.
3  *
4  * This program and the accompanying materials are made available under the
5  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
6  * and is available at http://www.eclipse.org/legal/epl-v10.html
7  */
8
9 package org.opendaylight.neutron.northbound.api;
10
11 import java.net.HttpURLConnection;
12 import java.util.ArrayList;
13 import java.util.List;
14 import javax.ws.rs.Consumes;
15 import javax.ws.rs.DELETE;
16 import javax.ws.rs.DefaultValue;
17 import javax.ws.rs.GET;
18 import javax.ws.rs.POST;
19 import javax.ws.rs.PUT;
20 import javax.ws.rs.Path;
21 import javax.ws.rs.PathParam;
22 import javax.ws.rs.Produces;
23 import javax.ws.rs.QueryParam;
24 import javax.ws.rs.core.Context;
25 import javax.ws.rs.core.MediaType;
26 import javax.ws.rs.core.Response;
27 import javax.ws.rs.core.UriInfo;
28 import org.codehaus.enunciate.jaxrs.ResponseCode;
29 import org.codehaus.enunciate.jaxrs.StatusCodes;
30 import org.codehaus.enunciate.jaxrs.TypeHint;
31 import org.opendaylight.neutron.spi.INeutronBgpvpnCRUD;
32 import org.opendaylight.neutron.spi.NeutronBgpvpn;
33
34 /**
35  * Neutron Northbound REST APIs for Bgpvpn.<br>
36  * This class provides REST APIs for managing neutron Bgpvpns
37  *
38  * <br>
39  * <br>
40  * Authentication scheme : <b>HTTP Basic</b><br>
41  * Authentication realm : <b>opendaylight</b><br>
42  * Transport : <b>HTTP and HTTPS</b><br>
43  * <br>
44  * HTTPS Authentication is disabled by default. Administrator can enable it in
45  * tomcat-server.xml after adding a proper keystore / SSL certificate from a
46  * trusted authority.<br>
47  * More info :
48  * http://tomcat.apache.org/tomcat-7.0-doc/ssl-howto.html#Configuration
49  *
50  */
51
52 @Path("/bgpvpns")
53 public final class NeutronBgpvpnsNorthbound
54         extends AbstractNeutronNorthbound<NeutronBgpvpn, NeutronBgpvpnRequest, INeutronBgpvpnCRUD> {
55
56     @Context
57     UriInfo uriInfo;
58
59     private static final String RESOURCE_NAME = "Bgpvpn";
60
61     @Override
62     protected String getResourceName() {
63         return RESOURCE_NAME;
64     }
65
66     /**
67      * Returns a list of all Bgpvpns.
68      */
69
70     @GET
71     @Produces({ MediaType.APPLICATION_JSON })
72     //@TypeHint(OpenStackBgpvpns.class)
73     @StatusCodes({ @ResponseCode(code = HttpURLConnection.HTTP_OK, condition = "Operation successful"),
74             @ResponseCode(code = HttpURLConnection.HTTP_UNAUTHORIZED, condition = "Unauthorized"),
75             @ResponseCode(code = HttpURLConnection.HTTP_NOT_IMPLEMENTED, condition = "Not Implemented"),
76             @ResponseCode(code = HttpURLConnection.HTTP_UNAVAILABLE, condition = "No providers available") })
77     public Response listBgpvpns(
78             // return fields
79             @QueryParam("fields") List<String> fields,
80             // note: openstack isn't clear about filtering on lists, so we aren't handling them
81             @QueryParam("id") String queryID,
82             @QueryParam("name") String queryName,
83             @QueryParam("admin_state_up") String queryAdminStateUp,
84             @QueryParam("status") String queryStatus,
85             @QueryParam("tenant_id") String queryTenantID,
86             @QueryParam("type") String queryType,
87             @QueryParam("auto_aggregate") String queryAutoAggregate,
88             // pagination
89             @QueryParam("limit") Integer limit,
90             @QueryParam("marker") String marker,
91             @DefaultValue("false") @QueryParam("page_reverse") Boolean pageReverse
92     // sorting not supported
93     ) {
94         INeutronBgpvpnCRUD bgpvpnInterface = getNeutronCRUD();
95         List<NeutronBgpvpn> allBgpvpns = bgpvpnInterface.getAll();
96         List<NeutronBgpvpn> ans = new ArrayList<>();
97         for (NeutronBgpvpn bgpvpn : allBgpvpns) {
98             //match filters: TODO provider extension
99             Boolean adminStateUp = null;
100             Boolean autoAggregate = null;
101             if (queryAdminStateUp != null) {
102                 adminStateUp = Boolean.valueOf(queryAdminStateUp);
103             }
104             if (queryAutoAggregate != null) {
105                 autoAggregate = Boolean.valueOf(queryAutoAggregate);
106             }
107             if ((queryID == null || queryID.equals(bgpvpn.getID()))
108                     && (queryName == null || queryName.equals(bgpvpn.getName()))
109                     && (adminStateUp == null || adminStateUp.booleanValue() == bgpvpn.isAdminStateUp())
110                     && (queryStatus == null || queryStatus.equals(bgpvpn.getStatus()))
111                     && (autoAggregate == null || autoAggregate.booleanValue() == bgpvpn.isAutoAggregate())
112                     && (queryTenantID == null || queryTenantID.equals(bgpvpn.getTenantID()))) {
113                 if (fields.size() > 0) {
114                     ans.add(bgpvpn.extractFields(fields));
115                 } else {
116                     ans.add(bgpvpn);
117                 }
118             }
119         }
120
121         if (limit != null && ans.size() > 1) {
122             // Return a paginated request
123             NeutronBgpvpnRequest request = (NeutronBgpvpnRequest) PaginatedRequestFactory.createRequest(limit, marker,
124                     pageReverse, uriInfo, ans, NeutronBgpvpn.class);
125             return Response.status(HttpURLConnection.HTTP_OK).entity(request).build();
126         }
127
128         return Response.status(HttpURLConnection.HTTP_OK).entity(new NeutronBgpvpnRequest(ans)).build();
129
130     }
131
132     /**
133      * Returns a specific Bgpvpn.
134      */
135
136     @Path("{bgpvpnUUID}")
137     @GET
138     @Produces({ MediaType.APPLICATION_JSON })
139     //@TypeHint(OpenStackBgpvpns.class)
140     @StatusCodes({ @ResponseCode(code = HttpURLConnection.HTTP_OK, condition = "Operation successful"),
141             @ResponseCode(code = HttpURLConnection.HTTP_UNAUTHORIZED, condition = "Unauthorized"),
142             @ResponseCode(code = HttpURLConnection.HTTP_NOT_FOUND, condition = "Not Found"),
143             @ResponseCode(code = HttpURLConnection.HTTP_NOT_IMPLEMENTED, condition = "Not Implemented"),
144             @ResponseCode(code = HttpURLConnection.HTTP_UNAVAILABLE, condition = "No providers available") })
145     public Response showBgpvpn(@PathParam("bgpvpnUUID") String bgpvpnUUID,
146             // return fields
147             @QueryParam("fields") List<String> fields) {
148         return show(bgpvpnUUID, fields);
149     }
150
151     /**
152      * Creates new Bgpvpns.
153      */
154     @POST
155     @Produces({ MediaType.APPLICATION_JSON })
156     @Consumes({ MediaType.APPLICATION_JSON })
157     @TypeHint(NeutronBgpvpn.class)
158     @StatusCodes({ @ResponseCode(code = HttpURLConnection.HTTP_CREATED, condition = "Created"),
159             @ResponseCode(code = HttpURLConnection.HTTP_UNAVAILABLE, condition = "No providers available") })
160     public Response createBgpvpns(final NeutronBgpvpnRequest input) {
161         return create(input);
162     }
163
164     /**
165      * Updates a Bgpvpn.
166      */
167     @Override
168     protected void updateDelta(String uuid, NeutronBgpvpn delta, NeutronBgpvpn original) {
169         //Fill in defaults if they're missing in update
170         delta.initDefaults();
171         delta.setID(uuid);
172         delta.setTenantID(original.getTenantID());
173     }
174
175     @Path("{bgpvpnUUID}")
176     @PUT
177     @Produces({ MediaType.APPLICATION_JSON })
178     @Consumes({ MediaType.APPLICATION_JSON })
179     //@TypeHint(OpenStackBgpvpns.class)
180     @StatusCodes({ @ResponseCode(code = HttpURLConnection.HTTP_OK, condition = "Operation successful"),
181             @ResponseCode(code = HttpURLConnection.HTTP_NOT_FOUND, condition = "Not Found"),
182             @ResponseCode(code = HttpURLConnection.HTTP_UNAVAILABLE, condition = "No providers available") })
183     public Response updateBgpvpn(@PathParam("bgpvpnUUID") String bgpvpnUUID, final NeutronBgpvpnRequest input) {
184         return update(bgpvpnUUID, input);
185     }
186
187     /**
188      * Deletes a Bgpvpn.
189      */
190
191     @Path("{bgpvpnUUID}")
192     @DELETE
193     @StatusCodes({ @ResponseCode(code = HttpURLConnection.HTTP_NO_CONTENT, condition = "No Content"),
194             @ResponseCode(code = HttpURLConnection.HTTP_NOT_FOUND, condition = "Not Found"),
195             @ResponseCode(code = HttpURLConnection.HTTP_UNAVAILABLE, condition = "No providers available") })
196     public Response deleteBgpvpn(@PathParam("bgpvpnUUID") String bgpvpnUUID) {
197         return delete(bgpvpnUUID);
198     }
199 }