2 * Copyright (c) 2014 Cisco Systems, Inc. and others. All rights reserved.
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
8 package org.opendaylight.mdsal.binding.dom.codec.impl;
10 import static com.google.common.base.Preconditions.checkState;
11 import static java.util.Objects.requireNonNull;
13 import edu.umd.cs.findbugs.annotations.SuppressFBWarnings;
14 import java.io.IOException;
15 import java.time.Instant;
16 import java.util.AbstractMap.SimpleEntry;
17 import java.util.ArrayList;
18 import java.util.List;
19 import java.util.Map.Entry;
20 import java.util.Optional;
21 import java.util.concurrent.atomic.AtomicReferenceFieldUpdater;
22 import java.util.function.BiFunction;
23 import java.util.function.Function;
24 import org.eclipse.jdt.annotation.NonNull;
25 import org.opendaylight.binding.runtime.api.BindingRuntimeContext;
26 import org.opendaylight.mdsal.binding.dom.codec.api.BindingCodecTree;
27 import org.opendaylight.mdsal.binding.dom.codec.api.BindingDataObjectCodecTreeNode;
28 import org.opendaylight.mdsal.binding.dom.codec.api.BindingLazyContainerNode;
29 import org.opendaylight.mdsal.binding.dom.codec.api.BindingNormalizedNodeSerializer;
30 import org.opendaylight.mdsal.binding.dom.codec.api.BindingNormalizedNodeWriterFactory;
31 import org.opendaylight.mdsal.binding.dom.codec.api.BindingStreamEventWriter;
32 import org.opendaylight.mdsal.binding.dom.codec.spi.LazyActionInputContainerNode;
33 import org.opendaylight.mdsal.binding.dom.codec.spi.LazyActionOutputContainerNode;
34 import org.opendaylight.yangtools.yang.binding.Action;
35 import org.opendaylight.yangtools.yang.binding.DataContainer;
36 import org.opendaylight.yangtools.yang.binding.DataObject;
37 import org.opendaylight.yangtools.yang.binding.InstanceIdentifier;
38 import org.opendaylight.yangtools.yang.binding.InstanceIdentifier.PathArgument;
39 import org.opendaylight.yangtools.yang.binding.Notification;
40 import org.opendaylight.yangtools.yang.binding.RpcInput;
41 import org.opendaylight.yangtools.yang.binding.RpcOutput;
42 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier;
43 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.NodeIdentifier;
44 import org.opendaylight.yangtools.yang.data.api.schema.ChoiceNode;
45 import org.opendaylight.yangtools.yang.data.api.schema.ContainerNode;
46 import org.opendaylight.yangtools.yang.data.api.schema.LeafSetNode;
47 import org.opendaylight.yangtools.yang.data.api.schema.MapNode;
48 import org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode;
49 import org.opendaylight.yangtools.yang.data.api.schema.UnkeyedListNode;
50 import org.opendaylight.yangtools.yang.data.api.schema.ValueNode;
51 import org.opendaylight.yangtools.yang.data.api.schema.stream.NormalizedNodeStreamWriter;
52 import org.opendaylight.yangtools.yang.data.impl.schema.ImmutableNormalizedNodeStreamWriter;
53 import org.opendaylight.yangtools.yang.data.impl.schema.NormalizedNodeResult;
54 import org.opendaylight.yangtools.yang.model.api.SchemaPath;
55 import org.slf4j.Logger;
56 import org.slf4j.LoggerFactory;
58 public class BindingNormalizedNodeCodecRegistry
59 implements BindingNormalizedNodeWriterFactory, BindingNormalizedNodeSerializer {
60 private static final Logger LOG = LoggerFactory.getLogger(BindingNormalizedNodeCodecRegistry.class);
62 private static final AtomicReferenceFieldUpdater<BindingNormalizedNodeCodecRegistry, BindingCodecContext> UPDATER =
63 AtomicReferenceFieldUpdater.newUpdater(BindingNormalizedNodeCodecRegistry.class, BindingCodecContext.class,
65 private volatile BindingCodecContext codecContext;
67 public BindingNormalizedNodeCodecRegistry() {
71 public BindingNormalizedNodeCodecRegistry(final BindingRuntimeContext codecContext) {
73 onBindingRuntimeContextUpdated(codecContext);
76 public BindingCodecTree getCodecContext() {
80 public void onBindingRuntimeContextUpdated(final BindingRuntimeContext context) {
81 // BindingCodecContext is a costly resource. Let us not ditch it unless we have to
82 final BindingCodecContext current = codecContext;
83 if (current != null && context.equals(current.getRuntimeContext())) {
84 LOG.debug("Skipping update of runtime context {}", context);
88 final BindingCodecContext updated = new BindingCodecContext(context);
89 if (!UPDATER.compareAndSet(this, current, updated)) {
90 LOG.warn("Concurrent update of runtime context (expected={} current={}) detected at ", current,
91 codecContext, new Throwable());
95 final @NonNull BindingCodecContext codecContext() {
96 final BindingCodecContext local = codecContext;
97 checkState(local != null, "No context available yet");
102 public YangInstanceIdentifier toYangInstanceIdentifier(final InstanceIdentifier<?> binding) {
103 return codecContext.getInstanceIdentifierCodec().fromBinding(binding);
107 public <T extends DataObject> InstanceIdentifier<T> fromYangInstanceIdentifier(final YangInstanceIdentifier dom) {
108 return codecContext.getInstanceIdentifierCodec().toBinding(dom);
112 public <T extends DataObject> Entry<YangInstanceIdentifier, NormalizedNode<?,?>> toNormalizedNode(
113 final InstanceIdentifier<T> path, final T data) {
114 final NormalizedNodeResult result = new NormalizedNodeResult();
115 // We create DOM stream writer which produces normalized nodes
116 final NormalizedNodeStreamWriter domWriter = ImmutableNormalizedNodeStreamWriter.from(result);
118 // We create Binding Stream Writer which translates from Binding to Normalized Nodes
119 final Entry<YangInstanceIdentifier, BindingStreamEventWriter> writeCtx = codecContext.newWriter(path,
122 // We get serializer which reads binding data and uses Binding To Normalized Node writer to write result
124 codecContext.getSerializer(path.getTargetType()).serialize(data, writeCtx.getValue());
125 } catch (final IOException e) {
126 LOG.error("Unexpected failure while serializing path {} data {}", path, data, e);
127 throw new IllegalStateException("Failed to create normalized node", e);
129 return new SimpleEntry<>(writeCtx.getKey(),result.getResult());
133 @SuppressFBWarnings("BC_UNCONFIRMED_CAST")
134 public ContainerNode toNormalizedNodeNotification(final Notification data) {
135 // FIXME: Should the cast to DataObject be necessary?
136 return serializeDataObject((DataObject) data,
137 // javac does not like a methodhandle here
138 (iface, domWriter) -> newNotificationWriter(iface.asSubclass(Notification.class), domWriter));
142 @SuppressFBWarnings("BC_UNCONFIRMED_CAST")
143 public ContainerNode toNormalizedNodeRpcData(final DataContainer data) {
144 // FIXME: Should the cast to DataObject be necessary?
145 return serializeDataObject((DataObject) data, this::newRpcWriter);
149 public ContainerNode toNormalizedNodeActionInput(final Class<? extends Action<?, ?, ?>> action,
150 final RpcInput input) {
151 return serializeDataObject(input, (iface, domWriter) -> newActionInputWriter(action, domWriter));
155 public ContainerNode toNormalizedNodeActionOutput(final Class<? extends Action<?, ?, ?>> action,
156 final RpcOutput output) {
157 return serializeDataObject(output, (iface, domWriter) -> newActionOutputWriter(action, domWriter));
161 public BindingLazyContainerNode<RpcInput> toLazyNormalizedNodeActionInput(
162 final Class<? extends Action<?, ?, ?>> action, final NodeIdentifier identifier, final RpcInput input) {
163 return new LazyActionInputContainerNode(identifier, input, this, action);
167 public BindingLazyContainerNode<RpcOutput> toLazyNormalizedNodeActionOutput(
168 final Class<? extends Action<?, ?, ?>> action, final NodeIdentifier identifier, final RpcOutput output) {
169 return new LazyActionOutputContainerNode(identifier, output, this, action);
172 private <T extends DataContainer> ContainerNode serializeDataObject(final DataObject data,
173 final BiFunction<Class<? extends T>, NormalizedNodeStreamWriter, BindingStreamEventWriter> newWriter) {
174 final NormalizedNodeResult result = new NormalizedNodeResult();
175 // We create DOM stream writer which produces normalized nodes
176 final NormalizedNodeStreamWriter domWriter = ImmutableNormalizedNodeStreamWriter.from(result);
177 final Class<? extends DataObject> type = data.implementedInterface();
178 @SuppressWarnings("unchecked")
179 final BindingStreamEventWriter writer = newWriter.apply((Class<T>)type, domWriter);
181 codecContext.getSerializer(type).serialize(data, writer);
182 } catch (final IOException e) {
183 LOG.error("Unexpected failure while serializing data {}", data, e);
184 throw new IllegalStateException("Failed to create normalized node", e);
186 return (ContainerNode) result.getResult();
189 private static boolean notBindingRepresentable(final NormalizedNode<?, ?> data) {
190 // ValueNode covers LeafNode and LeafSetEntryNode
191 return data instanceof ValueNode
192 || data instanceof MapNode || data instanceof UnkeyedListNode
193 || data instanceof ChoiceNode
194 || data instanceof LeafSetNode;
198 public Entry<InstanceIdentifier<?>, DataObject> fromNormalizedNode(final YangInstanceIdentifier path,
199 final NormalizedNode<?, ?> data) {
200 if (notBindingRepresentable(data)) {
204 final List<PathArgument> builder = new ArrayList<>();
205 final BindingDataObjectCodecTreeNode<?> codec = codecContext.getCodecContextNode(path, builder);
208 LOG.warn("Path {} does not have a binding equivalent, should have been caught earlier ({})", path,
214 final DataObject lazyObj = codec.deserialize(data);
215 final InstanceIdentifier<?> bindingPath = InstanceIdentifier.create(builder);
216 return new SimpleEntry<>(bindingPath, lazyObj);
220 public Notification fromNormalizedNodeNotification(final SchemaPath path, final ContainerNode data) {
221 final NotificationCodecContext<?> codec = codecContext.getNotificationContext(path);
222 return codec.deserialize(data);
226 public Notification fromNormalizedNodeNotification(final SchemaPath path, final ContainerNode data,
227 final Instant eventInstant) {
228 if (eventInstant == null) {
229 return fromNormalizedNodeNotification(path, data);
232 final NotificationCodecContext<?> codec = codecContext.getNotificationContext(path);
233 return codec.deserialize(data, eventInstant);
237 public DataObject fromNormalizedNodeRpcData(final SchemaPath path, final ContainerNode data) {
238 final RpcInputCodec<?> codec = codecContext.getRpcInputCodec(path);
239 return codec.deserialize(data);
243 public <T extends RpcInput> T fromNormalizedNodeActionInput(final Class<? extends Action<?, ?, ?>> action,
244 final ContainerNode input) {
245 return (T) requireNonNull(codecContext.getActionCodec(action).input().deserialize(requireNonNull(input)));
249 public <T extends RpcOutput> T fromNormalizedNodeActionOutput(final Class<? extends Action<?, ?, ?>> action,
250 final ContainerNode output) {
251 return (T) requireNonNull(codecContext.getActionCodec(action).output().deserialize(requireNonNull(output)));
255 public Entry<YangInstanceIdentifier, BindingStreamEventWriter> newWriterAndIdentifier(
256 final InstanceIdentifier<?> path, final NormalizedNodeStreamWriter domWriter) {
257 return codecContext.newWriter(path, domWriter);
261 public BindingStreamEventWriter newWriter(final InstanceIdentifier<?> path,
262 final NormalizedNodeStreamWriter domWriter) {
263 return codecContext.newWriterWithoutIdentifier(path, domWriter);
267 public BindingStreamEventWriter newNotificationWriter(final Class<? extends Notification> notification,
268 final NormalizedNodeStreamWriter streamWriter) {
269 return codecContext.newNotificationWriter(notification, streamWriter);
273 public BindingStreamEventWriter newActionInputWriter(final Class<? extends Action<?, ?, ?>> action,
274 final NormalizedNodeStreamWriter domWriter) {
275 return codecContext.getActionCodec(action).input().createWriter(domWriter);
279 public BindingStreamEventWriter newActionOutputWriter(final Class<? extends Action<?, ?, ?>> action,
280 final NormalizedNodeStreamWriter domWriter) {
281 return codecContext.getActionCodec(action).output().createWriter(domWriter);
285 public BindingStreamEventWriter newRpcWriter(final Class<? extends DataContainer> rpcInputOrOutput,
286 final NormalizedNodeStreamWriter streamWriter) {
287 return codecContext.newRpcWriter(rpcInputOrOutput,streamWriter);
290 public <T extends DataObject> Function<Optional<NormalizedNode<?, ?>>, Optional<T>> deserializeFunction(
291 final InstanceIdentifier<T> path) {
292 final DataObjectCodecContext<?,?> ctx = (DataObjectCodecContext<?,?>) codecContext.getCodecContextNode(path,
294 return new DeserializeFunction<>(ctx);
297 private static final class DeserializeFunction<T> implements Function<Optional<NormalizedNode<?, ?>>, Optional<T>> {
298 private final DataObjectCodecContext<?,?> ctx;
300 DeserializeFunction(final DataObjectCodecContext<?,?> ctx) {
304 @SuppressWarnings("unchecked")
306 public Optional<T> apply(final Optional<NormalizedNode<?, ?>> input) {
307 return input.map(data -> (T) ctx.deserialize(data));