2 * Copyright (c) 2013 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
9 package org.opendaylight.netconf.client;
11 import com.google.common.base.Strings;
12 import com.google.common.collect.ImmutableSet;
13 import com.google.common.collect.Interner;
14 import com.google.common.collect.Interners;
15 import io.netty.channel.Channel;
16 import io.netty.channel.ChannelFuture;
17 import io.netty.channel.ChannelFutureListener;
18 import io.netty.channel.ChannelHandlerContext;
19 import io.netty.channel.ChannelInboundHandlerAdapter;
20 import io.netty.util.Timer;
21 import io.netty.util.concurrent.Promise;
23 import javax.xml.xpath.XPathConstants;
24 import javax.xml.xpath.XPathExpression;
25 import org.opendaylight.controller.config.util.xml.XmlUtil;
26 import org.opendaylight.netconf.api.NetconfClientSessionPreferences;
27 import org.opendaylight.netconf.api.NetconfDocumentedException;
28 import org.opendaylight.netconf.api.NetconfMessage;
29 import org.opendaylight.netconf.api.messages.NetconfHelloMessage;
30 import org.opendaylight.netconf.api.xml.XmlNetconfConstants;
31 import org.opendaylight.netconf.nettyutil.AbstractChannelInitializer;
32 import org.opendaylight.netconf.nettyutil.AbstractNetconfSessionNegotiator;
33 import org.opendaylight.netconf.nettyutil.handler.exi.NetconfStartExiMessage;
34 import org.opendaylight.netconf.util.messages.NetconfMessageUtil;
35 import org.opendaylight.netconf.util.xml.XMLNetconfUtil;
36 import org.slf4j.Logger;
37 import org.slf4j.LoggerFactory;
38 import org.w3c.dom.Document;
39 import org.w3c.dom.Node;
40 import org.w3c.dom.NodeList;
42 public class NetconfClientSessionNegotiator extends
43 AbstractNetconfSessionNegotiator<NetconfClientSessionPreferences, NetconfClientSession, NetconfClientSessionListener>
45 private static final Logger LOG = LoggerFactory.getLogger(NetconfClientSessionNegotiator.class);
47 private static final XPathExpression sessionIdXPath = XMLNetconfUtil
48 .compileXPath("/netconf:hello/netconf:session-id");
50 private static final XPathExpression sessionIdXPathNoNamespace = XMLNetconfUtil
51 .compileXPath("/hello/session-id");
53 private static final String EXI_1_0_CAPABILITY_MARKER = "exi:1.0";
55 private static final Interner<Set<String>> INTERNER = Interners.newWeakInterner();
57 protected NetconfClientSessionNegotiator(final NetconfClientSessionPreferences sessionPreferences,
58 final Promise<NetconfClientSession> promise,
59 final Channel channel,
61 final NetconfClientSessionListener sessionListener,
62 final long connectionTimeoutMillis) {
63 super(sessionPreferences, promise, channel, timer, sessionListener, connectionTimeoutMillis);
67 protected void handleMessage(final NetconfHelloMessage netconfMessage) throws NetconfDocumentedException {
68 final NetconfClientSession session = getSessionForHelloMessage(netconfMessage);
69 replaceHelloMessageInboundHandler(session);
71 // If exi should be used, try to initiate exi communication
72 // Call negotiationSuccessFul after exi negotiation is finished successfully or not
73 if (shouldUseExi(netconfMessage)) {
74 LOG.debug("Netconf session {} should use exi.", session);
75 NetconfStartExiMessage startExiMessage = (NetconfStartExiMessage) sessionPreferences.getStartExiMessage();
76 tryToInitiateExi(session, startExiMessage);
78 // Exi is not supported, release session immediately
79 LOG.debug("Netconf session {} isn't capable of using exi.", session);
80 negotiationSuccessful(session);
85 * Initiates exi communication by sending start-exi message and waiting for positive/negative response.
87 * @param startExiMessage
89 void tryToInitiateExi(final NetconfClientSession session, final NetconfStartExiMessage startExiMessage) {
90 channel.pipeline().addAfter(AbstractChannelInitializer.NETCONF_MESSAGE_DECODER,
91 ExiConfirmationInboundHandler.EXI_CONFIRMED_HANDLER,
92 new ExiConfirmationInboundHandler(session, startExiMessage));
94 session.sendMessage(startExiMessage).addListener(new ChannelFutureListener() {
96 public void operationComplete(final ChannelFuture f) {
98 LOG.warn("Failed to send start-exi message {} on session {}", startExiMessage, this, f.cause());
99 channel.pipeline().remove(ExiConfirmationInboundHandler.EXI_CONFIRMED_HANDLER);
101 LOG.trace("Start-exi message {} sent to socket on session {}", startExiMessage, this);
107 private boolean shouldUseExi(final NetconfHelloMessage helloMsg) {
108 return containsExi10Capability(helloMsg.getDocument())
109 && containsExi10Capability(sessionPreferences.getHelloMessage().getDocument());
112 private static boolean containsExi10Capability(final Document doc) {
113 final NodeList nList = doc.getElementsByTagName(XmlNetconfConstants.CAPABILITY);
114 for (int i = 0; i < nList.getLength(); i++) {
115 if (nList.item(i).getTextContent().contains(EXI_1_0_CAPABILITY_MARKER)) {
122 private static long extractSessionId(final Document doc) {
123 String textContent = getSessionIdWithXPath(doc, sessionIdXPath);
124 if (Strings.isNullOrEmpty(textContent)) {
125 textContent = getSessionIdWithXPath(doc, sessionIdXPathNoNamespace);
126 if (Strings.isNullOrEmpty(textContent)) {
127 throw new IllegalStateException("Session id not received from server, hello message: " + XmlUtil.toString(doc));
131 return Long.valueOf(textContent);
134 private static String getSessionIdWithXPath(final Document doc, final XPathExpression sessionIdXPath) {
135 final Node sessionIdNode = (Node) XmlUtil.evaluateXPath(sessionIdXPath, doc, XPathConstants.NODE);
136 return sessionIdNode != null ? sessionIdNode.getTextContent() : null;
140 protected NetconfClientSession getSession(final NetconfClientSessionListener sessionListener, final Channel channel,
141 final NetconfHelloMessage message) throws NetconfDocumentedException {
142 final long sessionId = extractSessionId(message.getDocument());
144 // Copy here is important: it disconnects the strings from the document
145 Set<String> capabilities = ImmutableSet.copyOf(NetconfMessageUtil.extractCapabilitiesFromHello(message.getDocument()));
147 capabilities = INTERNER.intern(capabilities);
149 return new NetconfClientSession(sessionListener, channel, sessionId, capabilities);
153 * Handler to process response for start-exi message
155 private final class ExiConfirmationInboundHandler extends ChannelInboundHandlerAdapter {
156 private static final String EXI_CONFIRMED_HANDLER = "exiConfirmedHandler";
158 private final NetconfClientSession session;
159 private final NetconfStartExiMessage startExiMessage;
161 ExiConfirmationInboundHandler(final NetconfClientSession session, final NetconfStartExiMessage startExiMessage) {
162 this.session = session;
163 this.startExiMessage = startExiMessage;
167 public void channelRead(final ChannelHandlerContext ctx, final Object msg) throws Exception {
168 ctx.pipeline().remove(ExiConfirmationInboundHandler.EXI_CONFIRMED_HANDLER);
170 NetconfMessage netconfMessage = (NetconfMessage) msg;
172 // Ok response to start-exi, try to add exi handlers
173 if (NetconfMessageUtil.isOKMessage(netconfMessage)) {
174 LOG.trace("Positive response on start-exi call received on session {}", session);
176 session.startExiCommunication(startExiMessage);
177 } catch (RuntimeException e) {
178 // Unable to add exi, continue without exi
179 LOG.warn("Unable to start exi communication, Communication will continue without exi on session {}", session, e);
183 } else if(NetconfMessageUtil.isErrorMessage(netconfMessage)) {
185 "Error response to start-exi message {}, Communication will continue without exi on session {}",
186 netconfMessage, session);
188 // Unexpected response to start-exi, throwing message away, continue without exi
190 LOG.warn("Unexpected response to start-exi message, should be ok, was {}, " +
191 "Communication will continue without exi and response message will be thrown away on session {}",
192 netconfMessage, session);
195 negotiationSuccessful(session);