/* * Copyright (c) 2014 Cisco Systems, Inc. and others. All rights reserved. * * This program and the accompanying materials are made available under the * terms of the Eclipse Public License v1.0 which accompanies this distribution, * and is available at http://www.eclipse.org/legal/epl-v10.html */ package org.opendaylight.mdsal.binding.dom.adapter; import com.google.common.base.Function; import com.google.common.base.Optional; import com.google.common.base.Preconditions; import com.google.common.cache.CacheBuilder; import com.google.common.cache.CacheLoader; import com.google.common.cache.LoadingCache; import com.google.common.collect.ImmutableBiMap; import com.google.common.collect.ImmutableSet; import com.google.common.collect.Iterators; import java.lang.reflect.Method; import java.net.URI; import java.util.AbstractMap.SimpleEntry; import java.util.Collection; import java.util.Date; import java.util.HashSet; import java.util.Map; import java.util.Map.Entry; import java.util.Set; import java.util.concurrent.TimeUnit; import java.util.stream.Collectors; import javax.annotation.Nonnull; import org.opendaylight.mdsal.binding.api.DataTreeIdentifier; import org.opendaylight.mdsal.binding.dom.codec.api.BindingCodecTree; import org.opendaylight.mdsal.binding.dom.codec.api.BindingCodecTreeFactory; import org.opendaylight.mdsal.binding.dom.codec.api.BindingCodecTreeNode; import org.opendaylight.mdsal.binding.dom.codec.api.BindingNormalizedNodeSerializer; import org.opendaylight.mdsal.binding.dom.codec.impl.BindingNormalizedNodeCodecRegistry; import org.opendaylight.mdsal.binding.dom.codec.impl.MissingSchemaException; import org.opendaylight.mdsal.binding.generator.api.ClassLoadingStrategy; import org.opendaylight.mdsal.binding.generator.util.BindingRuntimeContext; import org.opendaylight.mdsal.dom.api.DOMDataTreeIdentifier; import org.opendaylight.yangtools.yang.binding.BindingMapping; import org.opendaylight.yangtools.yang.binding.DataContainer; import org.opendaylight.yangtools.yang.binding.DataObject; import org.opendaylight.yangtools.yang.binding.InstanceIdentifier; import org.opendaylight.yangtools.yang.binding.InstanceIdentifier.PathArgument; import org.opendaylight.yangtools.yang.binding.Notification; import org.opendaylight.yangtools.yang.binding.RpcService; import org.opendaylight.yangtools.yang.binding.util.BindingReflections; import org.opendaylight.yangtools.yang.common.QNameModule; import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier; import org.opendaylight.yangtools.yang.data.api.schema.ContainerNode; import org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode; import org.opendaylight.yangtools.yang.data.impl.codec.DeserializationException; import org.opendaylight.yangtools.yang.data.impl.schema.Builders; import org.opendaylight.yangtools.yang.data.impl.schema.ImmutableNodes; import org.opendaylight.yangtools.yang.model.api.ContainerSchemaNode; import org.opendaylight.yangtools.yang.model.api.ListSchemaNode; import org.opendaylight.yangtools.yang.model.api.Module; import org.opendaylight.yangtools.yang.model.api.NotificationDefinition; import org.opendaylight.yangtools.yang.model.api.RpcDefinition; import org.opendaylight.yangtools.yang.model.api.SchemaContext; import org.opendaylight.yangtools.yang.model.api.SchemaContextListener; import org.opendaylight.yangtools.yang.model.api.SchemaPath; import org.opendaylight.yangtools.yang.model.api.meta.EffectiveStatement; import org.opendaylight.yangtools.yang.model.api.meta.StatementSource; import org.slf4j.Logger; import org.slf4j.LoggerFactory; public final class BindingToNormalizedNodeCodec implements BindingCodecTreeFactory, BindingNormalizedNodeSerializer, SchemaContextListener, AutoCloseable { private static final long WAIT_DURATION_SEC = 5; private static final Logger LOG = LoggerFactory.getLogger(BindingToNormalizedNodeCodec.class); private final LoadingCache, YangInstanceIdentifier> iiCache = CacheBuilder.newBuilder() .softValues().build(new CacheLoader, YangInstanceIdentifier>() { @Override public YangInstanceIdentifier load(@Nonnull final InstanceIdentifier key) { return toYangInstanceIdentifierBlocking(key); } }); private final BindingNormalizedNodeCodecRegistry codecRegistry; private final ClassLoadingStrategy classLoadingStrategy; private final FutureSchema futureSchema; private volatile BindingRuntimeContext runtimeContext; public BindingToNormalizedNodeCodec(final ClassLoadingStrategy classLoadingStrategy, final BindingNormalizedNodeCodecRegistry codecRegistry) { this(classLoadingStrategy, codecRegistry, false); } public BindingToNormalizedNodeCodec(final ClassLoadingStrategy classLoadingStrategy, final BindingNormalizedNodeCodecRegistry codecRegistry, final boolean waitForSchema) { this.classLoadingStrategy = Preconditions.checkNotNull(classLoadingStrategy, "classLoadingStrategy"); this.codecRegistry = Preconditions.checkNotNull(codecRegistry, "codecRegistry"); this.futureSchema = waitForSchema ? new FutureSchema(WAIT_DURATION_SEC, TimeUnit.SECONDS) : null; } YangInstanceIdentifier toYangInstanceIdentifierBlocking(final InstanceIdentifier binding) { try { return codecRegistry.toYangInstanceIdentifier(binding); } catch (final MissingSchemaException e) { waitForSchema(decompose(binding), e); return codecRegistry.toYangInstanceIdentifier(binding); } } /** * Translates supplied Binding Instance Identifier into NormalizedNode * instance identifier. * * @param binding * Binding Instance Identifier * @return DOM Instance Identifier * @throws IllegalArgumentException * If supplied Instance Identifier is not valid. */ public YangInstanceIdentifier toNormalized(final InstanceIdentifier binding) { return codecRegistry.toYangInstanceIdentifier(binding); } @Override public YangInstanceIdentifier toYangInstanceIdentifier(@Nonnull final InstanceIdentifier binding) { return codecRegistry.toYangInstanceIdentifier(binding); } YangInstanceIdentifier toYangInstanceIdentifierCached(final InstanceIdentifier binding) { return iiCache .getUnchecked(binding); } @Override public Entry> toNormalizedNode( final InstanceIdentifier path, final T data) { try { return codecRegistry.toNormalizedNode(path, data); } catch (final MissingSchemaException e) { waitForSchema(decompose(path), e); return codecRegistry.toNormalizedNode(path, data); } } /** * Converts Binding Map.Entry to DOM Map.Entry. * *

* Same as {@link #toNormalizedNode(InstanceIdentifier, DataObject)}. * * @param binding Map Entry with InstanceIdentifier as key and DataObject as value. * @return DOM Map Entry with {@link YangInstanceIdentifier} as key and {@link NormalizedNode} * as value. */ @SuppressWarnings({"unchecked", "rawtypes"}) public Entry> toNormalizedNode( final Entry, DataObject> binding) { return toNormalizedNode((InstanceIdentifier) binding.getKey(), binding.getValue()); } @Override public Entry, DataObject> fromNormalizedNode(@Nonnull final YangInstanceIdentifier path, final NormalizedNode data) { return codecRegistry.fromNormalizedNode(path, data); } @Override public Notification fromNormalizedNodeNotification(@Nonnull final SchemaPath path, @Nonnull final ContainerNode data) { return codecRegistry.fromNormalizedNodeNotification(path, data); } @Override public DataObject fromNormalizedNodeRpcData(@Nonnull final SchemaPath path, @Nonnull final ContainerNode data) { return codecRegistry.fromNormalizedNodeRpcData(path, data); } @Override public InstanceIdentifier fromYangInstanceIdentifier(@Nonnull final YangInstanceIdentifier dom) { return codecRegistry.fromYangInstanceIdentifier(dom); } @Override public ContainerNode toNormalizedNodeNotification(@Nonnull final Notification data) { return codecRegistry.toNormalizedNodeNotification(data); } @Override public ContainerNode toNormalizedNodeRpcData(@Nonnull final DataContainer data) { return codecRegistry.toNormalizedNodeRpcData(data); } /** * Returns a Binding-Aware instance identifier from normalized * instance-identifier if it is possible to create representation. * *

* Returns Optional.absent for cases where target is mixin node except * augmentation. */ public Optional> toBinding(final YangInstanceIdentifier normalized) throws DeserializationException { try { return Optional.fromNullable(codecRegistry.fromYangInstanceIdentifier(normalized)); } catch (final IllegalArgumentException e) { return Optional.absent(); } } public Optional, DataObject>> toBinding( @Nonnull final Entry> normalized) throws DeserializationException { try { /* * This cast is required, due to generics behaviour in openjdk / oracle javac. * *

* InstanceIdentifier has definition InstanceIdentifier, * this means '?' is always  . Eclipse compiler * is able to determine this relationship and treats * Entry,DataObject> and Entry * as assignable. However openjdk / oracle javac treats this two types * as incompatible and issues a compile error. * *

* It is safe to loose generic information and cast it to other generic signature. * */ @SuppressWarnings("unchecked") final Entry, DataObject> binding = Entry.class.cast( codecRegistry.fromNormalizedNode(normalized.getKey(), normalized.getValue())); return Optional.fromNullable(binding); } catch (final IllegalArgumentException e) { return Optional.absent(); } } @Override public void onGlobalContextUpdated(final SchemaContext context) { runtimeContext = BindingRuntimeContext.create(classLoadingStrategy, context); codecRegistry.onBindingRuntimeContextUpdated(runtimeContext); if (futureSchema != null) { futureSchema.onRuntimeContextUpdated(runtimeContext); } } public Function>, Optional> deserializeFunction(final InstanceIdentifier path) { return codecRegistry.deserializeFunction(path); } public BindingNormalizedNodeCodecRegistry getCodecRegistry() { return codecRegistry; } @Override public void close() { // NOOP Intentionally } public BindingNormalizedNodeCodecRegistry getCodecFactory() { return codecRegistry; } // FIXME: This should be probably part of Binding Runtime context public ImmutableBiMap getRpcMethodToSchemaPath(final Class key) { final Module module = getModuleBlocking(key); final ImmutableBiMap.Builder ret = ImmutableBiMap.builder(); try { for (final RpcDefinition rpcDef : module.getRpcs()) { final Method method = findRpcMethod(key, rpcDef); ret.put(method, rpcDef.getPath()); } } catch (final NoSuchMethodException e) { throw new IllegalStateException("Rpc defined in model does not have representation in generated class.", e); } return ret.build(); } protected ImmutableBiMap getRpcMethodToSchema(final Class key) { final Module module = getModuleBlocking(key); final ImmutableBiMap.Builder ret = ImmutableBiMap.builder(); try { for (final RpcDefinition rpcDef : module.getRpcs()) { final Method method = findRpcMethod(key, rpcDef); ret.put(method, rpcDef); } } catch (final NoSuchMethodException e) { throw new IllegalStateException("Rpc defined in model does not have representation in generated class.", e); } return ret.build(); } private Module getModuleBlocking(final Class modeledClass) { final QNameModule moduleName = BindingReflections.getQNameModule(modeledClass); final URI namespace = moduleName.getNamespace(); final Date revision = moduleName.getRevision(); BindingRuntimeContext localRuntimeContext = runtimeContext; Module module = localRuntimeContext == null ? null : localRuntimeContext.getSchemaContext().findModuleByNamespaceAndRevision(namespace, revision); if (module == null && futureSchema != null && futureSchema.waitForSchema(namespace,revision)) { localRuntimeContext = runtimeContext; Preconditions.checkState(localRuntimeContext != null, "BindingRuntimeContext is not available."); module = localRuntimeContext.getSchemaContext().findModuleByNamespaceAndRevision(namespace, revision); } Preconditions.checkState(module != null, "Schema for %s is not available.", modeledClass); return module; } private void waitForSchema(final Collection> binding, final MissingSchemaException exception) { if (futureSchema != null) { LOG.warn("Blocking thread to wait for schema convergence updates for {} {}", futureSchema.getDuration(), futureSchema.getUnit()); if (!futureSchema.waitForSchema(binding)) { return; } } throw exception; } private Method findRpcMethod(final Class key, final RpcDefinition rpcDef) throws NoSuchMethodException { final String methodName = BindingMapping.getMethodName(rpcDef.getQName()); if (rpcDef.getInput() != null && isExplicitStatement(rpcDef.getInput())) { final Class inputClz = runtimeContext.getClassForSchema(rpcDef.getInput()); return key.getMethod(methodName, inputClz); } return key.getMethod(methodName); } private static boolean isExplicitStatement(final ContainerSchemaNode node) { return node instanceof EffectiveStatement && ((EffectiveStatement) node).getDeclared().getStatementSource() == StatementSource.DECLARATION; } @Override public BindingCodecTree create(final BindingRuntimeContext context) { return codecRegistry.create(context); } @Override public BindingCodecTree create(final SchemaContext context, final Class... bindingClasses) { return codecRegistry.create(context, bindingClasses); } @Nonnull protected Map.Entry, BindingCodecTreeNode> getSubtreeCodec( final YangInstanceIdentifier domIdentifier) { final BindingCodecTree currentCodecTree = codecRegistry.getCodecContext(); final InstanceIdentifier bindingPath = codecRegistry.fromYangInstanceIdentifier(domIdentifier); Preconditions.checkArgument(bindingPath != null); /** * If we are able to deserialize YANG instance identifier, getSubtreeCodec must * return non-null value. */ final BindingCodecTreeNode codecContext = currentCodecTree.getSubtreeCodec(bindingPath); return new SimpleEntry<>(bindingPath, codecContext); } @SuppressWarnings("unchecked") public Set> getNotificationClasses(final Set interested) { final Set> result = new HashSet<>(); final Set knownNotifications = runtimeContext.getSchemaContext().getNotifications(); for (final NotificationDefinition notification : knownNotifications) { if (interested.contains(notification.getPath())) { try { result.add((Class) runtimeContext.getClassForSchema(notification)); } catch (final IllegalStateException e) { // Ignore LOG.warn("Class for {} is currently not known.", notification.getPath(), e); } } } return result; } private static Collection> decompose(final InstanceIdentifier path) { return ImmutableSet.copyOf(Iterators.transform(path.getPathArguments().iterator(), PathArgument::getType)); } protected NormalizedNode instanceIdentifierToNode(final YangInstanceIdentifier parentPath) { return ImmutableNodes.fromInstanceId(runtimeContext.getSchemaContext(), parentPath); } public NormalizedNode getDefaultNodeFor(final YangInstanceIdentifier parentMapPath) { final BindingCodecTreeNode mapCodec = codecRegistry.getCodecContext().getSubtreeCodec(parentMapPath); final Object schema = mapCodec.getSchema(); if (schema instanceof ListSchemaNode) { final ListSchemaNode castedSchema = (ListSchemaNode) schema; return castedSchema.isUserOrdered() ? Builders.orderedMapBuilder(castedSchema).build() : Builders.mapBuilder(castedSchema).build(); } throw new IllegalArgumentException("Path does not point to list schema node"); } protected Collection toDOMDataTreeIdentifiers( final Collection> subtrees) { return subtrees.stream().map(this::toDOMDataTreeIdentifier).collect(Collectors.toSet()); } protected DOMDataTreeIdentifier toDOMDataTreeIdentifier(final DataTreeIdentifier path) { final YangInstanceIdentifier domPath = toYangInstanceIdentifierBlocking(path.getRootIdentifier()); return new DOMDataTreeIdentifier(path.getDatastoreType(), domPath); } }