2 * Copyright (c) 2016 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.netconf.sal.connect.netconf.util;
10 import static org.junit.Assert.assertEquals;
11 import static org.junit.Assert.assertThrows;
12 import static org.junit.Assert.assertTrue;
13 import static org.mockito.ArgumentMatchers.any;
14 import static org.mockito.ArgumentMatchers.argThat;
15 import static org.mockito.ArgumentMatchers.eq;
16 import static org.mockito.Mockito.verify;
17 import static org.mockito.Mockito.when;
19 import java.io.IOException;
20 import java.io.InputStream;
21 import java.net.InetSocketAddress;
23 import java.util.ArrayList;
24 import java.util.Collections;
25 import java.util.List;
26 import java.util.Optional;
27 import java.util.concurrent.ExecutionException;
28 import org.custommonkey.xmlunit.Diff;
29 import org.custommonkey.xmlunit.XMLUnit;
30 import org.junit.Before;
31 import org.junit.Test;
32 import org.junit.runner.RunWith;
33 import org.mockito.ArgumentMatcher;
34 import org.mockito.Mock;
35 import org.mockito.junit.MockitoJUnitRunner;
36 import org.opendaylight.mdsal.dom.api.DOMRpcService;
37 import org.opendaylight.netconf.api.ModifyAction;
38 import org.opendaylight.netconf.api.NetconfMessage;
39 import org.opendaylight.netconf.api.xml.XmlUtil;
40 import org.opendaylight.netconf.sal.connect.api.MessageTransformer;
41 import org.opendaylight.netconf.sal.connect.api.RemoteDeviceCommunicator;
42 import org.opendaylight.netconf.sal.connect.netconf.AbstractTestModelTest;
43 import org.opendaylight.netconf.sal.connect.netconf.sal.NetconfDeviceRpc;
44 import org.opendaylight.netconf.sal.connect.netconf.schema.mapping.NetconfMessageTransformer;
45 import org.opendaylight.netconf.sal.connect.util.RemoteDeviceId;
46 import org.opendaylight.netconf.util.NetconfUtil;
47 import org.opendaylight.yangtools.rcf8528.data.util.EmptyMountPointContext;
48 import org.opendaylight.yangtools.yang.common.QName;
49 import org.opendaylight.yangtools.yang.common.QNameModule;
50 import org.opendaylight.yangtools.yang.common.Revision;
51 import org.opendaylight.yangtools.yang.common.RpcResultBuilder;
52 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier;
53 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.NodeIdentifier;
54 import org.opendaylight.yangtools.yang.data.api.schema.DataContainerChild;
55 import org.opendaylight.yangtools.yang.data.api.schema.LeafNode;
56 import org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode;
57 import org.opendaylight.yangtools.yang.data.impl.schema.Builders;
58 import org.w3c.dom.Document;
59 import org.w3c.dom.Element;
60 import org.w3c.dom.NamedNodeMap;
61 import org.xml.sax.SAXException;
63 @RunWith(MockitoJUnitRunner.StrictStubs.class)
64 public class NetconfBaseOpsTest extends AbstractTestModelTest {
65 private static final QNameModule TEST_MODULE = QNameModule.create(
66 URI.create("test:namespace"), Revision.of("2013-07-22"));
68 private static final QName CONTAINER_C_QNAME = QName.create(TEST_MODULE, "c");
69 private static final NodeIdentifier CONTAINER_C_NID = NodeIdentifier.create(CONTAINER_C_QNAME);
70 private static final QName LEAF_A_QNAME = QName.create(TEST_MODULE, "a");
71 private static final NodeIdentifier LEAF_A_NID = NodeIdentifier.create(LEAF_A_QNAME);
72 private static final QName LEAF_B_QNAME = QName.create(TEST_MODULE, "b");
73 private static final NodeIdentifier LEAF_B_NID = NodeIdentifier.create(LEAF_B_QNAME);
74 private static final QName CONTAINER_D_QNAME = QName.create(TEST_MODULE, "d");
75 private static final NodeIdentifier CONTAINER_D_NID = NodeIdentifier.create(CONTAINER_D_QNAME);
76 private static final QName LEAF_X_QNAME = QName.create(TEST_MODULE, "x");
77 private static final NodeIdentifier LEAF_X_NID = NodeIdentifier.create(LEAF_X_QNAME);
79 private static final QName CONTAINER_E_QNAME = QName.create(TEST_MODULE, "e");
80 private static final NodeIdentifier CONTAINER_E_NID = NodeIdentifier.create(CONTAINER_E_QNAME);
81 private static final QName LEAF_Z_QNAME = QName.create(TEST_MODULE, "z");
82 private static final NodeIdentifier LEAF_Z_NID = NodeIdentifier.create(LEAF_Z_QNAME);
85 XMLUnit.setIgnoreWhitespace(true);
86 XMLUnit.setIgnoreComments(true);
90 private RemoteDeviceCommunicator<NetconfMessage> listener;
91 private NetconfRpcFutureCallback callback;
92 private NetconfBaseOps baseOps;
95 public void setUp() throws Exception {
96 final InputStream okStream = getClass().getResourceAsStream("/netconfMessages/rpc-reply_ok.xml");
97 final InputStream dataStream = getClass().getResourceAsStream("/netconfMessages/rpc-reply_get.xml");
98 final NetconfMessage ok = new NetconfMessage(XmlUtil.readXmlToDocument(okStream));
99 final NetconfMessage data = new NetconfMessage(XmlUtil.readXmlToDocument(dataStream));
100 when(listener.sendRequest(any(), eq(NetconfMessageTransformUtil.NETCONF_GET_CONFIG_QNAME)))
101 .thenReturn(RpcResultBuilder.success(data).buildFuture());
102 when(listener.sendRequest(any(), eq(NetconfMessageTransformUtil.NETCONF_GET_QNAME)))
103 .thenReturn(RpcResultBuilder.success(data).buildFuture());
104 when(listener.sendRequest(any(), eq(NetconfMessageTransformUtil.NETCONF_EDIT_CONFIG_QNAME)))
105 .thenReturn(RpcResultBuilder.success(ok).buildFuture());
106 when(listener.sendRequest(any(), eq(NetconfMessageTransformUtil.NETCONF_COPY_CONFIG_QNAME)))
107 .thenReturn(RpcResultBuilder.success(ok).buildFuture());
108 when(listener.sendRequest(any(), eq(NetconfMessageTransformUtil.NETCONF_DISCARD_CHANGES_QNAME)))
109 .thenReturn(RpcResultBuilder.success(ok).buildFuture());
110 when(listener.sendRequest(any(), eq(NetconfMessageTransformUtil.NETCONF_VALIDATE_QNAME)))
111 .thenReturn(RpcResultBuilder.success(ok).buildFuture());
112 when(listener.sendRequest(any(), eq(NetconfMessageTransformUtil.NETCONF_LOCK_QNAME)))
113 .thenReturn(RpcResultBuilder.success(ok).buildFuture());
114 when(listener.sendRequest(any(), eq(NetconfMessageTransformUtil.NETCONF_UNLOCK_QNAME)))
115 .thenReturn(RpcResultBuilder.success(ok).buildFuture());
116 when(listener.sendRequest(any(), eq(NetconfMessageTransformUtil.NETCONF_COMMIT_QNAME)))
117 .thenReturn(RpcResultBuilder.success(ok).buildFuture());
118 final MessageTransformer<NetconfMessage> transformer = new NetconfMessageTransformer(
119 new EmptyMountPointContext(SCHEMA_CONTEXT), true, BASE_SCHEMAS.getBaseSchema());
120 final DOMRpcService rpc = new NetconfDeviceRpc(SCHEMA_CONTEXT, listener, transformer);
121 final RemoteDeviceId id =
122 new RemoteDeviceId("device-1", InetSocketAddress.createUnresolved("localhost", 17830));
123 callback = new NetconfRpcFutureCallback("prefix", id);
124 baseOps = new NetconfBaseOps(rpc, new EmptyMountPointContext(SCHEMA_CONTEXT));
128 public void testLock() throws Exception {
129 baseOps.lock(callback, NetconfMessageTransformUtil.NETCONF_CANDIDATE_QNAME);
130 verifyMessageSent("lock", NetconfMessageTransformUtil.NETCONF_LOCK_QNAME);
134 public void testLockCandidate() throws Exception {
135 baseOps.lockCandidate(callback);
136 verifyMessageSent("lock", NetconfMessageTransformUtil.NETCONF_LOCK_QNAME);
140 public void testUnlock() throws Exception {
141 baseOps.unlock(callback, NetconfMessageTransformUtil.NETCONF_CANDIDATE_QNAME);
142 verifyMessageSent("unlock", NetconfMessageTransformUtil.NETCONF_UNLOCK_QNAME);
146 public void testUnlockCandidate() throws Exception {
147 baseOps.unlockCandidate(callback);
148 verifyMessageSent("unlock", NetconfMessageTransformUtil.NETCONF_UNLOCK_QNAME);
152 public void testLockRunning() throws Exception {
153 baseOps.lockRunning(callback);
154 verifyMessageSent("lock-running", NetconfMessageTransformUtil.NETCONF_LOCK_QNAME);
158 public void testUnlockRunning() throws Exception {
159 baseOps.unlockRunning(callback);
160 verifyMessageSent("unlock-running", NetconfMessageTransformUtil.NETCONF_UNLOCK_QNAME);
164 public void testDiscardChanges() throws Exception {
165 baseOps.discardChanges(callback);
166 verifyMessageSent("discardChanges", NetconfMessageTransformUtil.NETCONF_DISCARD_CHANGES_QNAME);
170 public void testCommit() throws Exception {
171 baseOps.commit(callback);
172 verifyMessageSent("commit", NetconfMessageTransformUtil.NETCONF_COMMIT_QNAME);
176 public void testValidateCandidate() throws Exception {
177 baseOps.validateCandidate(callback);
178 verifyMessageSent("validate", NetconfMessageTransformUtil.NETCONF_VALIDATE_QNAME);
182 public void testValidateRunning() throws Exception {
183 baseOps.validateRunning(callback);
184 verifyMessageSent("validate-running", NetconfMessageTransformUtil.NETCONF_VALIDATE_QNAME);
189 public void testCopyConfig() throws Exception {
190 baseOps.copyConfig(callback, NetconfMessageTransformUtil.NETCONF_RUNNING_QNAME,
191 NetconfMessageTransformUtil.NETCONF_CANDIDATE_QNAME);
192 verifyMessageSent("copy-config", NetconfMessageTransformUtil.NETCONF_COPY_CONFIG_QNAME);
196 public void testCopyRunningToCandidate() throws Exception {
197 baseOps.copyRunningToCandidate(callback);
198 verifyMessageSent("copy-config", NetconfMessageTransformUtil.NETCONF_COPY_CONFIG_QNAME);
203 public void testGetConfigRunningData() throws Exception {
204 final Optional<NormalizedNode<?, ?>> dataOpt =
205 baseOps.getConfigRunningData(callback, Optional.of(YangInstanceIdentifier.empty())).get();
206 assertTrue(dataOpt.isPresent());
207 assertEquals(NetconfUtil.NETCONF_DATA_QNAME, dataOpt.get().getNodeType());
211 public void testGetData() throws Exception {
212 final Optional<NormalizedNode<?, ?>> dataOpt =
213 baseOps.getData(callback, Optional.of(YangInstanceIdentifier.empty())).get();
214 assertTrue(dataOpt.isPresent());
215 assertEquals(NetconfUtil.NETCONF_DATA_QNAME, dataOpt.get().getNodeType());
219 public void testGetConfigRunning() throws Exception {
220 baseOps.getConfigRunning(callback, Optional.empty());
221 verifyMessageSent("getConfig", NetconfMessageTransformUtil.NETCONF_GET_CONFIG_QNAME);
225 public void testGetConfigCandidate() throws Exception {
226 baseOps.getConfigCandidate(callback, Optional.empty());
227 verifyMessageSent("getConfig_candidate", NetconfMessageTransformUtil.NETCONF_GET_CONFIG_QNAME);
231 public void testGetConfigCandidateWithFilter() throws Exception {
232 final YangInstanceIdentifier id = YangInstanceIdentifier.builder()
233 .node(CONTAINER_C_QNAME)
235 baseOps.getConfigCandidate(callback, Optional.of(id));
236 verifyMessageSent("getConfig_candidate-filter", NetconfMessageTransformUtil.NETCONF_GET_CONFIG_QNAME);
240 public void testGet() throws Exception {
241 baseOps.get(callback, Optional.empty());
242 verifyMessageSent("get", NetconfMessageTransformUtil.NETCONF_GET_QNAME);
246 public void testEditConfigCandidate() throws Exception {
247 final LeafNode<Object> leaf = Builders.leafBuilder()
248 .withNodeIdentifier(LEAF_A_NID)
249 .withValue("leaf-value")
251 final YangInstanceIdentifier leafId = YangInstanceIdentifier.builder()
252 .node(CONTAINER_C_QNAME)
255 final DataContainerChild<?, ?> structure = baseOps.createEditConfigStrcture(Optional.of(leaf),
256 Optional.of(ModifyAction.REPLACE), leafId);
257 baseOps.editConfigCandidate(callback, structure, true);
258 verifyMessageSent("edit-config-test-module", NetconfMessageTransformUtil.NETCONF_EDIT_CONFIG_QNAME);
262 public void testEditConfigRunning() throws Exception {
263 final LeafNode<Object> leaf = Builders.leafBuilder()
264 .withNodeIdentifier(LEAF_A_NID)
265 .withValue("leaf-value")
267 final YangInstanceIdentifier leafId = YangInstanceIdentifier.builder()
268 .node(CONTAINER_C_NID)
271 final DataContainerChild<?, ?> structure = baseOps.createEditConfigStrcture(Optional.of(leaf),
272 Optional.of(ModifyAction.REPLACE), leafId);
273 baseOps.editConfigRunning(callback, structure, ModifyAction.MERGE, true);
274 verifyMessageSent("edit-config-test-module-running", NetconfMessageTransformUtil.NETCONF_EDIT_CONFIG_QNAME);
278 public void testGetWithFields() throws ExecutionException, InterruptedException {
279 final YangInstanceIdentifier path = YangInstanceIdentifier.create(CONTAINER_C_NID);
280 final YangInstanceIdentifier leafAField = YangInstanceIdentifier.create(LEAF_A_NID);
281 final YangInstanceIdentifier leafBField = YangInstanceIdentifier.create(LEAF_B_NID);
283 baseOps.getData(callback, Optional.of(path), List.of(leafAField, leafBField)).get();
284 verify(listener).sendRequest(msg("/netconfMessages/get-fields-request.xml"),
285 eq(NetconfMessageTransformUtil.NETCONF_GET_QNAME));
289 public void testGetConfigWithFields() throws ExecutionException, InterruptedException {
290 final YangInstanceIdentifier path = YangInstanceIdentifier.create(CONTAINER_C_NID);
291 final YangInstanceIdentifier leafAField = YangInstanceIdentifier.create(LEAF_A_NID);
292 final YangInstanceIdentifier leafBField = YangInstanceIdentifier.create(LEAF_B_NID);
294 baseOps.getConfigRunningData(callback, Optional.of(path), List.of(leafAField, leafBField)).get();
295 verify(listener).sendRequest(msg("/netconfMessages/get-config-fields-request.xml"),
296 eq(NetconfMessageTransformUtil.NETCONF_GET_CONFIG_QNAME));
300 public void testGetDataWithoutFields() {
301 assertThrows(ExecutionException.class, () -> baseOps.getData(callback,
302 Optional.of(YangInstanceIdentifier.empty()), Collections.emptyList()).get());
306 public void getConfigRunningDataWithoutFields() {
307 assertThrows(ExecutionException.class, () -> baseOps.getConfigRunningData(callback,
308 Optional.of(YangInstanceIdentifier.empty()), Collections.emptyList()).get());
312 public void testGetWithFieldsAndEmptyParentPath() throws ExecutionException, InterruptedException {
313 final YangInstanceIdentifier leafAField = YangInstanceIdentifier.create(CONTAINER_C_NID, LEAF_A_NID);
314 final YangInstanceIdentifier leafXField = YangInstanceIdentifier.create(
315 CONTAINER_C_NID, CONTAINER_D_NID, LEAF_X_NID);
316 final YangInstanceIdentifier leafZField = YangInstanceIdentifier.create(CONTAINER_E_NID, LEAF_Z_NID);
318 baseOps.getData(callback, Optional.of(YangInstanceIdentifier.empty()),
319 List.of(leafAField, leafXField, leafZField)).get();
320 verify(listener).sendRequest(msg("/netconfMessages/get-with-multiple-subtrees.xml"),
321 eq(NetconfMessageTransformUtil.NETCONF_GET_QNAME));
325 public void testGetConfigWithFieldsAndEmptyParentPath() throws ExecutionException, InterruptedException {
326 final YangInstanceIdentifier leafAField = YangInstanceIdentifier.create(CONTAINER_C_NID, LEAF_A_NID);
327 final YangInstanceIdentifier leafXField = YangInstanceIdentifier.create(
328 CONTAINER_C_NID, CONTAINER_D_NID, LEAF_X_NID);
329 final YangInstanceIdentifier leafZField = YangInstanceIdentifier.create(CONTAINER_E_NID, LEAF_Z_NID);
331 baseOps.getConfigRunningData(callback, Optional.of(YangInstanceIdentifier.empty()),
332 List.of(leafAField, leafXField, leafZField)).get();
333 verify(listener).sendRequest(msg("/netconfMessages/get-config-with-multiple-subtrees.xml"),
334 eq(NetconfMessageTransformUtil.NETCONF_GET_CONFIG_QNAME));
338 public void testGetWithRootFieldsAndEmptyParentPath() throws ExecutionException, InterruptedException {
339 final YangInstanceIdentifier contCField = YangInstanceIdentifier.create(CONTAINER_C_NID);
340 final YangInstanceIdentifier contDField = YangInstanceIdentifier.create(CONTAINER_E_NID);
342 baseOps.getData(callback, Optional.of(YangInstanceIdentifier.empty()), List.of(contCField, contDField)).get();
343 verify(listener).sendRequest(msg("/netconfMessages/get-with-multiple-root-subtrees.xml"),
344 eq(NetconfMessageTransformUtil.NETCONF_GET_QNAME));
347 private void verifyMessageSent(final String fileName, final QName name) {
348 final String path = "/netconfMessages/" + fileName + ".xml";
349 verify(listener).sendRequest(msg(path), eq(name));
352 private static NetconfMessage msg(final String name) {
353 final InputStream stream = NetconfBaseOpsTest.class.getResourceAsStream(name);
355 return argThat(new NetconfMessageMatcher(XmlUtil.readXmlToDocument(stream)));
356 } catch (SAXException | IOException e) {
357 throw new IllegalStateException("Failed to read xml file " + name, e);
361 private static class NetconfMessageMatcher implements ArgumentMatcher<NetconfMessage> {
363 private final Document expected;
365 NetconfMessageMatcher(final Document expected) {
366 this.expected = removeAttrs(expected);
370 public boolean matches(final NetconfMessage message) {
371 final Document actualDoc = removeAttrs(message.getDocument());
372 actualDoc.normalizeDocument();
373 expected.normalizeDocument();
374 final Diff diff = XMLUnit.compareXML(expected, actualDoc);
375 return diff.similar();
378 private static Document removeAttrs(final Document input) {
379 final Document copy = XmlUtil.newDocument();
380 copy.appendChild(copy.importNode(input.getDocumentElement(), true));
381 final Element element = copy.getDocumentElement();
382 final List<String> attrNames = new ArrayList<>();
383 final NamedNodeMap attributes = element.getAttributes();
384 for (int i = 0; i < attributes.getLength(); i++) {
385 final String nodeName = attributes.item(i).getNodeName();
386 if ("xmlns".equals(nodeName)) {
389 attrNames.add(nodeName);
391 attrNames.forEach(element::removeAttribute);