2 * Copyright (c) 2023 PANTHEON.tech, 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.restconf.server.mdsal;
10 import static com.google.common.base.Verify.verifyNotNull;
11 import static java.util.Objects.requireNonNull;
13 import com.google.common.collect.ImmutableMap;
14 import com.google.common.collect.Maps;
15 import edu.umd.cs.findbugs.annotations.SuppressFBWarnings;
16 import java.lang.invoke.MethodHandles;
17 import java.lang.invoke.VarHandle;
19 import java.time.format.DateTimeParseException;
20 import java.util.List;
21 import java.util.Locale;
22 import javax.annotation.PreDestroy;
23 import javax.inject.Inject;
24 import javax.inject.Singleton;
25 import org.eclipse.jdt.annotation.NonNull;
26 import org.eclipse.jdt.annotation.Nullable;
27 import org.opendaylight.mdsal.dom.api.DOMActionService;
28 import org.opendaylight.mdsal.dom.api.DOMDataBroker;
29 import org.opendaylight.mdsal.dom.api.DOMMountPointService;
30 import org.opendaylight.mdsal.dom.api.DOMRpcService;
31 import org.opendaylight.restconf.api.ApiPath;
32 import org.opendaylight.restconf.api.FormattableBody;
33 import org.opendaylight.restconf.common.errors.RestconfDocumentedException;
34 import org.opendaylight.restconf.nb.rfc8040.rests.transactions.MdsalRestconfStrategy;
35 import org.opendaylight.restconf.nb.rfc8040.rests.transactions.RestconfStrategy;
36 import org.opendaylight.restconf.nb.rfc8040.rests.transactions.RestconfStrategy.StrategyAndTail;
37 import org.opendaylight.restconf.server.api.ChildBody;
38 import org.opendaylight.restconf.server.api.CreateResourceResult;
39 import org.opendaylight.restconf.server.api.DataGetResult;
40 import org.opendaylight.restconf.server.api.DataPatchResult;
41 import org.opendaylight.restconf.server.api.DataPostBody;
42 import org.opendaylight.restconf.server.api.DataPostResult;
43 import org.opendaylight.restconf.server.api.DataPutResult;
44 import org.opendaylight.restconf.server.api.DataYangPatchResult;
45 import org.opendaylight.restconf.server.api.DatabindContext;
46 import org.opendaylight.restconf.server.api.InvokeResult;
47 import org.opendaylight.restconf.server.api.ModulesGetResult;
48 import org.opendaylight.restconf.server.api.OperationInputBody;
49 import org.opendaylight.restconf.server.api.PatchBody;
50 import org.opendaylight.restconf.server.api.ResourceBody;
51 import org.opendaylight.restconf.server.api.RestconfServer;
52 import org.opendaylight.restconf.server.api.ServerException;
53 import org.opendaylight.restconf.server.api.ServerRequest;
54 import org.opendaylight.restconf.server.spi.RpcImplementation;
55 import org.opendaylight.yangtools.yang.common.Empty;
56 import org.opendaylight.yangtools.yang.common.ErrorTag;
57 import org.opendaylight.yangtools.yang.common.ErrorType;
58 import org.opendaylight.yangtools.yang.common.QName;
59 import org.opendaylight.yangtools.yang.common.Revision;
60 import org.opendaylight.yangtools.yang.common.YangNames;
61 import org.opendaylight.yangtools.yang.model.api.source.SourceIdentifier;
62 import org.opendaylight.yangtools.yang.model.api.source.SourceRepresentation;
63 import org.opendaylight.yangtools.yang.model.api.source.YangTextSource;
64 import org.opendaylight.yangtools.yang.model.api.source.YinTextSource;
65 import org.osgi.service.component.annotations.Activate;
66 import org.osgi.service.component.annotations.Component;
67 import org.osgi.service.component.annotations.Deactivate;
68 import org.osgi.service.component.annotations.Reference;
69 import org.osgi.service.component.annotations.ReferencePolicyOption;
72 * A RESTCONF server implemented on top of MD-SAL.
75 @Component(service = RestconfServer.class)
76 public final class MdsalRestconfServer implements RestconfServer, AutoCloseable {
77 private static final VarHandle LOCAL_STRATEGY;
81 LOCAL_STRATEGY = MethodHandles.lookup()
82 .findVarHandle(MdsalRestconfServer.class, "localStrategy", MdsalRestconfStrategy.class);
83 } catch (NoSuchFieldException | IllegalAccessException e) {
84 throw new ExceptionInInitializerError(e);
88 private final @NonNull ImmutableMap<QName, RpcImplementation> localRpcs;
89 private final @NonNull DOMMountPointService mountPointService;
90 private final @NonNull MdsalDatabindProvider databindProvider;
91 private final @NonNull DOMDataBroker dataBroker;
92 private final @Nullable DOMRpcService rpcService;
93 private final @Nullable DOMActionService actionService;
95 @SuppressFBWarnings(value = "URF_UNREAD_FIELD", justification = "https://github.com/spotbugs/spotbugs/issues/2749")
96 private volatile MdsalRestconfStrategy localStrategy;
100 public MdsalRestconfServer(@Reference final MdsalDatabindProvider databindProvider,
101 @Reference final DOMDataBroker dataBroker, @Reference final DOMRpcService rpcService,
102 @Reference final DOMActionService actionService,
103 @Reference final DOMMountPointService mountPointService,
104 @Reference(policyOption = ReferencePolicyOption.GREEDY) final List<RpcImplementation> localRpcs) {
105 this.databindProvider = requireNonNull(databindProvider);
106 this.dataBroker = requireNonNull(dataBroker);
107 this.rpcService = requireNonNull(rpcService);
108 this.actionService = requireNonNull(actionService);
109 this.mountPointService = requireNonNull(mountPointService);
111 this.localRpcs = Maps.uniqueIndex(localRpcs, RpcImplementation::qname);
112 localStrategy = createLocalStrategy(databindProvider.currentDatabind());
115 public MdsalRestconfServer(final MdsalDatabindProvider databindProvider, final DOMDataBroker dataBroker,
116 final DOMRpcService rpcService, final DOMActionService actionService,
117 final DOMMountPointService mountPointService, final RpcImplementation... localRpcs) {
118 this(databindProvider, dataBroker, rpcService, actionService, mountPointService, List.of(localRpcs));
121 private @NonNull MdsalRestconfStrategy createLocalStrategy(final DatabindContext databind) {
122 return new MdsalRestconfStrategy(databind, dataBroker, localRpcs, rpcService, actionService,
123 databindProvider.sourceProvider(), mountPointService);
126 private @NonNull MdsalRestconfStrategy localStrategy() {
127 final var strategy = verifyNotNull((@NonNull MdsalRestconfStrategy) LOCAL_STRATEGY.getAcquire(this));
128 final var databind = databindProvider.currentDatabind();
129 return databind.equals(strategy.databind()) ? strategy : updateLocalStrategy(databind);
132 private @NonNull MdsalRestconfStrategy updateLocalStrategy(final DatabindContext databind) {
133 final var strategy = createLocalStrategy(databind);
134 localStrategy = strategy;
141 public void close() {
142 localStrategy = null;
146 public void dataDELETE(final ServerRequest<Empty> request, final ApiPath identifier) {
147 final StrategyAndTail stratAndTail;
149 stratAndTail = localStrategy().resolveStrategy(identifier);
150 } catch (ServerException e) {
151 request.completeWith(e);
154 stratAndTail.strategy().dataDELETE(request, stratAndTail.tail());
158 public void dataGET(final ServerRequest<DataGetResult> request) {
159 localStrategy().dataGET(request, ApiPath.empty());
163 public void dataGET(final ServerRequest<DataGetResult> request, final ApiPath identifier) {
164 final StrategyAndTail stratAndTail;
166 stratAndTail = localStrategy().resolveStrategy(identifier);
167 } catch (ServerException e) {
168 request.completeWith(e);
171 stratAndTail.strategy().dataGET(request, stratAndTail.tail());
175 public void dataPATCH(final ServerRequest<DataPatchResult> request, final ResourceBody body) {
176 localStrategy().dataPATCH(request, ApiPath.empty(), body);
180 public void dataPATCH(final ServerRequest<DataPatchResult> request, final ApiPath identifier,
181 final ResourceBody body) {
182 final StrategyAndTail strategyAndTail;
184 strategyAndTail = localStrategy().resolveStrategy(identifier);
185 } catch (ServerException e) {
186 request.completeWith(e);
189 strategyAndTail.strategy().dataPATCH(request, strategyAndTail.tail(), body);
193 public void dataPATCH(final ServerRequest<DataYangPatchResult> request, final PatchBody body) {
194 localStrategy().dataPATCH(request, ApiPath.empty(), body);
198 public void dataPATCH(final ServerRequest<DataYangPatchResult> request, final ApiPath identifier,
199 final PatchBody body) {
200 final StrategyAndTail strategyAndTail;
202 strategyAndTail = localStrategy().resolveStrategy(identifier);
203 } catch (ServerException e) {
204 request.completeWith(e);
207 strategyAndTail.strategy().dataPATCH(request, strategyAndTail.tail(), body);
211 public void dataPOST(final ServerRequest<CreateResourceResult> request, final ChildBody body) {
212 localStrategy().dataCreatePOST(request, body);
216 public void dataPOST(final ServerRequest<DataPostResult> request, final ApiPath identifier,
217 final DataPostBody body) {
218 final StrategyAndTail strategyAndTail;
220 strategyAndTail = localStrategy().resolveStrategy(identifier);
221 } catch (ServerException e) {
222 request.completeWith(e);
225 strategyAndTail.strategy().dataPOST(request, strategyAndTail.tail(), body);
229 public void dataPUT(final ServerRequest<DataPutResult> request, final ResourceBody body) {
230 localStrategy().dataPUT(request, ApiPath.empty(), body);
234 public void dataPUT(final ServerRequest<DataPutResult> request, final ApiPath identifier, final ResourceBody body) {
235 final StrategyAndTail strategyAndTail;
237 strategyAndTail = localStrategy().resolveStrategy(identifier);
238 } catch (ServerException e) {
239 request.completeWith(e);
242 strategyAndTail.strategy().dataPUT(request, strategyAndTail.tail(), body);
246 public void modulesYangGET(final ServerRequest<ModulesGetResult> request, final String fileName,
247 final String revision) {
248 modulesGET(request, fileName, revision, YangTextSource.class);
252 public void modulesYangGET(final ServerRequest<ModulesGetResult> request, final ApiPath mountPath,
253 final String fileName, final String revision) {
254 modulesGET(request, mountPath, fileName, revision, YangTextSource.class);
258 public void modulesYinGET(final ServerRequest<ModulesGetResult> request, final String fileName,
259 final String revision) {
260 modulesGET(request, fileName, revision, YinTextSource.class);
264 public void modulesYinGET(final ServerRequest<ModulesGetResult> request, final ApiPath mountPath,
265 final String fileName, final String revision) {
266 modulesGET(request, mountPath, fileName, revision, YinTextSource.class);
269 private void modulesGET(final ServerRequest<ModulesGetResult> request, final String fileName, final String revision,
270 final Class<? extends SourceRepresentation> representation) {
271 modulesGET(request, localStrategy(), fileName, revision, representation);
274 private void modulesGET(final ServerRequest<ModulesGetResult> request, final ApiPath mountPath,
275 final String fileName, final String revision, final Class<? extends SourceRepresentation> representation) {
276 final var mountOffset = mountPath.indexOf("yang-ext", "mount");
277 if (mountOffset != mountPath.steps().size() - 1) {
278 request.completeWith(new RestconfDocumentedException("Mount path has to end with yang-ext:mount"));
282 final StrategyAndTail stratAndTail;
284 stratAndTail = localStrategy().resolveStrategy(mountPath);
285 } catch (ServerException e) {
286 request.completeWith(e);
289 // FIXME: require remnant to be empty
290 modulesGET(request, stratAndTail.strategy(), fileName, revision, representation);
293 private static void modulesGET(final ServerRequest<ModulesGetResult> request, final RestconfStrategy strategy,
294 final String moduleName, final String revisionStr,
295 final Class<? extends SourceRepresentation> representation) {
296 if (moduleName == null) {
297 request.completeWith(new RestconfDocumentedException("Module name must be supplied",
298 ErrorType.PROTOCOL, ErrorTag.INVALID_VALUE));
301 if (moduleName.isEmpty() || !YangNames.IDENTIFIER_START.matches(moduleName.charAt(0))) {
302 request.completeWith(new RestconfDocumentedException(
303 "Identifier must start with character from set 'a-zA-Z_", ErrorType.PROTOCOL, ErrorTag.INVALID_VALUE));
306 if (moduleName.toUpperCase(Locale.ROOT).startsWith("XML")) {
307 request.completeWith(new RestconfDocumentedException(
308 "Identifier must NOT start with XML ignore case", ErrorType.PROTOCOL, ErrorTag.INVALID_VALUE));
311 if (YangNames.NOT_IDENTIFIER_PART.matchesAnyOf(moduleName.substring(1))) {
312 request.completeWith(new RestconfDocumentedException(
313 "Supplied name has not expected identifier format", ErrorType.PROTOCOL, ErrorTag.INVALID_VALUE));
317 // YANG Revision-compliant string is required
318 final Revision revision;
320 revision = Revision.ofNullable(revisionStr).orElse(null);
321 } catch (final DateTimeParseException e) {
322 request.completeWith(new RestconfDocumentedException(
323 "Supplied revision is not in expected date format YYYY-mm-dd",
324 ErrorType.PROTOCOL, ErrorTag.INVALID_VALUE, e));
328 strategy.resolveSource(request, new SourceIdentifier(moduleName, revision), representation);
332 public void operationsGET(final ServerRequest<FormattableBody> request) {
333 localStrategy().operationsGET(request);
337 public void operationsGET(final ServerRequest<FormattableBody> request, final ApiPath operation) {
338 final StrategyAndTail strategyAndTail;
340 strategyAndTail = localStrategy().resolveStrategy(operation);
341 } catch (ServerException e) {
342 request.completeWith(e);
346 final var strategy = strategyAndTail.strategy();
347 final var tail = strategyAndTail.tail();
348 if (tail.isEmpty()) {
349 strategy.operationsGET(request);
351 strategy.operationsGET(request, tail);
356 public void operationsPOST(final ServerRequest<InvokeResult> request, final URI restconfURI, final ApiPath apiPath,
357 final OperationInputBody body) {
358 final StrategyAndTail strategyAndTail;
360 strategyAndTail = localStrategy().resolveStrategy(apiPath);
361 } catch (ServerException e) {
362 request.completeWith(e);
365 strategyAndTail.strategy().operationsPOST(request, restconfURI, strategyAndTail.tail(), body);
369 public void yangLibraryVersionGET(final ServerRequest<FormattableBody> request) {
370 localStrategy().yangLibraryVersionGET(request);