gerrit.onap Code Review - ccsdk/features.git/blob

   1 /*
   2  * ============LICENSE_START========================================================================
   3  * ONAP : ccsdk feature sdnr wt
   4  * =================================================================================================
   5  * Copyright (C) 2019 highstreet technologies GmbH Intellectual Property. All rights reserved.
   6  * =================================================================================================
   7  * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
   8  * in compliance with the License. You may obtain a copy of the License at
   9  *
  10  * http://www.apache.org/licenses/LICENSE-2.0
  11  *
  12  * Unless required by applicable law or agreed to in writing, software distributed under the License
  13  * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
  14  * or implied. See the License for the specific language governing permissions and limitations under
  15  * the License.
  16  * ============LICENSE_END==========================================================================
  17  */
  18 /**
  19  * Convert capabilities of netconfnode into internal format. Boron and Carbon are providing
  20  * different versions
  21  */
  22 package org.onap.ccsdk.features.sdnr.wt.netconfnodestateservice;
  23
  24 import java.lang.reflect.InvocationTargetException;
  25 import java.lang.reflect.Method;
  26 import java.text.DateFormat;
  27 import java.text.SimpleDateFormat;
  28 import java.util.ArrayList;
  29 import java.util.Arrays;
  30 import java.util.Date;
  31 import java.util.List;
  32 import java.util.Optional;
  33 import javax.annotation.Nullable;
  34 import org.eclipse.jdt.annotation.NonNull;
  35 import org.opendaylight.yang.gen.v1.urn.opendaylight.netconf.node.topology.rev150114.NetconfNode;
  36 import org.opendaylight.yang.gen.v1.urn.opendaylight.netconf.node.topology.rev150114.netconf.node.connection.status.AvailableCapabilities;
  37 import org.opendaylight.yang.gen.v1.urn.opendaylight.netconf.node.topology.rev150114.netconf.node.connection.status.UnavailableCapabilities;
  38 import org.opendaylight.yangtools.yang.common.QName;
  39 import org.slf4j.Logger;
  40 import org.slf4j.LoggerFactory;
  41
  42 /**
  43  * Wrapper class for capabilites for Boron and later releases. Uses generics because yang model was changed from Boron
  44  * to later version. Interface class:
  45  * org.opendaylight.yang.gen.v1.urn.opendaylight.netconf.node.topology.rev150114.netconf.node.connection.status.available.capabilities.AvailableCapability
  46  */
  47 public class Capabilities {
  48
  49     private static final Logger LOG = LoggerFactory.getLogger(Capabilities.class);
  50
  51     private static final String METHODNAME = "getCapability";
  52     private static final String UNSUPPORTED = "Unsupported";
  53     private final List<String> capabilities = new ArrayList<>();
  54     private final DateFormat formatter = new SimpleDateFormat("yyyy-MM-dd");
  55
  56     private Capabilities() {}
  57
  58     @SuppressWarnings("null")
  59     public static Capabilities getAvailableCapabilities(@Nullable NetconfNode nnode) {
  60         LOG.info("GetAvailableCapabilities for node");
  61         Capabilities capabilities = new Capabilities();
  62         if (nnode != null) {
  63             AvailableCapabilities availableCapabilites = nnode.getAvailableCapabilities();
  64             if (availableCapabilites != null) {
  65                 capabilities.constructor(availableCapabilites.getAvailableCapability());
  66             } else {
  67                 LOG.debug("empty capabilites");
  68             }
  69         } else {
  70             LOG.debug("No node provided");
  71         }
  72         return capabilities;
  73     }
  74
  75     @SuppressWarnings("null")
  76     public static Capabilities getUnavailableCapabilities(NetconfNode nnode) {
  77         LOG.info("GetUnavailableCapabilities for node");
  78         Capabilities capabilities = new Capabilities();
  79         if (nnode != null) {
  80             UnavailableCapabilities availableCapabilites = nnode.getUnavailableCapabilities();
  81             if (availableCapabilites != null) {
  82                 capabilities.constructor(availableCapabilites.getUnavailableCapability());
  83             } else {
  84                 LOG.debug("empty capabilites");
  85             }
  86         } else {
  87             LOG.debug("No node provided");
  88         }
  89         return capabilities;
  90     }
  91
  92
  93     /**
  94      * Does all construction steps
  95      *
  96      * @param pcapabilities with a list of capabilities. <br>
  97      *        Type could be <br>
  98      *        - Boron: List<code><String></code> <br>
  99      *        - Carbon: List<AvailableCapability>
 100      */
 101     private void constructor(List<@NonNull ?> pcapabilities) {
 102         if (pcapabilities != null) {
 103             Method methodGetCapability;
 104
 105             for (Object capability : pcapabilities) {
 106                 if (capability instanceof String) { // ODL Boron specific
 107                     this.capabilities.add((String) capability);
 108                 } else { // Carbon specific part .. handled via generics
 109                     try {
 110                         methodGetCapability = capability.getClass().getDeclaredMethod(METHODNAME);
 111                         methodGetCapability.setAccessible(true);
 112                         this.capabilities.add(methodGetCapability.invoke(capability).toString());
 113                     } catch (NoSuchMethodException | SecurityException | IllegalAccessException
 114                             | IllegalArgumentException | InvocationTargetException e) {
 115                         LOG.warn("Capability class with missing interface method {}: {} {} {}", METHODNAME,
 116                                 e.getMessage(), capability.getClass(),
 117                                 Arrays.toString(capability.getClass().getInterfaces()));
 118                     }
 119                 }
 120             }
 121         }
 122     }
 123
 124     /**
 125      * Get Capabilites
 126      *
 127      * @return List<String> with capabilites
 128      */
 129     public List<String> getCapabilities() {
 130         return capabilities;
 131     }
 132
 133     /**
 134      * Verify if the namespace is supported
 135      * @param qCapability from model
 136      * @return true if namespace is supported
 137      */
 138     public boolean isSupportingNamespace(QName qCapability) {
 139         String namespace = qCapability.getNamespace().toString();
 140         return isSupportingNamespaceAndRevision(namespace, null);
 141     }
 142
 143     /**
 144      * Verify if the namespace is supported
 145      * @param namespace
 146      * @return
 147      */
 148     public boolean isSupportingNamespace(String namespace) {
 149         return isSupportingNamespaceAndRevision(namespace, null);
 150     }
 151
 152     /**
 153      * check if the namespace and its revision are supported by the given capabilities
 154      * @param qCapability capability from the model
 155      * @return true if supporting the model AND revision<br>
 156      *         false if revision not available or both not found.
 157      */
 158     public boolean isSupportingNamespaceAndRevision(QName qCapability) {
 159
 160         String namespace = qCapability.getNamespace().toString();
 161         String revision = getRevisionString(qCapability);
 162         return revision == null ? false : isSupportingNamespaceAndRevision(namespace, revision);
 163     }
 164
 165     /**
 166      *
 167      * @param namespace requested
 168      * @param revision request or null for any revision
 169      * @return true if existing
 170      */
 171     public boolean isSupportingNamespaceAndRevision(String namespace, @Nullable String revision) {
 172         LOG.trace("isSupportingNamespaceAndRevision: Model namespace {}?[revision {}]", namespace, revision);
 173         for (String capability : capabilities) {
 174             if (capability.contains(namespace) && (revision == null || capability.contains(revision))) {
 175                 LOG.trace("Verify true with: {}", capability);
 176                 return true;
 177             } else {
 178                 LOG.trace("Verify false with: {}", capability);
 179             }
 180         }
 181         return false;
 182     }
 183
 184     /**
 185      * Provide revision as String from QName, considering older formats.
 186      *
 187      * @param qCapability that specifies the revision
 188      * @return String with revisiondate or null
 189      */
 190     private String getRevisionString(QName qCapability) {
 191         Object revisionObject = qCapability.getRevision();
 192         String revision = null;
 193         if (revisionObject instanceof Optional) {
 194             if (((Optional<?>) revisionObject).isPresent()) {
 195                 revisionObject = ((Optional<?>) revisionObject).get();
 196                 LOG.info("Unwrapp Optional: {}", revisionObject != null ? revisionObject.getClass() : null);
 197             }
 198         }
 199         if (revisionObject == null) {
 200             // Cover null case
 201         } else if (revisionObject instanceof String) {
 202             revision = (String) revisionObject;
 203         } else if (revisionObject instanceof Date) {
 204             revision = formatter.format((Date) revisionObject);
 205         } else {
 206             revision = revisionObject.toString();
 207             LOG.debug("Revision number type not supported. Use toString().String:{} Class:{} ", revisionObject,
 208                     revisionObject.getClass().getName());
 209         }
 210         return revision;
 211     }
 212
 213     /**
 214      * Get revision of first entry of related capability
 215      *
 216      * @param qCapability that specifies the namespace
 217      * @return String with date or
 218      */
 219     public String getRevisionForNamespace(QName qCapability) {
 220         String namespace = qCapability.getNamespace().toString();
 221         for (String capability : capabilities) {
 222             if (capability.contains(namespace)) {
 223                 return QName.create(capability).getRevision().get().toString();
 224             }
 225         }
 226         return UNSUPPORTED;
 227     }
 228
 229     /**
 230      * Verify if QName namespace is supported by capabilities
 231      * @param revision result of getRevisionForNamespace()
 232      * @return true if namespace is supported.
 233      */
 234     static public boolean isNamespaceSupported(String revision) {
 235         return revision != UNSUPPORTED;
 236     }
 237
 238     @Override
 239     public String toString() {
 240         return "Capabilities [capabilities=" + capabilities + "]";
 241     }
 242
 243 }