2 * Copyright (c) 2018 Pantheon Technologies, s.r.o. 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.adapter;
10 import static java.util.Objects.requireNonNull;
12 import com.google.common.collect.ClassToInstanceMap;
13 import com.google.common.collect.ImmutableSet;
14 import com.google.common.util.concurrent.Futures;
15 import com.google.common.util.concurrent.ListenableFuture;
16 import java.util.List;
18 import java.util.stream.Collectors;
19 import org.eclipse.jdt.annotation.NonNullByDefault;
20 import org.opendaylight.mdsal.binding.api.ActionProviderService;
21 import org.opendaylight.mdsal.binding.api.ActionSpec;
22 import org.opendaylight.mdsal.binding.api.DataTreeIdentifier;
23 import org.opendaylight.mdsal.binding.dom.adapter.BindingDOMAdapterBuilder.Factory;
24 import org.opendaylight.mdsal.common.api.LogicalDatastoreType;
25 import org.opendaylight.mdsal.dom.api.DOMActionImplementation;
26 import org.opendaylight.mdsal.dom.api.DOMActionInstance;
27 import org.opendaylight.mdsal.dom.api.DOMActionProviderService;
28 import org.opendaylight.mdsal.dom.api.DOMActionResult;
29 import org.opendaylight.mdsal.dom.api.DOMDataTreeIdentifier;
30 import org.opendaylight.mdsal.dom.api.DOMService;
31 import org.opendaylight.mdsal.dom.spi.SimpleDOMActionResult;
32 import org.opendaylight.yangtools.concepts.AbstractObjectRegistration;
33 import org.opendaylight.yangtools.concepts.ObjectRegistration;
34 import org.opendaylight.yangtools.yang.binding.Action;
35 import org.opendaylight.yangtools.yang.binding.DataObject;
36 import org.opendaylight.yangtools.yang.binding.InstanceIdentifier;
37 import org.opendaylight.yangtools.yang.common.ErrorTag;
38 import org.opendaylight.yangtools.yang.common.ErrorType;
39 import org.opendaylight.yangtools.yang.common.RpcResult;
40 import org.opendaylight.yangtools.yang.common.RpcResultBuilder;
41 import org.opendaylight.yangtools.yang.common.YangConstants;
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.ContainerNode;
45 import org.opendaylight.yangtools.yang.model.api.stmt.SchemaNodeIdentifier.Absolute;
46 import org.slf4j.Logger;
47 import org.slf4j.LoggerFactory;
50 public final class ActionProviderServiceAdapter extends AbstractBindingAdapter<DOMActionProviderService>
51 implements ActionProviderService {
52 private static final class Builder extends BindingDOMAdapterBuilder<ActionProviderService> {
53 Builder(final AdapterContext adapterContext) {
54 super(adapterContext);
58 protected ActionProviderService createInstance(final ClassToInstanceMap<DOMService> delegates) {
59 return new ActionProviderServiceAdapter(adapterContext(),
60 delegates.getInstance(DOMActionProviderService.class));
64 public Set<? extends Class<? extends DOMService>> getRequiredDelegates() {
65 return ImmutableSet.of(DOMActionProviderService.class);
69 private static final Logger LOG = LoggerFactory.getLogger(ActionProviderServiceAdapter.class);
71 static final Factory<ActionProviderService> BUILDER_FACTORY = Builder::new;
73 ActionProviderServiceAdapter(final AdapterContext adapterContext, final DOMActionProviderService delegate) {
74 super(adapterContext, delegate);
78 public <P extends DataObject, A extends Action<? extends InstanceIdentifier<P>, ?, ?>, S extends A>
79 ObjectRegistration<S> registerImplementation(final ActionSpec<A, P> spec, final S implementation,
80 final LogicalDatastoreType datastore, final Set<? extends InstanceIdentifier<P>> validNodes) {
81 final CurrentAdapterSerializer serializer = currentSerializer();
82 final Absolute actionPath = serializer.getActionPath(spec);
83 final Impl impl = new Impl(adapterContext(), actionPath, spec.type(), implementation);
84 final DOMActionInstance instance = validNodes.isEmpty()
85 // Register on the entire datastore
86 ? DOMActionInstance.of(actionPath, new DOMDataTreeIdentifier(datastore, YangInstanceIdentifier.empty()))
87 // Register on specific instances
88 : DOMActionInstance.of(actionPath, validNodes.stream()
89 .map(node -> serializer.toDOMDataTreeIdentifier(DataTreeIdentifier.create(datastore, node)))
90 .collect(Collectors.toUnmodifiableSet()));
93 final ObjectRegistration<?> reg = getDelegate().registerActionImplementation(impl, instance);
95 return new AbstractObjectRegistration<>(implementation) {
97 protected void removeRegistration() {
103 private static final class Impl implements DOMActionImplementation {
104 private final Class<? extends Action<?, ?, ?>> actionInterface;
105 private final AdapterContext adapterContext;
106 @SuppressWarnings("rawtypes")
107 private final Action implementation;
108 private final NodeIdentifier outputName;
110 Impl(final AdapterContext adapterContext, final Absolute actionPath,
111 final Class<? extends Action<?, ?, ?>> actionInterface, final Action<?, ?, ?> implementation) {
112 this.adapterContext = requireNonNull(adapterContext);
113 outputName = NodeIdentifier.create(
114 YangConstants.operationOutputQName(actionPath.lastNodeIdentifier().getModule()));
115 this.actionInterface = requireNonNull(actionInterface);
116 this.implementation = requireNonNull(implementation);
120 @SuppressWarnings({ "rawtypes", "unchecked" })
121 public ListenableFuture<? extends DOMActionResult> invokeAction(final Absolute type,
122 final DOMDataTreeIdentifier path, final ContainerNode input) {
123 final CurrentAdapterSerializer codec = adapterContext.currentSerializer();
124 final InstanceIdentifier<DataObject> instance = codec.fromYangInstanceIdentifier(path.getRootIdentifier());
125 if (instance == null) {
126 // Not representable: return an error
127 LOG.debug("Path {} is not representable in binding, rejecting invocation", path);
128 return Futures.immediateFuture(new SimpleDOMActionResult(List.of(RpcResultBuilder.newError(
129 ErrorType.APPLICATION, ErrorTag.INVALID_VALUE, "Supplied path cannot be represented"))));
131 if (instance.isWildcarded()) {
132 // A wildcard path: return an error
133 LOG.debug("Path {} maps to a wildcard {}, rejecting invocation", path, instance);
134 return Futures.immediateFuture(new SimpleDOMActionResult(List.of(RpcResultBuilder.newError(
135 ErrorType.APPLICATION, ErrorTag.INVALID_VALUE,
136 "Supplied path does not identify a concrete instance"))));
139 final ListenableFuture<RpcResult<?>> userFuture = implementation.invoke(instance,
140 codec.fromNormalizedNodeActionInput(actionInterface, input));
141 if (userFuture instanceof BindingOperationFluentFuture) {
142 // If we are looping back through our future we can skip wrapping. This can happen if application
143 // forwards invocations between multiple instantiations of the same action.
144 return (BindingOperationFluentFuture) userFuture;
147 return new BindingOperationFluentFuture(userFuture, actionInterface, outputName, adapterContext);