2 * ============LICENSE_START=======================================================
\r
4 * ================================================================================
\r
5 * Copyright (C) 2019 AT&T Intellectual Property. All rights reserved.
\r
6 * Modifications Copyright (C) 2022 Bell Canada. All rights reserved.
\r
7 * Modifications Copyright (C) 2022 Nordix Foundation.
\r
8 * ================================================================================
\r
9 * Licensed under the Apache License, Version 2.0 (the "License");
\r
10 * you may not use this file except in compliance with the License.
\r
11 * You may obtain a copy of the License at
\r
13 * http://www.apache.org/licenses/LICENSE-2.0
\r
15 * Unless required by applicable law or agreed to in writing, software
\r
16 * distributed under the License is distributed on an "AS IS" BASIS,
\r
17 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
\r
18 * See the License for the specific language governing permissions and
\r
19 * limitations under the License.
\r
21 * SPDX-License-Identifier: Apache-2.0
\r
22 * ============LICENSE_END=========================================================
\r
25 package org.onap.policy.api.main.rest;
\r
27 import java.util.UUID;
\r
28 import org.onap.policy.api.main.exception.PolicyApiRuntimeException;
\r
29 import org.onap.policy.common.utils.coder.Coder;
\r
30 import org.onap.policy.common.utils.coder.CoderException;
\r
31 import org.onap.policy.common.utils.coder.StandardCoder;
\r
32 import org.slf4j.Logger;
\r
33 import org.slf4j.LoggerFactory;
\r
34 import org.springframework.http.HttpHeaders;
\r
35 import org.springframework.http.ResponseEntity;
\r
36 import org.springframework.web.bind.annotation.ExceptionHandler;
\r
39 * Super class from which REST controllers are derived.
\r
41 public class CommonRestController {
\r
43 private static final Logger LOGGER = LoggerFactory.getLogger(CommonRestController.class);
\r
45 protected static final String EXTENSION_NAME = "interface info";
\r
47 protected static final String API_VERSION_NAME = "api-version";
\r
48 protected static final String API_VERSION = "1.0.0";
\r
50 protected static final String LAST_MOD_NAME = "last-mod-release";
\r
52 protected static final String AUTHORIZATION_TYPE = "basicAuth";
\r
54 protected static final String VERSION_MINOR_NAME = "X-MinorVersion";
\r
55 protected static final String VERSION_MINOR_DESCRIPTION =
\r
56 "Used to request or communicate a MINOR version back from the client"
\r
57 + " to the server, and from the server back to the client";
\r
59 protected static final String VERSION_PATCH_NAME = "X-PatchVersion";
\r
60 protected static final String VERSION_PATCH_DESCRIPTION = "Used only to communicate a PATCH version in a "
\r
61 + "response for troubleshooting purposes only, and will not be provided by" + " the client on request";
\r
63 protected static final String VERSION_LATEST_NAME = "X-LatestVersion";
\r
64 protected static final String VERSION_LATEST_DESCRIPTION = "Used only to communicate an API's latest version";
\r
66 protected static final String REQUEST_ID_NAME = "X-ONAP-RequestID";
\r
67 protected static final String REQUEST_ID_HDR_DESCRIPTION = "Used to track REST transactions for logging purpose";
\r
68 protected static final String REQUEST_ID_PARAM_DESCRIPTION = "RequestID for http transaction";
\r
70 protected static final String AUTHENTICATION_ERROR_MESSAGE = "Authentication Error";
\r
71 protected static final String AUTHORIZATION_ERROR_MESSAGE = "Authorization Error";
\r
72 protected static final String SERVER_ERROR_MESSAGE = "Internal Server Error";
\r
73 protected static final String NOT_FOUND_MESSAGE = "Resource Not Found";
\r
74 protected static final String INVALID_BODY_MESSAGE = "Invalid Body";
\r
75 protected static final String INVALID_PAYLOAD_MESSAGE = "Not Acceptable Payload";
\r
76 protected static final String HTTP_CONFLICT_MESSAGE = "Delete Conflict, Rule Violation";
\r
77 protected static final String ERROR_MESSAGE_NO_POLICIES_FOUND = "No policies found";
\r
79 protected final Coder coder = new StandardCoder();
\r
81 protected <T> ResponseEntity<T> makeOkResponse(UUID requestId, T respEntity) {
\r
82 HttpHeaders headers = new HttpHeaders();
\r
83 addVersionControlHeaders(headers);
\r
84 addLoggingHeaders(headers, requestId);
\r
85 return ResponseEntity.ok().headers(headers).body(respEntity);
\r
88 protected <T> ResponseEntity<T> makeErrorResponse(UUID requestId, T respEntity, int status) {
\r
89 HttpHeaders headers = new HttpHeaders();
\r
90 addVersionControlHeaders(headers);
\r
91 addLoggingHeaders(headers, requestId);
\r
92 return ResponseEntity.status(status).headers(headers).body(respEntity);
\r
95 private void addVersionControlHeaders(HttpHeaders headers) {
\r
96 headers.add("X-MinorVersion", "0");
\r
97 headers.add("X-PatchVersion", "0");
\r
98 headers.add("X-LatestVersion", "1.0.0");
\r
101 private void addLoggingHeaders(HttpHeaders headers, UUID requestId) {
\r
102 if (requestId == null) {
\r
103 // Generate a random uuid if client does not embed requestId in rest request
\r
104 headers.add("X-ONAP-RequestID", UUID.randomUUID().toString());
\r
106 headers.add("X-ONAP-RequestID", requestId.toString());
\r
111 * Converts an object to a JSON string.
\r
113 * @param object object to convert
\r
114 * @return a JSON string representing the object
\r
116 protected String toJson(Object object) {
\r
117 if (object == null) {
\r
122 return coder.encode(object);
\r
124 } catch (CoderException e) {
\r
125 LOGGER.warn("cannot convert {} to JSON", object.getClass().getName(), e);
\r
130 @ExceptionHandler(value = {PolicyApiRuntimeException.class})
\r
131 protected ResponseEntity<Object> handleException(PolicyApiRuntimeException ex) {
\r
132 LOGGER.warn(ex.getMessage(), ex.getCause());
\r
133 return makeErrorResponse(ex.getRequestId(), ex.getErrorResponse(),
\r
134 ex.getErrorResponse().getResponseCode().getStatusCode());
\r