common/src/main/java/org/openecomp/mso/client/aai/entities/uri/AAIUri.java

   1 /*-
   2  * ============LICENSE_START=======================================================
   3  * ONAP - SO
   4  * ================================================================================
   5  * Copyright (C) 2017 AT&T Intellectual Property. All rights reserved.
   6  * ================================================================================
   7  * Licensed under the Apache License, Version 2.0 (the "License");
   8  * you may not use this file except in compliance with the License.
   9  * You may obtain a copy of the License at
  10  *
  11  *      http://www.apache.org/licenses/LICENSE-2.0
  12  *
  13  * Unless required by applicable law or agreed to in writing, software
  14  * distributed under the License is distributed on an "AS IS" BASIS,
  15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16  * See the License for the specific language governing permissions and
  17  * limitations under the License.
  18  * ============LICENSE_END=========================================================
  19  */
  20
  21 package org.openecomp.mso.client.aai.entities.uri;
  22
  23 import java.net.URI;
  24 import java.util.Map;
  25
  26 import org.openecomp.mso.client.aai.AAIObjectPlurals;
  27 import org.openecomp.mso.client.aai.AAIObjectType;
  28
  29 public interface AAIUri {
  30
  31         public URI build();
  32         /**
  33          * By default A&AI enforces a depth of 1. Some objects can be told to retrieve objects
  34          * nested beneath them by increasing this number.
  35          *
  36          * You can use 0 to restrict the returned information to only the object you requested
  37          * You can use all to retrieve all nested objects (this should only be used if you really need a massive amount of information and are caching the retrieval)
  38          * @param depth
  39          * @return
  40          */
  41         public AAIUri depth(Depth depth);
  42         /**
  43          * Makes client only return object fields, no relationships
  44          *
  45          * @return
  46          */
  47         public AAIUri nodesOnly(boolean nodesOnly);
  48         public AAIUri queryParam(String name, String... values);
  49         public AAIUri clone();
  50
  51         /**
  52          * returns all key values of the URI as a map. Key names can be found in {@link AAIObjectType}
  53          * @return
  54          */
  55         public Map<String, String> getURIKeys();
  56         public AAIObjectType getObjectType();
  57         public boolean equals(Object o);
  58 }