1 /*******************************************************************************
\r
2 * ============LICENSE_START==================================================
\r
4 * * ===========================================================================
\r
5 * * Copyright © 2017 AT&T Intellectual Property. All rights reserved.
\r
6 * * ===========================================================================
\r
7 * * Licensed under the Apache License, Version 2.0 (the "License");
\r
8 * * you may not use this file except in compliance with the License.
\r
9 * * You may obtain a copy of the License at
\r
11 * * http://www.apache.org/licenses/LICENSE-2.0
\r
13 * * Unless required by applicable law or agreed to in writing, software
\r
14 * * distributed under the License is distributed on an "AS IS" BASIS,
\r
15 * * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
\r
16 * * See the License for the specific language governing permissions and
\r
17 * * limitations under the License.
\r
18 * * ============LICENSE_END====================================================
\r
20 * * ECOMP is a trademark and service mark of AT&T Intellectual Property.
\r
22 ******************************************************************************/
\r
25 package org.onap.dmaap.datarouter.provisioning;
\r
27 import java.io.IOException;
\r
28 import java.util.Set;
\r
30 import javax.servlet.http.HttpServletRequest;
\r
31 import javax.servlet.http.HttpServletResponse;
\r
33 import org.json.JSONException;
\r
34 import org.json.JSONObject;
\r
35 import org.onap.dmaap.datarouter.provisioning.beans.Deleteable;
\r
36 import org.onap.dmaap.datarouter.provisioning.beans.EgressRoute;
\r
37 import org.onap.dmaap.datarouter.provisioning.beans.EventLogRecord;
\r
38 import org.onap.dmaap.datarouter.provisioning.beans.IngressRoute;
\r
39 import org.onap.dmaap.datarouter.provisioning.beans.Insertable;
\r
40 import org.onap.dmaap.datarouter.provisioning.beans.NetworkRoute;
\r
41 import org.onap.dmaap.datarouter.provisioning.beans.NodeClass;
\r
43 import static org.onap.dmaap.datarouter.provisioning.utils.HttpServletUtils.sendResponseError;
\r
47 * This servlet handles requests to URLs under /internal/route/ on the provisioning server.
\r
48 * This part of the URL tree is used to manipulate the Data Router routing tables.
\r
51 * <div class="contentContainer">
\r
52 * <table class="packageSummary" border="0" cellpadding="3" cellspacing="0">
\r
53 * <caption><span>URL Path Summary</span><span class="tabEnd"> </span></caption>
\r
55 * <th class="colFirst" width="35%">URL Path</th>
\r
56 * <th class="colOne">Method</th>
\r
57 * <th class="colLast">Purpose</th>
\r
59 * <tr class="altColor">
\r
60 * <td class="colFirst">/internal/route/</td>
\r
61 * <td class="colOne">GET</td>
\r
62 * <td class="colLast">used to GET a full JSON copy of all three routing tables.</td>
\r
64 * <tr class="rowColor">
\r
65 * <td class="colFirst" rowspan="2">/internal/route/ingress/</td>
\r
66 * <td class="colOne">GET</td>
\r
67 * <td class="colLast">used to GET a full JSON copy of the ingress routing table (IRT).</td>
\r
69 * <tr class="rowColor">
\r
70 * <td class="colOne">POST</td>
\r
71 * <td class="colLast">used to create a new entry in the ingress routing table (IRT).</td></tr>
\r
72 * <tr class="altColor">
\r
73 * <td class="colFirst" rowspan="2">/internal/route/egress/</td>
\r
74 * <td class="colOne">GET</td>
\r
75 * <td class="colLast">used to GET a full JSON copy of the egress routing table (ERT).</td>
\r
77 * <tr class="altColor">
\r
78 * <td class="colOne">POST</td>
\r
79 * <td class="colLast">used to create a new entry in the egress routing table (ERT).</td></tr>
\r
80 * <tr class="rowColor">
\r
81 * <td class="colFirst" rowspan="2">/internal/route/network/</td>
\r
82 * <td class="colOne">GET</td>
\r
83 * <td class="colLast">used to GET a full JSON copy of the network routing table (NRT).</td>
\r
85 * <tr class="rowColor">
\r
86 * <td class="colOne">POST</td>
\r
87 * <td class="colLast">used to create a new entry in the network routing table (NRT).</td>
\r
89 * <tr class="altColor">
\r
90 * <td class="colFirst">/internal/route/ingress/<feed>/<user>/<subnet></td>
\r
91 * <td class="colOne">DELETE</td>
\r
92 * <td class="colLast">used to DELETE the ingress route corresponding to <i>feed</i>, <i>user</i> and <i>subnet</i>.
\r
93 * The / in the subnet specified should be replaced with a !, since / cannot be used in a URL.</td>
\r
95 * <tr class="rowColor">
\r
96 * <td class="colFirst">/internal/route/ingress/<seq></td>
\r
97 * <td class="colOne">DELETE</td>
\r
98 * <td class="colLast">used to DELETE all ingress routes with the matching <i>seq</i> sequence number.</td>
\r
100 * <tr class="altColor">
\r
101 * <td class="colFirst">/internal/route/egress/<sub></td>
\r
102 * <td class="colOne">DELETE</td>
\r
103 * <td class="colLast">used to DELETE the egress route the matching <i>sub</i> subscriber number.</td>
\r
105 * <tr class="rowColor">
\r
106 * <td class="colFirst">/internal/route/network/<fromnode>/<tonode></td>
\r
107 * <td class="colOne">DELETE</td>
\r
108 * <td class="colLast">used to DELETE the network route corresponding to <i>fromnode</i>
\r
109 * and <i>tonode</i>.</td>
\r
113 * Authorization to use these URLs is a little different than for other URLs on the provisioning server.
\r
114 * For the most part, the IP address that the request comes from should be either:
\r
117 * <li>an IP address of a provisioning server, or</li>
\r
118 * <li>the IP address of a node, or</li>
\r
119 * <li>an IP address from the "<i>special subnet</i>" which is configured with
\r
120 * the PROV_SPECIAL_SUBNET parameter.
\r
123 * All DELETE/GET/POST requests made to this servlet on the standby server are proxied to the
\r
124 * active server (using the {@link ProxyServlet}) if it is up and reachable.
\r
127 * @author Robert Eby
\r
130 @SuppressWarnings("serial")
\r
131 public class RouteServlet extends ProxyServlet {
\r
133 * DELETE route table entries by deleting part of the route table tree.
\r
136 public void doDelete(HttpServletRequest req, HttpServletResponse resp) {
\r
137 EventLogRecord elr = new EventLogRecord(req);
\r
138 if (!isAuthorizedForInternal(req)) {
\r
139 elr.setMessage("Unauthorized.");
\r
140 elr.setResult(HttpServletResponse.SC_FORBIDDEN);
\r
141 eventlogger.error(elr.toString());
\r
142 sendResponseError(resp, HttpServletResponse.SC_FORBIDDEN, "Unauthorized.", eventlogger);
\r
145 if (isProxyOK(req) && isProxyServer()) {
\r
146 super.doDelete(req, resp);
\r
150 String path = req.getPathInfo();
\r
151 String[] parts = path.substring(1).split("/");
\r
152 Deleteable[] d = null;
\r
153 if (parts[0].equals("ingress")) {
\r
154 if (parts.length == 4) {
\r
155 // /internal/route/ingress/<feed>/<user>/<subnet>
\r
157 int feedid = Integer.parseInt(parts[1]);
\r
158 IngressRoute er = IngressRoute.getIngressRoute(feedid, parts[2], parts[3].replaceAll("!", "/"));
\r
160 sendResponseError(resp, HttpServletResponse.SC_NOT_FOUND, "The specified ingress route does not exist.", eventlogger);
\r
163 d = new Deleteable[] { er };
\r
164 } catch (NumberFormatException e) {
\r
165 sendResponseError(resp, HttpServletResponse.SC_NOT_FOUND, "Invalid feed ID in 'delete ingress' command.", eventlogger);
\r
168 } else if (parts.length == 2) {
\r
169 // /internal/route/ingress/<seq>
\r
171 int seq = Integer.parseInt(parts[1]);
\r
172 Set<IngressRoute> set = IngressRoute.getIngressRoutesForSeq(seq);
\r
173 d = set.toArray(new Deleteable[0]);
\r
174 } catch (NumberFormatException e) {
\r
175 sendResponseError(resp, HttpServletResponse.SC_NOT_FOUND, "Invalid sequence number in 'delete ingress' command.", eventlogger);
\r
179 sendResponseError(resp, HttpServletResponse.SC_NOT_FOUND, "Invalid number of arguments in 'delete ingress' command.", eventlogger);
\r
182 } else if (parts[0].equals("egress")) {
\r
183 if (parts.length == 2) {
\r
184 // /internal/route/egress/<sub>
\r
186 int subid = Integer.parseInt(parts[1]);
\r
187 EgressRoute er = EgressRoute.getEgressRoute(subid);
\r
189 sendResponseError(resp, HttpServletResponse.SC_NOT_FOUND, "The specified egress route does not exist.", eventlogger);
\r
192 d = new Deleteable[] { er };
\r
193 } catch (NumberFormatException e) {
\r
194 sendResponseError(resp, HttpServletResponse.SC_NOT_FOUND, "Invalid sub ID in 'delete egress' command.", eventlogger);
\r
198 sendResponseError(resp, HttpServletResponse.SC_NOT_FOUND, "Invalid number of arguments in 'delete egress' command.", eventlogger);
\r
201 } else if (parts[0].equals("network")) {
\r
202 if (parts.length == 3) {
\r
203 // /internal/route/network/<from>/<to>
\r
205 NetworkRoute nr = new NetworkRoute(
\r
206 NodeClass.normalizeNodename(parts[1]),
\r
207 NodeClass.normalizeNodename(parts[2])
\r
209 d = new Deleteable[] { nr };
\r
210 } catch (IllegalArgumentException e) {
\r
211 String message = "The specified network route does not exist.";
\r
212 eventlogger.error(message, e);
\r
213 sendResponseError(resp, HttpServletResponse.SC_NOT_FOUND, message, eventlogger);
\r
217 sendResponseError(resp, HttpServletResponse.SC_NOT_FOUND, "Invalid number of arguments in 'delete network' command.", eventlogger);
\r
222 sendResponseError(resp, HttpServletResponse.SC_NOT_FOUND, "Bad URL.", eventlogger);
\r
226 for (Deleteable dd : d) {
\r
227 rv &= doDelete(dd);
\r
230 elr.setResult(HttpServletResponse.SC_OK);
\r
231 eventlogger.info(elr.toString());
\r
232 resp.setStatus(HttpServletResponse.SC_OK);
\r
233 provisioningDataChanged();
\r
234 provisioningParametersChanged();
\r
236 // Something went wrong with the DELETE
\r
237 elr.setResult(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
\r
238 eventlogger.error(elr.toString());
\r
239 sendResponseError(resp, HttpServletResponse.SC_INTERNAL_SERVER_ERROR, DB_PROBLEM_MSG, eventlogger);
\r
243 * GET route table entries from the route table tree specified by the URL path.
\r
246 public void doGet(HttpServletRequest req, HttpServletResponse resp) {
\r
247 EventLogRecord elr = new EventLogRecord(req);
\r
248 if (!isAuthorizedForInternal(req)) {
\r
249 elr.setMessage("Unauthorized.");
\r
250 elr.setResult(HttpServletResponse.SC_FORBIDDEN);
\r
251 eventlogger.error(elr.toString());
\r
252 sendResponseError(resp, HttpServletResponse.SC_FORBIDDEN, "Unauthorized.", eventlogger);
\r
255 if (isProxyOK(req) && isProxyServer()) {
\r
256 super.doGet(req, resp);
\r
260 String path = req.getPathInfo();
\r
261 if (!path.endsWith("/"))
\r
263 if (!path.equals("/") && !path.equals("/ingress/") && !path.equals("/egress/") && !path.equals("/network/")) {
\r
264 sendResponseError(resp, HttpServletResponse.SC_NOT_FOUND, "Bad URL.", eventlogger);
\r
268 StringBuilder sb = new StringBuilder("{\n");
\r
270 if (path.equals("/") || path.equals("/ingress/")) {
\r
272 sb.append("\"ingress\": [");
\r
273 for (IngressRoute in : IngressRoute.getAllIngressRoutes()) {
\r
275 sb.append(in.asJSONObject().toString());
\r
282 if (path.equals("/") || path.equals("/egress/")) {
\r
285 sb.append("\"egress\": {");
\r
286 for (EgressRoute eg : EgressRoute.getAllEgressRoutes()) {
\r
287 JSONObject jx = eg.asJSONObject();
\r
288 for (String key : jx.keySet()) {
\r
290 sb.append(" \"").append(key).append("\": ");
\r
292 sb.append("\"").append(jx.getString(key)).append("\"");
\r
293 } catch (JSONException je) {
\r
294 eventlogger.error("PROV0161 RouteServlet.doGet: " + je.getMessage(), je);
\r
303 if (path.equals("/") || path.equals("/network/")) {
\r
306 sb.append("\"routing\": [");
\r
307 for (NetworkRoute ne : NetworkRoute.getAllNetworkRoutes()) {
\r
309 sb.append(ne.asJSONObject().toString());
\r
315 resp.setStatus(HttpServletResponse.SC_OK);
\r
316 resp.setContentType("application/json");
\r
318 resp.getOutputStream().print(sb.toString());
\r
319 } catch (IOException ioe) {
\r
320 eventlogger.error("PROV0162 RouteServlet.doGet: " + ioe.getMessage(), ioe);
\r
324 * PUT on </internal/route/*> -- not supported.
\r
327 public void doPut(HttpServletRequest req, HttpServletResponse resp) {
\r
328 EventLogRecord elr = new EventLogRecord(req);
\r
329 if (!isAuthorizedForInternal(req)) {
\r
330 elr.setMessage("Unauthorized.");
\r
331 elr.setResult(HttpServletResponse.SC_FORBIDDEN);
\r
332 eventlogger.error(elr.toString());
\r
333 sendResponseError(resp, HttpServletResponse.SC_FORBIDDEN, "Unauthorized.", eventlogger);
\r
336 sendResponseError(resp, HttpServletResponse.SC_NOT_FOUND, "Bad URL.", eventlogger);
\r
339 * POST - modify existing route table entries in the route table tree specified by the URL path.
\r
342 public void doPost(HttpServletRequest req, HttpServletResponse resp) {
\r
343 EventLogRecord elr = new EventLogRecord(req);
\r
344 if (!isAuthorizedForInternal(req)) {
\r
345 elr.setMessage("Unauthorized.");
\r
346 elr.setResult(HttpServletResponse.SC_FORBIDDEN);
\r
347 eventlogger.error(elr.toString());
\r
348 sendResponseError(resp, HttpServletResponse.SC_FORBIDDEN, "Unauthorized.", eventlogger);
\r
351 if (isProxyOK(req) && isProxyServer()) {
\r
352 super.doPost(req, resp);
\r
355 String path = req.getPathInfo();
\r
356 Insertable[] ins = null;
\r
357 if (path.startsWith("/ingress/")) {
\r
358 // /internal/route/ingress/?feed=%s&user=%s&subnet=%s&nodepatt=%s
\r
360 // Although it probably doesn't make sense, you can install two identical routes in the IRT
\r
361 int feedid = Integer.parseInt(req.getParameter("feed"));
\r
362 String user = req.getParameter("user");
\r
365 String subnet = req.getParameter("subnet");
\r
366 if (subnet == null)
\r
368 String nodepatt = req.getParameter("nodepatt");
\r
369 String t = req.getParameter("seq");
\r
370 int seq = (t != null) ? Integer.parseInt(t) : (IngressRoute.getMaxSequence() + 100);
\r
371 ins = new Insertable[] { new IngressRoute(seq, feedid, user, subnet, NodeClass.lookupNodeNames(nodepatt)) };
\r
372 } catch (Exception e) {
\r
373 intlogger.info(e.toString(), e);
\r
374 sendResponseError(resp, HttpServletResponse.SC_BAD_REQUEST, "Invalid arguments in 'add ingress' command.", intlogger);
\r
377 } else if (path.startsWith("/egress/")) {
\r
378 // /internal/route/egress/?sub=%s&node=%s
\r
380 int subid = Integer.parseInt(req.getParameter("sub"));
\r
381 EgressRoute er = EgressRoute.getEgressRoute(subid);
\r
383 sendResponseError(resp, HttpServletResponse.SC_BAD_REQUEST, "An egress route already exists for that subscriber.", intlogger);
\r
386 String node = NodeClass.normalizeNodename(req.getParameter("node"));
\r
387 ins = new Insertable[] { new EgressRoute(subid, node) };
\r
388 } catch (Exception e) {
\r
389 intlogger.info(e.toString(), e);
\r
390 sendResponseError(resp, HttpServletResponse.SC_BAD_REQUEST, "Invalid arguments in 'add egress' command.", intlogger);
\r
393 } else if (path.startsWith("/network/")) {
\r
394 // /internal/route/network/?from=%s&to=%s&via=%s
\r
396 String nfrom = req.getParameter("from");
\r
397 String nto = req.getParameter("to");
\r
398 String nvia = req.getParameter("via");
\r
399 if (nfrom == null || nto == null || nvia == null) {
\r
400 sendResponseError(resp, HttpServletResponse.SC_BAD_REQUEST, "Missing arguments in 'add network' command.", intlogger);
\r
403 nfrom = NodeClass.normalizeNodename(nfrom);
\r
404 nto = NodeClass.normalizeNodename(nto);
\r
405 nvia = NodeClass.normalizeNodename(nvia);
\r
406 NetworkRoute nr = new NetworkRoute(nfrom, nto, nvia);
\r
407 for (NetworkRoute route : NetworkRoute.getAllNetworkRoutes()) {
\r
408 if (route.getFromnode() == nr.getFromnode() && route.getTonode() == nr.getTonode()) {
\r
409 sendResponseError(resp, HttpServletResponse.SC_BAD_REQUEST, "Network route table already contains a route for " + nfrom + " and " + nto, intlogger);
\r
413 ins = new Insertable[] { nr };
\r
414 } catch (IllegalArgumentException e) {
\r
415 intlogger.info(e.toString(), e);
\r
416 sendResponseError(resp, HttpServletResponse.SC_BAD_REQUEST, "Invalid arguments in 'add network' command.", intlogger);
\r
421 sendResponseError(resp, HttpServletResponse.SC_NOT_FOUND, "Bad URL.", intlogger);
\r
425 for (Insertable dd : ins) {
\r
426 rv &= doInsert(dd);
\r
429 elr.setResult(HttpServletResponse.SC_OK);
\r
430 eventlogger.info(elr.toString());
\r
431 resp.setStatus(HttpServletResponse.SC_OK);
\r
432 provisioningDataChanged();
\r
433 provisioningParametersChanged();
\r
435 // Something went wrong with the INSERT
\r
436 elr.setResult(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
\r
437 eventlogger.error(elr.toString());
\r
438 sendResponseError(resp, HttpServletResponse.SC_INTERNAL_SERVER_ERROR, DB_PROBLEM_MSG, intlogger);
\r