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
  44  * changed from Boron 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 final List<String> capabilities = new ArrayList<>();
  53     private final DateFormat formatter = new SimpleDateFormat("yyyy-MM-dd");
  54
  55     private Capabilities() {}
  56
  57     @SuppressWarnings("null")
  58     public static Capabilities getAvailableCapabilities(@Nullable NetconfNode nnode) {
  59         LOG.info("GetAvailableCapabilities for node");
  60         Capabilities capabilities = new Capabilities();
  61         if (nnode != null) {
  62             AvailableCapabilities availableCapabilites = nnode.getAvailableCapabilities();
  63             if (availableCapabilites != null) {
  64                    capabilities.constructor(availableCapabilites.getAvailableCapability());
  65             } else {
  66                 LOG.debug("empty capabilites");
  67             }
  68         } else {
  69             LOG.debug("No node provided");
  70         }
  71         return capabilities;
  72     }
  73
  74     @SuppressWarnings("null")
  75     public static Capabilities getUnavailableCapabilities(NetconfNode nnode) {
  76         LOG.info("GetAvailableCapabilities for node");
  77         Capabilities capabilities = new Capabilities();
  78         if (nnode != null) {
  79             UnavailableCapabilities availableCapabilites = nnode.getUnavailableCapabilities();
  80             if (availableCapabilites != null) {
  81                    capabilities.constructor(availableCapabilites.getUnavailableCapability());
  82             } else {
  83                 LOG.debug("empty capabilites");
  84             }
  85         } else {
  86             LOG.debug("No node provided");
  87         }
  88         return capabilities;
  89     }
  90
  91
  92     /**
  93      * Does all construction steps
  94      *
  95      * @param pcapabilities with a list of capabilities. <br>
  96      *        Type could be <br>
  97      *        - Boron: List<code><String></code> <br>
  98      *        - Carbon: List<AvailableCapability>
  99      */
 100     private void constructor(List<@NonNull ?> pcapabilities) {
 101         if (pcapabilities != null) {
 102             Method methodGetCapability;
 103
 104             for (Object capability : pcapabilities) {
 105                if (capability instanceof String) { // ODL Boron specific
 106                     this.capabilities.add((String) capability);
 107                 } else { // Carbon specific part .. handled via generics
 108                     try {
 109                         methodGetCapability = capability.getClass().getDeclaredMethod(METHODNAME);
 110                         methodGetCapability.setAccessible(true);
 111                         this.capabilities.add(methodGetCapability.invoke(capability).toString());
 112                     } catch (NoSuchMethodException | SecurityException | IllegalAccessException
 113                             | IllegalArgumentException | InvocationTargetException e) {
 114                         LOG.warn("Capability class with missing interface method {}: {} {} {}", METHODNAME,
 115                                 e.getMessage(), capability.getClass(),
 116                                 Arrays.toString(capability.getClass().getInterfaces()));
 117                     }
 118                 }
 119             }
 120         }
 121     }
 122
 123     /**
 124      * Get Capabilites
 125      * @return List<String> with capabilites
 126      */
 127     public List<String> getCapabilities() {
 128         return capabilities;
 129     }
 130
 131     /**
 132      * Verify if the namespace is supported
 133      * @param qCapability from model
 134      * @return true if namespace is supported
 135      */
 136     public boolean isSupportingNamespace(QName qCapability) {
 137
 138         String namespace = qCapability.getNamespace().toString();
 139
 140         return isSupportingNamespaceAndRevision(namespace, null);
 141
 142     }
 143
 144     /**
 145      * check if the namespace and its revision are supported by the given capabilities
 146      *
 147      * @param qCapability capability from the model
 148      * @return true if supporting the model AND revision<br>
 149      * false if revision not available or both not found.
 150      */
 151     public boolean isSupportingNamespaceAndRevision(QName qCapability) {
 152
 153         String namespace = qCapability.getNamespace().toString();
 154         String revision = getRevisionString(qCapability);
 155         return revision == null ? false : isSupportingNamespaceAndRevision(namespace, revision);
 156     }
 157
 158     /**
 159      *
 160      * @param namespace requested
 161      * @param revision request or null for any revision
 162      * @return true if existing
 163      */
 164     private boolean isSupportingNamespaceAndRevision(String namespace, @Nullable String revision) {
 165         LOG.trace("isSupportingNamespaceAndRevision: Model namespace {}?[revision {}]", namespace, revision);
 166         for (String capability : capabilities) {
 167             if (capability.contains(namespace) && (revision == null || capability.contains(revision))) {
 168                 LOG.trace("Verify true with: {}", capability);
 169                 return true;
 170             } else {
 171                 LOG.trace("Verify false with: {}", capability);
 172             }
 173         }
 174         return false;
 175     }
 176
 177     /**
 178      * Provide revision as String from QName, considering older formats.
 179      * @param qCapability that specifies the revision
 180      * @return String with revisiondate or null
 181      */
 182     private String getRevisionString(QName qCapability) {
 183         Object revisionObject = qCapability.getRevision();
 184         String revision = null;
 185         if (revisionObject instanceof Optional) {
 186             if (((Optional<?>) revisionObject).isPresent()) {
 187                 revisionObject = ((Optional<?>) revisionObject).get();
 188                 LOG.info("Unwrapp Optional: {}", revisionObject != null ? revisionObject.getClass() : null);
 189             }
 190         }
 191         if (revisionObject == null) {
 192             // Cover null case
 193         } else if (revisionObject instanceof String) {
 194             revision = (String) revisionObject;
 195         } else if (revisionObject instanceof Date) {
 196             revision = formatter.format((Date) revisionObject);
 197         } else {
 198             revision = revisionObject.toString();
 199             LOG.debug("Revision number type not supported. Use toString().String:{} Class:{} ", revisionObject,
 200                     revisionObject.getClass().getName());
 201         }
 202         return revision;
 203     }
 204
 205     /**
 206      * Get revision of first entry of related capability
 207      * @param qCapability that specifies the namespace
 208      * @return String with date or
 209      */
 210     public String getRevisionForNamespace(QName qCapability) {
 211         String namespace = qCapability.getNamespace().toString();
 212        for (String capability : capabilities) {
 213             if (capability.contains(namespace)) {
 214                 return QName.create(capability).getRevision().get().toString();
 215             }
 216         }
 217         return "Unsupported";
 218     }
 219
 220
 221     @Override
 222     public String toString() {
 223         return "Capabilities [capabilities=" + capabilities + "]";
 224     }
 225
 226 }