src/main/java/org/onap/crud/service/AbstractGraphDataService.java

   1 /**
   2  * ============LICENSE_START=======================================================
   3  * org.onap.aai
   4  * ================================================================================
   5  * Copyright © 2017-2018 AT&T Intellectual Property. All rights reserved.
   6  * Copyright © 2017-2018 Amdocs
   7  * ================================================================================
   8  * Licensed under the Apache License, Version 2.0 (the "License");
   9  * you may not use this file except in compliance with the License.
  10  * You may obtain a copy of the License at
  11  *
  12  *       http://www.apache.org/licenses/LICENSE-2.0
  13  *
  14  * Unless required by applicable law or agreed to in writing, software
  15  * distributed under the License is distributed on an "AS IS" BASIS,
  16  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  17  * See the License for the specific language governing permissions and
  18  * limitations under the License.
  19  * ============LICENSE_END=========================================================
  20  */
  21 package org.onap.crud.service;
  22
  23 import java.util.ArrayList;
  24 import java.util.HashMap;
  25 import java.util.List;
  26 import java.util.Map;
  27 import java.util.Set;
  28 import javax.ws.rs.core.EntityTag;
  29 import javax.ws.rs.core.HttpHeaders;
  30 import javax.ws.rs.core.Response.Status;
  31 import org.apache.commons.lang3.tuple.ImmutablePair;
  32 import org.onap.aai.restclient.client.OperationResult;
  33 import org.onap.crud.dao.GraphDao;
  34 import org.onap.crud.dao.champ.ChampEdgeSerializer;
  35 import org.onap.crud.dao.champ.ChampVertexSerializer;
  36 import org.onap.crud.entity.Edge;
  37 import org.onap.crud.entity.Vertex;
  38 import org.onap.crud.exception.CrudException;
  39 import org.onap.crud.parser.BulkPayload;
  40 import org.onap.crud.parser.CrudResponseBuilder;
  41 import org.onap.crud.parser.EdgePayload;
  42 import org.onap.crud.parser.VertexPayload;
  43 import org.onap.crud.parser.util.EdgePayloadUtil;
  44 import org.onap.crud.util.CrudServiceUtil;
  45 import org.onap.schema.validation.OxmModelValidator;
  46 import org.onap.schema.validation.RelationshipSchemaValidator;
  47 import com.google.gson.Gson;
  48 import com.google.gson.GsonBuilder;
  49 import com.google.gson.JsonElement;
  50 import com.google.gson.reflect.TypeToken;
  51 import net.dongliu.gson.GsonJava8TypeAdapterFactory;
  52
  53 public abstract class AbstractGraphDataService {
  54   protected GraphDao daoForGet;
  55   protected GraphDao dao;
  56
  57   public AbstractGraphDataService() throws CrudException {
  58     CrudServiceUtil.loadModels();
  59   }
  60
  61   public ImmutablePair<EntityTag, String> getEdge(String version, String id, String type, Map<String, String> queryParams) throws CrudException {
  62     RelationshipSchemaValidator.validateType(version, type);
  63     OperationResult operationResult = daoForGet.getEdge(id, type, queryParams);
  64     EntityTag entityTag = CrudServiceUtil.getETagFromHeader(operationResult.getHeaders());
  65     Edge edge = Edge.fromJson(operationResult.getResult());
  66     return new ImmutablePair<>(entityTag, CrudResponseBuilder.buildGetEdgeResponse(RelationshipSchemaValidator.validateOutgoingPayload(version, edge), version));
  67   }
  68
  69   public ImmutablePair<EntityTag, String> getEdges(String version, String type, Map<String, String> filter) throws CrudException {
  70      Gson champGson = new GsonBuilder()
  71               .registerTypeAdapterFactory(new GsonJava8TypeAdapterFactory())
  72               .registerTypeAdapter(Vertex.class, new ChampVertexSerializer())
  73               .registerTypeAdapter(Edge.class, new ChampEdgeSerializer()).create();
  74     RelationshipSchemaValidator.validateType(version, type);
  75     OperationResult operationResult = daoForGet.getEdges(type, RelationshipSchemaValidator.resolveCollectionfilter(version, type, filter));
  76     List<Edge> items = champGson.fromJson(operationResult.getResult(), new TypeToken<List<Edge>>() {
  77     }.getType());
  78     EntityTag entityTag = CrudServiceUtil.getETagFromHeader(operationResult.getHeaders());
  79     return new ImmutablePair<>(entityTag, CrudResponseBuilder.buildGetEdgesResponse(items, version));
  80   }
  81
  82   public ImmutablePair<EntityTag, String> getVertex(String version, String id, String type, Map<String, String> queryParams) throws CrudException {
  83     type = OxmModelValidator.resolveCollectionType(version, type);
  84     OperationResult vertexOpResult = daoForGet.getVertex(id, type, version, queryParams);
  85     Vertex vertex = Vertex.fromJson(vertexOpResult.getResult(), version);
  86     List<Edge> edges = daoForGet.getVertexEdges(id, queryParams);
  87     EntityTag entityTag = CrudServiceUtil.getETagFromHeader(vertexOpResult.getHeaders());
  88     return new ImmutablePair<>(entityTag, CrudResponseBuilder.buildGetVertexResponse(OxmModelValidator.validateOutgoingPayload(version, vertex), edges,
  89         version));
  90   }
  91
  92   public ImmutablePair<EntityTag, String> getVertices(String version, String type, Map<String, String> filter, Set<String> properties) throws CrudException {
  93     type = OxmModelValidator.resolveCollectionType(version, type);
  94     OperationResult operationResult = daoForGet.getVertices(type, OxmModelValidator.resolveCollectionfilter(version, type, filter), properties, version);
  95     List<Vertex> vertices = Vertex.collectionFromJson(operationResult.getResult(), version);
  96     EntityTag entityTag = CrudServiceUtil.getETagFromHeader(operationResult.getHeaders());
  97     return new ImmutablePair<>(entityTag, CrudResponseBuilder.buildGetVerticesResponse(vertices, version));
  98   }
  99
 100   public String addBulk(String version, BulkPayload payload, HttpHeaders headers) throws CrudException {
 101     HashMap<String, Vertex> vertices = new HashMap<>();
 102     HashMap<String, Edge> edges = new HashMap<>();
 103
 104     String txId = dao.openTransaction();
 105
 106     try {
 107       // Step 1. Handle edge deletes (must happen before vertex deletes)
 108       for (JsonElement v : payload.getRelationships()) {
 109         List<Map.Entry<String, JsonElement>> entries = new ArrayList<Map.Entry<String, JsonElement>>(
 110             v.getAsJsonObject().entrySet());
 111
 112         if (entries.size() != 2) {
 113           throw new CrudException("", Status.BAD_REQUEST);
 114         }
 115         Map.Entry<String, JsonElement> opr = entries.get(0);
 116         Map.Entry<String, JsonElement> item = entries.get(1);
 117         EdgePayload edgePayload = EdgePayload.fromJson(item.getValue().getAsJsonObject().toString());
 118
 119         if (opr.getValue().getAsString().equalsIgnoreCase("delete")) {
 120           RelationshipSchemaValidator.validateType(version, edgePayload.getType());
 121           deleteBulkEdge(edgePayload.getId(), version, edgePayload.getType(), txId);
 122         }
 123       }
 124
 125       // Step 2: Handle vertex deletes
 126       for (JsonElement v : payload.getObjects()) {
 127         List<Map.Entry<String, JsonElement>> entries = new ArrayList<Map.Entry<String, JsonElement>>(
 128             v.getAsJsonObject().entrySet());
 129
 130         if (entries.size() != 2) {
 131           throw new CrudException("", Status.BAD_REQUEST);
 132         }
 133
 134         Map.Entry<String, JsonElement> opr = entries.get(0);
 135         Map.Entry<String, JsonElement> item = entries.get(1);
 136         VertexPayload vertexPayload = VertexPayload.fromJson(item.getValue().getAsJsonObject().toString());
 137
 138         if (opr.getValue().getAsString().equalsIgnoreCase("delete")) {
 139           String type = OxmModelValidator.resolveCollectionType(version, vertexPayload.getType());
 140           deleteBulkVertex(vertexPayload.getId(), version, type, txId);
 141         }
 142       }
 143
 144       // Step 3: Handle vertex add/modify (must happen before edge adds)
 145       for (JsonElement v : payload.getObjects()) {
 146         List<Map.Entry<String, JsonElement>> entries = new ArrayList<Map.Entry<String, JsonElement>>(
 147             v.getAsJsonObject().entrySet());
 148
 149         if (entries.size() != 2) {
 150           throw new CrudException("", Status.BAD_REQUEST);
 151         }
 152         Map.Entry<String, JsonElement> opr = entries.get(0);
 153         Map.Entry<String, JsonElement> item = entries.get(1);
 154         VertexPayload vertexPayload = VertexPayload.fromJson(item.getValue().getAsJsonObject().toString());
 155
 156         // Add vertex
 157         if (opr.getValue().getAsString().equalsIgnoreCase("add")) {
 158           vertexPayload.setProperties(CrudServiceUtil.mergeHeaderInFoToPayload(vertexPayload.getProperties(),
 159               headers, true));
 160           Vertex validatedVertex = OxmModelValidator.validateIncomingUpsertPayload(null, version, vertexPayload.getType(),
 161               vertexPayload.getProperties());
 162           Vertex persistedVertex = addBulkVertex(validatedVertex, version, txId);
 163           Vertex outgoingVertex = OxmModelValidator.validateOutgoingPayload(version, persistedVertex);
 164           vertices.put(item.getKey(), outgoingVertex);
 165         }
 166
 167         // Update vertex
 168         else if (opr.getValue().getAsString().equalsIgnoreCase("modify")) {
 169           vertexPayload.setProperties(CrudServiceUtil.mergeHeaderInFoToPayload(vertexPayload.getProperties(),
 170               headers, false));
 171           Vertex validatedVertex = OxmModelValidator.validateIncomingUpsertPayload(vertexPayload.getId(), version,
 172               vertexPayload.getType(), vertexPayload.getProperties());
 173           Vertex persistedVertex = updateBulkVertex(validatedVertex, vertexPayload.getId(), version, txId);
 174           Vertex outgoingVertex = OxmModelValidator.validateOutgoingPayload(version, persistedVertex);
 175           vertices.put(item.getKey(), outgoingVertex);
 176         }
 177
 178         // Patch vertex
 179         else if (opr.getValue().getAsString().equalsIgnoreCase("patch")) {
 180           if ( (vertexPayload.getId() == null) || (vertexPayload.getType() == null) ) {
 181             throw new CrudException("id and type must be specified for patch request", Status.BAD_REQUEST);
 182           }
 183
 184           vertexPayload.setProperties(CrudServiceUtil.mergeHeaderInFoToPayload(vertexPayload.getProperties(),
 185               headers, false));
 186
 187           OperationResult existingVertexOpResult = dao.getVertex(vertexPayload.getId(), OxmModelValidator.resolveCollectionType(version, vertexPayload.getType()), version, new HashMap<String, String>());
 188           Vertex existingVertex = Vertex.fromJson(existingVertexOpResult.getResult(), version);
 189           Vertex validatedVertex = OxmModelValidator.validateIncomingPatchPayload(vertexPayload.getId(),
 190               version, vertexPayload.getType(), vertexPayload.getProperties(), existingVertex);
 191           Vertex persistedVertex = updateBulkVertex(validatedVertex, vertexPayload.getId(), version, txId);
 192           Vertex outgoingVertex = OxmModelValidator.validateOutgoingPayload(version, persistedVertex);
 193           vertices.put(item.getKey(), outgoingVertex);
 194         }
 195       }
 196
 197       // Step 4: Handle edge add/modify
 198       for (JsonElement v : payload.getRelationships()) {
 199         List<Map.Entry<String, JsonElement>> entries = new ArrayList<Map.Entry<String, JsonElement>>(
 200             v.getAsJsonObject().entrySet());
 201
 202         if (entries.size() != 2) {
 203           throw new CrudException("", Status.BAD_REQUEST);
 204         }
 205         Map.Entry<String, JsonElement> opr = entries.get(0);
 206         Map.Entry<String, JsonElement> item = entries.get(1);
 207         EdgePayload edgePayload = EdgePayload.fromJson(item.getValue().getAsJsonObject().toString());
 208
 209         // Add/Update edge
 210         if (opr.getValue().getAsString().equalsIgnoreCase("add")
 211             || opr.getValue().getAsString().equalsIgnoreCase("modify")
 212             || opr.getValue().getAsString().equalsIgnoreCase("patch")) {
 213           Edge validatedEdge;
 214           Edge persistedEdge;
 215           if (opr.getValue().getAsString().equalsIgnoreCase("add")) {
 216             // Fix the source/destination
 217             if (edgePayload.getSource().startsWith("$")) {
 218               Vertex source = vertices.get(edgePayload.getSource().substring(1));
 219               if (source == null) {
 220                 throw new CrudException("Not able to find vertex: " + edgePayload.getSource().substring(1),
 221                     Status.INTERNAL_SERVER_ERROR);
 222               }
 223               edgePayload
 224                   .setSource("services/inventory/" + version + "/" + source.getType() + "/" + source.getId().get());
 225             }
 226             if (edgePayload.getTarget().startsWith("$")) {
 227               Vertex target = vertices.get(edgePayload.getTarget().substring(1));
 228               if (target == null) {
 229                 throw new CrudException("Not able to find vertex: " + edgePayload.getTarget().substring(1),
 230                     Status.INTERNAL_SERVER_ERROR);
 231               }
 232               edgePayload
 233                   .setTarget("services/inventory/" + version + "/" + target.getType() + "/" + target.getId().get());
 234             }
 235
 236             List<Edge> sourceVertexEdges =
 237                     EdgePayloadUtil.filterEdgesByRelatedVertexAndType(EdgePayloadUtil.getVertexNodeType(edgePayload.getSource()), edgePayload.getType(),
 238                                  daoForGet.getVertexEdges(EdgePayloadUtil.getVertexNodeId(edgePayload.getSource()), null));
 239
 240             List<Edge> targetVertexEdges =
 241                      EdgePayloadUtil.filterEdgesByRelatedVertexAndType(EdgePayloadUtil.getVertexNodeType(edgePayload.getTarget()), edgePayload.getType(),
 242                                  daoForGet.getVertexEdges(EdgePayloadUtil.getVertexNodeId(edgePayload.getTarget()), null));
 243
 244             validatedEdge = RelationshipSchemaValidator.validateIncomingAddPayload(version, edgePayload.getType(), edgePayload, sourceVertexEdges,
 245                     targetVertexEdges);
 246             persistedEdge = addBulkEdge(validatedEdge, version, txId);
 247           } else if (opr.getValue().getAsString().equalsIgnoreCase("modify")) {
 248             Edge edge = dao.getEdge(edgePayload.getId(), edgePayload.getType(), txId);
 249
 250             // load source and target vertex relationships for validation
 251             List<Edge> sourceVertexEdges =
 252                    EdgePayloadUtil.filterEdgesByRelatedVertexAndType(EdgePayloadUtil.getVertexNodeType(edgePayload.getSource()), edgePayload.getType(),
 253                                 daoForGet.getVertexEdges(EdgePayloadUtil.getVertexNodeId(edgePayload.getSource()), null));
 254
 255             List<Edge> targetVertexEdges =
 256                     EdgePayloadUtil.filterEdgesByRelatedVertexAndType(EdgePayloadUtil.getVertexNodeType(edgePayload.getTarget()), edgePayload.getType(),
 257                                 daoForGet.getVertexEdges(EdgePayloadUtil.getVertexNodeId(edgePayload.getTarget()), null));
 258
 259             validatedEdge = RelationshipSchemaValidator.validateIncomingUpdatePayload(edge, version, edgePayload, edgePayload.getType(), sourceVertexEdges, targetVertexEdges);
 260             persistedEdge = updateBulkEdge(validatedEdge, version, txId);
 261           } else {
 262             if ( (edgePayload.getId() == null) || (edgePayload.getType() == null) ) {
 263               throw new CrudException("id and type must be specified for patch request", Status.BAD_REQUEST);
 264             }
 265             Edge existingEdge = dao.getEdge(edgePayload.getId(), edgePayload.getType(), txId);
 266             Edge patchedEdge = RelationshipSchemaValidator.validateIncomingPatchPayload(existingEdge, version, edgePayload);
 267             persistedEdge = updateBulkEdge(patchedEdge, version, txId);
 268           }
 269
 270
 271           Edge outgoingEdge = RelationshipSchemaValidator.validateOutgoingPayload(version, persistedEdge);
 272           edges.put(item.getKey(), outgoingEdge);
 273         }
 274       }
 275
 276       // commit transaction
 277       dao.commitTransaction(txId);
 278     } catch (CrudException ex) {
 279       dao.rollbackTransaction(txId);
 280       throw ex;
 281     } catch (Exception ex) {
 282       dao.rollbackTransaction(txId);
 283       throw ex;
 284     } finally {
 285       if (dao.transactionExists(txId)) {
 286         dao.rollbackTransaction(txId);
 287       }
 288     }
 289
 290     return CrudResponseBuilder.buildUpsertBulkResponse(vertices, edges, version, payload);
 291   }
 292
 293
 294   public abstract ImmutablePair<EntityTag, String> addVertex(String version, String type, VertexPayload payload)
 295             throws CrudException;
 296   public abstract ImmutablePair<EntityTag, String> updateVertex(String version, String id, String type,
 297             VertexPayload payload) throws CrudException;
 298   public abstract ImmutablePair<EntityTag, String> patchVertex(String version, String id, String type,
 299             VertexPayload payload) throws CrudException;
 300   public abstract String deleteVertex(String version, String id, String type) throws CrudException;
 301   public abstract ImmutablePair<EntityTag, String> addEdge(String version, String type, EdgePayload payload)
 302             throws CrudException;
 303   public abstract String deleteEdge(String version, String id, String type) throws CrudException;
 304   public abstract ImmutablePair<EntityTag, String> updateEdge(String version, String id, String type,
 305             EdgePayload payload) throws CrudException;
 306   public abstract ImmutablePair<EntityTag, String> patchEdge(String version, String id, String type,
 307             EdgePayload payload) throws CrudException;
 308
 309   protected abstract Vertex addBulkVertex(Vertex vertex, String version, String dbTransId) throws CrudException;
 310   protected abstract Vertex updateBulkVertex(Vertex vertex, String id, String version, String dbTransId) throws CrudException;
 311   protected abstract void deleteBulkVertex(String id, String version, String type, String dbTransId) throws CrudException;
 312
 313   protected abstract Edge addBulkEdge(Edge edge, String version, String dbTransId) throws CrudException;
 314   protected abstract Edge updateBulkEdge(Edge edge, String version, String dbTransId) throws CrudException;
 315   protected abstract void deleteBulkEdge(String id, String version, String type, String dbTransId) throws CrudException;
 316
 317 }