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.Optional;
12 import com.google.common.base.Preconditions;
13 import com.google.common.collect.ImmutableSet;
14 import com.siemens.ct.exi.CodingMode;
15 import com.siemens.ct.exi.FidelityOptions;
16 import com.siemens.ct.exi.exceptions.UnsupportedOption;
17 import io.netty.channel.Channel;
18 import io.netty.util.Timer;
19 import io.netty.util.concurrent.Promise;
21 import org.opendaylight.netconf.api.NetconfClientSessionPreferences;
22 import org.opendaylight.netconf.api.NetconfMessage;
23 import org.opendaylight.netconf.api.messages.NetconfHelloMessage;
24 import org.opendaylight.netconf.api.messages.NetconfHelloMessageAdditionalHeader;
25 import org.opendaylight.netconf.api.xml.XmlNetconfConstants;
26 import org.opendaylight.netconf.nettyutil.handler.exi.EXIParameters;
27 import org.opendaylight.netconf.nettyutil.handler.exi.NetconfStartExiMessage;
28 import org.opendaylight.protocol.framework.SessionListenerFactory;
29 import org.opendaylight.protocol.framework.SessionNegotiator;
30 import org.opendaylight.protocol.framework.SessionNegotiatorFactory;
31 import org.slf4j.Logger;
32 import org.slf4j.LoggerFactory;
34 public class NetconfClientSessionNegotiatorFactory implements SessionNegotiatorFactory<NetconfMessage,
35 NetconfClientSession, NetconfClientSessionListener> {
37 public static final Set<String> EXI_CLIENT_CAPABILITIES = ImmutableSet.of(
38 XmlNetconfConstants.URN_IETF_PARAMS_NETCONF_BASE_1_0,
39 XmlNetconfConstants.URN_IETF_PARAMS_NETCONF_BASE_1_1,
40 XmlNetconfConstants.URN_IETF_PARAMS_NETCONF_CAPABILITY_EXI_1_0);
42 public static final Set<String> LEGACY_EXI_CLIENT_CAPABILITIES = ImmutableSet.of(
43 XmlNetconfConstants.URN_IETF_PARAMS_NETCONF_BASE_1_0,
44 XmlNetconfConstants.URN_IETF_PARAMS_NETCONF_CAPABILITY_EXI_1_0);
46 public static final Set<String> DEFAULT_CLIENT_CAPABILITIES = ImmutableSet.of(
47 XmlNetconfConstants.URN_IETF_PARAMS_NETCONF_BASE_1_0,
48 XmlNetconfConstants.URN_IETF_PARAMS_NETCONF_BASE_1_1);
50 public static final Set<String> LEGACY_FRAMING_CLIENT_CAPABILITIES = ImmutableSet.of(
51 XmlNetconfConstants.URN_IETF_PARAMS_NETCONF_BASE_1_0);
53 private static final Logger LOG = LoggerFactory.getLogger(NetconfClientSessionNegotiatorFactory.class);
54 private static final String START_EXI_MESSAGE_ID = "default-start-exi";
55 private static final EXIParameters DEFAULT_OPTIONS;
57 private final Optional<NetconfHelloMessageAdditionalHeader> additionalHeader;
58 private final long connectionTimeoutMillis;
59 private final Timer timer;
60 private final EXIParameters options;
63 final FidelityOptions fidelity = FidelityOptions.createDefault();
65 fidelity.setFidelity(FidelityOptions.FEATURE_DTD, true);
66 fidelity.setFidelity(FidelityOptions.FEATURE_LEXICAL_VALUE, true);
67 fidelity.setFidelity(FidelityOptions.FEATURE_PREFIX, true);
68 } catch (UnsupportedOption e) {
69 LOG.warn("Failed to set fidelity options, continuing", e);
72 DEFAULT_OPTIONS = new EXIParameters(CodingMode.BYTE_PACKED, fidelity);
75 private final Set<String> clientCapabilities;
77 public NetconfClientSessionNegotiatorFactory(final Timer timer,
78 final Optional<NetconfHelloMessageAdditionalHeader> additionalHeader,
79 final long connectionTimeoutMillis) {
80 this(timer, additionalHeader, connectionTimeoutMillis, DEFAULT_OPTIONS);
83 public NetconfClientSessionNegotiatorFactory(final Timer timer,
84 final Optional<NetconfHelloMessageAdditionalHeader> additionalHeader,
85 final long connectionTimeoutMillis, final Set<String> capabilities) {
86 this(timer, additionalHeader, connectionTimeoutMillis, DEFAULT_OPTIONS, capabilities);
90 public NetconfClientSessionNegotiatorFactory(final Timer timer,
91 final Optional<NetconfHelloMessageAdditionalHeader> additionalHeader,
92 final long connectionTimeoutMillis, final EXIParameters exiOptions) {
93 this(timer, additionalHeader, connectionTimeoutMillis, exiOptions, EXI_CLIENT_CAPABILITIES);
96 public NetconfClientSessionNegotiatorFactory(final Timer timer,
97 final Optional<NetconfHelloMessageAdditionalHeader> additionalHeader,
98 final long connectionTimeoutMillis, final EXIParameters exiOptions,
99 final Set<String> capabilities) {
100 this.timer = Preconditions.checkNotNull(timer);
101 this.additionalHeader = additionalHeader;
102 this.connectionTimeoutMillis = connectionTimeoutMillis;
103 this.options = exiOptions;
104 this.clientCapabilities = capabilities;
108 public SessionNegotiator<NetconfClientSession> getSessionNegotiator(
109 final SessionListenerFactory<NetconfClientSessionListener> sessionListenerFactory,
110 final Channel channel, final Promise<NetconfClientSession> promise) {
112 NetconfMessage startExiMessage = NetconfStartExiMessage.create(options, START_EXI_MESSAGE_ID);
113 NetconfHelloMessage helloMessage = NetconfHelloMessage.createClientHello(clientCapabilities, additionalHeader);
115 NetconfClientSessionPreferences proposal = new NetconfClientSessionPreferences(helloMessage, startExiMessage);
116 return new NetconfClientSessionNegotiator(proposal, promise, channel, timer,
117 sessionListenerFactory.getSessionListener(), connectionTimeoutMillis);