binding/mdsal-binding-dom-adapter/src/main/java/org/opendaylight/mdsal/binding/dom/adapter/CurrentAdapterSerializer.java

   1 /*
   2  * Copyright (c) 2020 PANTHEON.tech, s.r.o. and others.  All rights reserved.
   3  *
   4  * This program and the accompanying materials are made available under the
   5  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
   6  * and is available at http://www.eclipse.org/legal/epl-v10.html
   7  */
   8 package org.opendaylight.mdsal.binding.dom.adapter;
   9
  10 import static com.google.common.base.Verify.verify;
  11 import static com.google.common.base.Verify.verifyNotNull;
  12 import static java.util.Objects.requireNonNull;
  13
  14 import com.google.common.annotations.Beta;
  15 import com.google.common.annotations.VisibleForTesting;
  16 import com.google.common.cache.CacheBuilder;
  17 import com.google.common.cache.CacheLoader;
  18 import com.google.common.cache.LoadingCache;
  19 import com.google.common.collect.ImmutableBiMap;
  20 import com.google.common.collect.ImmutableMap;
  21 import com.google.common.collect.Maps;
  22 import com.google.common.util.concurrent.ListenableFuture;
  23 import java.lang.invoke.MethodHandle;
  24 import java.lang.invoke.MethodHandles;
  25 import java.lang.invoke.MethodType;
  26 import java.lang.reflect.Method;
  27 import java.util.Collection;
  28 import java.util.Map;
  29 import java.util.Map.Entry;
  30 import java.util.concurrent.ConcurrentHashMap;
  31 import java.util.concurrent.ConcurrentMap;
  32 import java.util.stream.Collectors;
  33 import org.eclipse.jdt.annotation.NonNull;
  34 import org.eclipse.jdt.annotation.Nullable;
  35 import org.opendaylight.mdsal.binding.api.ActionSpec;
  36 import org.opendaylight.mdsal.binding.api.DataTreeIdentifier;
  37 import org.opendaylight.mdsal.binding.api.InstanceNotificationSpec;
  38 import org.opendaylight.mdsal.binding.dom.codec.spi.BindingDOMCodecServices;
  39 import org.opendaylight.mdsal.binding.dom.codec.spi.ForwardingBindingDOMCodecServices;
  40 import org.opendaylight.mdsal.binding.model.api.JavaTypeName;
  41 import org.opendaylight.mdsal.binding.runtime.api.InputRuntimeType;
  42 import org.opendaylight.mdsal.binding.spec.reflect.BindingReflections;
  43 import org.opendaylight.mdsal.dom.api.DOMDataTreeIdentifier;
  44 import org.opendaylight.yangtools.yang.binding.DataObject;
  45 import org.opendaylight.yangtools.yang.binding.InstanceIdentifier;
  46 import org.opendaylight.yangtools.yang.binding.RpcInput;
  47 import org.opendaylight.yangtools.yang.binding.RpcService;
  48 import org.opendaylight.yangtools.yang.binding.contract.Naming;
  49 import org.opendaylight.yangtools.yang.common.QName;
  50 import org.opendaylight.yangtools.yang.common.QNameModule;
  51 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier;
  52 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.AugmentationIdentifier;
  53 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.NodeIdentifier;
  54 import org.opendaylight.yangtools.yang.model.api.stmt.ActionEffectiveStatement;
  55 import org.opendaylight.yangtools.yang.model.api.stmt.ListEffectiveStatement;
  56 import org.opendaylight.yangtools.yang.model.api.stmt.NotificationEffectiveStatement;
  57 import org.opendaylight.yangtools.yang.model.api.stmt.SchemaNodeIdentifier.Absolute;
  58 import org.opendaylight.yangtools.yang.model.util.SchemaInferenceStack;
  59 import org.slf4j.Logger;
  60 import org.slf4j.LoggerFactory;
  61
  62 @Beta
  63 @VisibleForTesting
  64 public final class CurrentAdapterSerializer extends ForwardingBindingDOMCodecServices {
  65     private static final Logger LOG = LoggerFactory.getLogger(CurrentAdapterSerializer.class);
  66     @Deprecated
  67     private static final MethodType RPC_SERVICE_METHOD_SIGNATURE = MethodType.methodType(ListenableFuture.class,
  68         RpcService.class, RpcInput.class);
  69
  70     private final LoadingCache<InstanceIdentifier<?>, YangInstanceIdentifier> cache = CacheBuilder.newBuilder()
  71             .softValues().build(new CacheLoader<InstanceIdentifier<?>, YangInstanceIdentifier>() {
  72                 @Override
  73                 public YangInstanceIdentifier load(final InstanceIdentifier<?> key) {
  74                     return toYangInstanceIdentifier(key);
  75                 }
  76             });
  77
  78     private final ConcurrentMap<JavaTypeName, ContextReferenceExtractor> extractors = new ConcurrentHashMap<>();
  79     @Deprecated
  80     private final ConcurrentMap<Class<? extends RpcService>, ImmutableMap<QName, MethodHandle>> rpcMethods =
  81         new ConcurrentHashMap<>();
  82     private final @NonNull BindingDOMCodecServices delegate;
  83
  84     public CurrentAdapterSerializer(final BindingDOMCodecServices delegate) {
  85         this.delegate = requireNonNull(delegate);
  86     }
  87
  88     @Override
  89     protected BindingDOMCodecServices delegate() {
  90         return delegate;
  91     }
  92
  93     @NonNull YangInstanceIdentifier toCachedYangInstanceIdentifier(final @NonNull InstanceIdentifier<?> path) {
  94         return cache.getUnchecked(path);
  95     }
  96
  97     <T extends DataObject> @NonNull InstanceIdentifier<T> coerceInstanceIdentifier(final YangInstanceIdentifier dom) {
  98         return verifyNotNull(fromYangInstanceIdentifier(dom));
  99     }
 100
 101     DOMDataTreeIdentifier toDOMDataTreeIdentifier(final DataTreeIdentifier<?> path) {
 102         return new DOMDataTreeIdentifier(path.getDatastoreType(), toYangInstanceIdentifier(path.getRootIdentifier()));
 103     }
 104
 105     Collection<DOMDataTreeIdentifier> toDOMDataTreeIdentifiers(final Collection<DataTreeIdentifier<?>> subtrees) {
 106         return subtrees.stream().map(this::toDOMDataTreeIdentifier).collect(Collectors.toSet());
 107     }
 108
 109     @NonNull Absolute getActionPath(final @NonNull ActionSpec<?, ?> spec) {
 110         final var entry = resolvePath(spec.path());
 111         final var stack = entry.getKey();
 112         final var stmt = stack.enterSchemaTree(BindingReflections.findQName(spec.type()).bindTo(entry.getValue()));
 113         verify(stmt instanceof ActionEffectiveStatement, "Action %s resolved to unexpected statement %s", spec, stmt);
 114         return stack.toSchemaNodeIdentifier();
 115     }
 116
 117     @NonNull Absolute getNotificationPath(final @NonNull InstanceNotificationSpec<?, ?> spec) {
 118         final var entry = resolvePath(spec.path());
 119         final var stack = entry.getKey();
 120         final var stmt = stack.enterSchemaTree(BindingReflections.findQName(spec.type()).bindTo(entry.getValue()));
 121         verify(stmt instanceof NotificationEffectiveStatement, "Notification %s resolved to unexpected statement %s",
 122             spec, stmt);
 123         return stack.toSchemaNodeIdentifier();
 124     }
 125
 126     @Nullable ContextReferenceExtractor findExtractor(final @NonNull InputRuntimeType inputType) {
 127         final var inputName = inputType.getIdentifier();
 128         final var cached = extractors.get(inputName);
 129         if (cached != null) {
 130             return cached;
 131         }
 132
 133         // Load the class
 134         final Class<?> inputClass;
 135         try {
 136             inputClass = getRuntimeContext().loadClass(inputName);
 137         } catch (ClassNotFoundException e) {
 138             throw new IllegalArgumentException("Failed to load class for " + inputType, e);
 139         }
 140
 141         // Check if there is an extractor at all
 142         final var created = ContextReferenceExtractor.of(inputClass);
 143         if (created == null) {
 144             return null;
 145         }
 146
 147         // Reconcile with cache
 148         final var raced = extractors.putIfAbsent(inputName, created);
 149         return raced != null ? raced : created;
 150     }
 151
 152     @Deprecated
 153     @NonNull ImmutableMap<QName, MethodHandle> getRpcMethods(final @NonNull Class<? extends RpcService> serviceType) {
 154         return rpcMethods.computeIfAbsent(serviceType, ignored -> {
 155             final var lookup = MethodHandles.publicLookup();
 156             return ImmutableMap.copyOf(Maps.transformValues(createQNameToMethod(serviceType), method -> {
 157                 final MethodHandle raw;
 158                 try {
 159                     raw = lookup.unreflect(method);
 160                 } catch (IllegalAccessException e) {
 161                     throw new IllegalStateException("Lookup on public method failed", e);
 162                 }
 163                 return raw.asType(RPC_SERVICE_METHOD_SIGNATURE);
 164             }));
 165         });
 166     }
 167
 168     @Deprecated
 169     @VisibleForTesting
 170     // FIXME: This should be probably part of Binding Runtime context
 171     ImmutableMap<QName, Method> createQNameToMethod(final Class<? extends RpcService> key) {
 172         final var moduleName = BindingReflections.getQNameModule(key);
 173         final var runtimeContext = getRuntimeContext();
 174         final var module = runtimeContext.getEffectiveModelContext().findModule(moduleName).orElse(null);
 175         if (module == null) {
 176             LOG.trace("Schema for {} is not available; expected module name: {}; BindingRuntimeContext: {}",
 177                 key, moduleName, runtimeContext);
 178             throw new IllegalStateException(String.format("Schema for %s is not available; expected module name: %s;"
 179                 + " full BindingRuntimeContext available in trace log", key, moduleName));
 180         }
 181
 182         final var ret = ImmutableBiMap.<QName, Method>builder();
 183         try {
 184             for (var rpcDef : module.getRpcs()) {
 185                 final var rpcName = rpcDef.getQName();
 186                 ret.put(rpcName, key.getMethod(Naming.getRpcMethodName(rpcName), runtimeContext.getRpcInput(rpcName)));
 187             }
 188         } catch (NoSuchMethodException e) {
 189             throw new IllegalStateException("Rpc defined in model does not have representation in generated class.", e);
 190         }
 191         return ret.build();
 192     }
 193
 194     private @NonNull Entry<SchemaInferenceStack, QNameModule> resolvePath(final @NonNull InstanceIdentifier<?> path) {
 195         final var stack = SchemaInferenceStack.of(getRuntimeContext().getEffectiveModelContext());
 196         final var it = toYangInstanceIdentifier(path).getPathArguments().iterator();
 197         verify(it.hasNext(), "Unexpected empty instance identifier for %s", path);
 198
 199         QNameModule lastNamespace;
 200         do {
 201             final var arg = it.next();
 202             if (arg instanceof AugmentationIdentifier) {
 203                 final var augChildren = ((AugmentationIdentifier) arg).getPossibleChildNames();
 204                 verify(!augChildren.isEmpty(), "Invalid empty augmentation %s", arg);
 205                 lastNamespace = augChildren.iterator().next().getModule();
 206                 continue;
 207             }
 208
 209             final var qname = arg.getNodeType();
 210             final var stmt = stack.enterDataTree(qname);
 211             lastNamespace = qname.getModule();
 212             if (stmt instanceof ListEffectiveStatement) {
 213                 // Lists have two steps
 214                 verify(it.hasNext(), "Unexpected list termination at %s in %s", stmt, path);
 215                 // Verify just to make sure we are doing the right thing
 216                 final var skipped = it.next();
 217                 verify(skipped instanceof NodeIdentifier, "Unexpected skipped list entry item %s in %s", skipped, path);
 218                 verify(stmt.argument().equals(skipped.getNodeType()), "Mismatched list entry item %s in %s", skipped,
 219                     path);
 220             }
 221         } while (it.hasNext());
 222
 223         return Map.entry(stack, lastNamespace);
 224     }
 225 }