/* * Copyright (c) 2015 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.netconf.mdsal.connector.ops; import static org.junit.Assert.assertTrue; import static org.junit.Assert.fail; import static org.mockito.Matchers.any; import static org.mockito.Mockito.doAnswer; import static org.mockito.Mockito.doNothing; import static org.mockito.Mockito.doReturn; import static org.mockito.MockitoAnnotations.initMocks; import com.google.common.base.Preconditions; import com.google.common.io.ByteSource; import com.google.common.util.concurrent.CheckedFuture; import com.google.common.util.concurrent.Futures; import java.net.URI; import java.util.Collection; import java.util.Collections; import javax.annotation.Nonnull; import javax.annotation.Nullable; import org.custommonkey.xmlunit.DetailedDiff; import org.custommonkey.xmlunit.Diff; import org.custommonkey.xmlunit.XMLUnit; import org.custommonkey.xmlunit.examples.RecursiveElementNameAndTextQualifier; import org.junit.Before; import org.junit.Test; import org.mockito.Mock; import org.opendaylight.controller.config.util.xml.DocumentedException; import org.opendaylight.controller.config.util.xml.DocumentedException.ErrorSeverity; import org.opendaylight.controller.config.util.xml.DocumentedException.ErrorTag; import org.opendaylight.controller.config.util.xml.DocumentedException.ErrorType; import org.opendaylight.controller.config.util.xml.XmlUtil; import org.opendaylight.controller.md.sal.dom.api.DOMRpcAvailabilityListener; import org.opendaylight.controller.md.sal.dom.api.DOMRpcException; import org.opendaylight.controller.md.sal.dom.api.DOMRpcResult; import org.opendaylight.controller.md.sal.dom.api.DOMRpcService; import org.opendaylight.controller.md.sal.dom.spi.DefaultDOMRpcResult; import org.opendaylight.controller.sal.core.api.model.SchemaService; import org.opendaylight.netconf.mapping.api.HandlingPriority; import org.opendaylight.netconf.mapping.api.NetconfOperationChainedExecution; import org.opendaylight.netconf.mdsal.connector.CurrentSchemaContext; import org.opendaylight.netconf.util.test.XmlFileLoader; import org.opendaylight.yangtools.concepts.ListenerRegistration; import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier; import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.PathArgument; import org.opendaylight.yangtools.yang.data.api.schema.ContainerNode; import org.opendaylight.yangtools.yang.data.api.schema.DataContainerChild; import org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode; import org.opendaylight.yangtools.yang.data.impl.schema.builder.impl.ImmutableContainerNodeBuilder; import org.opendaylight.yangtools.yang.model.api.ContainerSchemaNode; import org.opendaylight.yangtools.yang.model.api.Module; 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.repo.api.SourceIdentifier; import org.opendaylight.yangtools.yang.model.repo.api.YangTextSchemaSource; import org.opendaylight.yangtools.yang.model.repo.spi.SchemaSourceProvider; import org.opendaylight.yangtools.yang.test.util.YangParserTestUtils; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.w3c.dom.Document; public class RuntimeRpcTest { private static final Logger LOG = LoggerFactory.getLogger(RuntimeRpcTest.class); private static final String SESSION_ID_FOR_REPORTING = "netconf-test-session1"; private static final Document RPC_REPLY_OK = RuntimeRpcTest.getReplyOk(); @SuppressWarnings("illegalCatch") private static Document getReplyOk() { Document doc; try { doc = XmlFileLoader.xmlFileToDocument("messages/mapping/rpcs/runtimerpc-ok-reply.xml"); } catch (final Exception e) { LOG.debug("unable to load rpc reply ok.", e); doc = XmlUtil.newDocument(); } return doc; } private static final DOMRpcService RPC_SERVICE_VOID_INVOKER = new DOMRpcService() { @Nonnull @Override public CheckedFuture invokeRpc( @Nonnull final SchemaPath type, @Nullable final NormalizedNode input) { return Futures.immediateCheckedFuture(new DefaultDOMRpcResult(null, Collections.emptyList())); } @Nonnull @Override public ListenerRegistration registerRpcListener( @Nonnull final T listener) { return null; } }; private static final DOMRpcService RPC_SERVICE_FAILED_INVOCATION = new DOMRpcService() { @Nonnull @Override public CheckedFuture invokeRpc( @Nonnull final SchemaPath type, @Nullable final NormalizedNode input) { return Futures.immediateFailedCheckedFuture(new DOMRpcException("rpc invocation not implemented yet") { private static final long serialVersionUID = 1L; }); } @Nonnull @Override public ListenerRegistration registerRpcListener( @Nonnull final T listener) { return null; } }; private final DOMRpcService rpcServiceSuccessfulInvocation = new DOMRpcService() { @Nonnull @Override public CheckedFuture invokeRpc( @Nonnull final SchemaPath type, @Nullable final NormalizedNode input) { final Collection> children = (Collection>) input.getValue(); final Module module = schemaContext.findModule(type.getLastComponent().getNamespace()).orElse(null); final RpcDefinition rpcDefinition = getRpcDefinitionFromModule( module, module.getNamespace(), type.getLastComponent().getLocalName()); final ContainerSchemaNode outputSchemaNode = rpcDefinition.getOutput(); final ContainerNode node = ImmutableContainerNodeBuilder.create() .withNodeIdentifier(new YangInstanceIdentifier.NodeIdentifier(outputSchemaNode.getQName())) .withValue(children).build(); return Futures.immediateCheckedFuture(new DefaultDOMRpcResult(node)); } @Nonnull @Override public ListenerRegistration registerRpcListener( @Nonnull final T lsnr) { return null; } }; private SchemaContext schemaContext = null; private CurrentSchemaContext currentSchemaContext = null; @Mock private SchemaService schemaService; @Mock private SchemaContextListener listener; @Mock private ListenerRegistration registration; @Mock private SchemaSourceProvider sourceProvider; @Before public void setUp() throws Exception { initMocks(this); doNothing().when(registration).close(); doReturn(listener).when(registration).getInstance(); doNothing().when(schemaService).addModule(any(Module.class)); doNothing().when(schemaService).removeModule(any(Module.class)); doReturn(schemaContext).when(schemaService).getGlobalContext(); doReturn(schemaContext).when(schemaService).getSessionContext(); doAnswer(invocationOnMock -> { ((SchemaContextListener) invocationOnMock.getArguments()[0]).onGlobalContextUpdated(schemaContext); return registration; }).when(schemaService).registerSchemaContextListener(any(SchemaContextListener.class)); XMLUnit.setIgnoreWhitespace(true); XMLUnit.setIgnoreAttributeOrder(true); doAnswer(invocationOnMock -> { final SourceIdentifier sId = (SourceIdentifier) invocationOnMock.getArguments()[0]; final YangTextSchemaSource yangTextSchemaSource = YangTextSchemaSource.delegateForByteSource(sId, ByteSource.wrap("module test".getBytes())); return Futures.immediateCheckedFuture(yangTextSchemaSource); }).when(sourceProvider).getSource(any(SourceIdentifier.class)); this.schemaContext = YangParserTestUtils.parseYangResource("/yang/mdsal-netconf-rpc-test.yang"); this.currentSchemaContext = new CurrentSchemaContext(schemaService, sourceProvider); } @Test public void testVoidOutputRpc() throws Exception { final RuntimeRpc rpc = new RuntimeRpc(SESSION_ID_FOR_REPORTING, currentSchemaContext, RPC_SERVICE_VOID_INVOKER); final Document rpcDocument = XmlFileLoader.xmlFileToDocument("messages/mapping/rpcs/rpc-void-output.xml"); final HandlingPriority priority = rpc.canHandle(rpcDocument); Preconditions.checkState(priority != HandlingPriority.CANNOT_HANDLE); final Document response = rpc.handle(rpcDocument, NetconfOperationChainedExecution.EXECUTION_TERMINATION_POINT); verifyResponse(response, RPC_REPLY_OK); } @Test public void testSuccesfullNonVoidInvocation() throws Exception { final RuntimeRpc rpc = new RuntimeRpc( SESSION_ID_FOR_REPORTING, currentSchemaContext, rpcServiceSuccessfulInvocation); final Document rpcDocument = XmlFileLoader.xmlFileToDocument("messages/mapping/rpcs/rpc-nonvoid.xml"); final HandlingPriority priority = rpc.canHandle(rpcDocument); Preconditions.checkState(priority != HandlingPriority.CANNOT_HANDLE); final Document response = rpc.handle(rpcDocument, NetconfOperationChainedExecution.EXECUTION_TERMINATION_POINT); verifyResponse(response, XmlFileLoader.xmlFileToDocument("messages/mapping/rpcs/rpc-nonvoid-control.xml")); } @Test public void testSuccesfullContainerInvocation() throws Exception { final RuntimeRpc rpc = new RuntimeRpc( SESSION_ID_FOR_REPORTING, currentSchemaContext, rpcServiceSuccessfulInvocation); final Document rpcDocument = XmlFileLoader.xmlFileToDocument("messages/mapping/rpcs/rpc-container.xml"); final HandlingPriority priority = rpc.canHandle(rpcDocument); Preconditions.checkState(priority != HandlingPriority.CANNOT_HANDLE); final Document response = rpc.handle(rpcDocument, NetconfOperationChainedExecution.EXECUTION_TERMINATION_POINT); verifyResponse(response, XmlFileLoader.xmlFileToDocument("messages/mapping/rpcs/rpc-container-control.xml")); } @Test public void testFailedInvocation() throws Exception { final RuntimeRpc rpc = new RuntimeRpc( SESSION_ID_FOR_REPORTING, currentSchemaContext, RPC_SERVICE_FAILED_INVOCATION); final Document rpcDocument = XmlFileLoader.xmlFileToDocument("messages/mapping/rpcs/rpc-nonvoid.xml"); final HandlingPriority priority = rpc.canHandle(rpcDocument); Preconditions.checkState(priority != HandlingPriority.CANNOT_HANDLE); try { rpc.handle(rpcDocument, NetconfOperationChainedExecution.EXECUTION_TERMINATION_POINT); fail("should have failed with rpc invocation not implemented yet"); } catch (final DocumentedException e) { assertTrue(e.getErrorType() == ErrorType.APPLICATION); assertTrue(e.getErrorSeverity() == ErrorSeverity.ERROR); assertTrue(e.getErrorTag() == ErrorTag.OPERATION_FAILED); } } @Test public void testVoidInputOutputRpc() throws Exception { final RuntimeRpc rpc = new RuntimeRpc(SESSION_ID_FOR_REPORTING, currentSchemaContext, RPC_SERVICE_VOID_INVOKER); final Document rpcDocument = XmlFileLoader.xmlFileToDocument("messages/mapping/rpcs/rpc-void-input-output.xml"); final HandlingPriority priority = rpc.canHandle(rpcDocument); Preconditions.checkState(priority != HandlingPriority.CANNOT_HANDLE); final Document response = rpc.handle(rpcDocument, NetconfOperationChainedExecution.EXECUTION_TERMINATION_POINT); verifyResponse(response, RPC_REPLY_OK); } @Test public void testBadNamespaceInRpc() throws Exception { final RuntimeRpc rpc = new RuntimeRpc(SESSION_ID_FOR_REPORTING, currentSchemaContext, RPC_SERVICE_VOID_INVOKER); final Document rpcDocument = XmlFileLoader.xmlFileToDocument("messages/mapping/rpcs/rpc-bad-namespace.xml"); try { rpc.handle(rpcDocument, NetconfOperationChainedExecution.EXECUTION_TERMINATION_POINT); fail("Should have failed, rpc has bad namespace"); } catch (final DocumentedException e) { assertTrue(e.getErrorSeverity() == ErrorSeverity.ERROR); assertTrue(e.getErrorTag() == ErrorTag.BAD_ELEMENT); assertTrue(e.getErrorType() == ErrorType.APPLICATION); } } private static void verifyResponse(final Document response, final Document template) { final DetailedDiff dd = new DetailedDiff(new Diff(response, template)); dd.overrideElementQualifier(new RecursiveElementNameAndTextQualifier()); //we care about order so response has to be identical assertTrue(dd.identical()); } private static RpcDefinition getRpcDefinitionFromModule(final Module module, final URI namespaceURI, final String name) { for (final RpcDefinition rpcDef : module.getRpcs()) { if (rpcDef.getQName().getNamespace().equals(namespaceURI) && rpcDef.getQName().getLocalName().equals(name)) { return rpcDef; } } return null; } }