opendaylight/netconf/netconf-netty-util/src/main/java/org/opendaylight/netconf/nettyutil/handler/exi/NetconfStartExiMessage.java

   1 /*
   2  * Copyright (c) 2013 Cisco Systems, Inc. and others.  All rights reserved.
   3  *
   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
   7  */
   8
   9 package org.opendaylight.netconf.nettyutil.handler.exi;
  10
  11 import com.google.common.collect.Lists;
  12 import java.util.List;
  13 import org.opendaylight.controller.config.util.xml.XmlUtil;
  14 import org.opendaylight.netconf.api.NetconfMessage;
  15 import org.opendaylight.netconf.api.xml.XmlNetconfConstants;
  16 import org.openexi.proc.common.EXIOptions;
  17 import org.w3c.dom.Document;
  18 import org.w3c.dom.Element;
  19 import org.slf4j.Logger;
  20 import org.slf4j.LoggerFactory;
  21
  22 /**
  23  * Start-exi netconf message.
  24  */
  25 public final class NetconfStartExiMessage extends NetconfMessage {
  26
  27     public static final String START_EXI = "start-exi";
  28     public static final String ALIGNMENT_KEY = "alignment";
  29     public static final String FIDELITY_KEY = "fidelity";
  30     public static final String COMMENTS_KEY = "comments";
  31     public static final String DTD_KEY = "dtd";
  32     public static final String LEXICAL_VALUES_KEY = "lexical-values";
  33     public static final String PIS_KEY = "pis";
  34     public static final String PREFIXES_KEY = "prefixes";
  35     private static final Logger LOG = LoggerFactory.getLogger(NetconfStartExiMessage.class);
  36     private NetconfStartExiMessage(final Document doc) {
  37         super(doc);
  38     }
  39
  40     public static NetconfStartExiMessage create(final EXIOptions exiOptions, final String messageId) {
  41         final Document doc = XmlUtil.newDocument();
  42         final Element rpcElement = doc.createElementNS(XmlNetconfConstants.URN_IETF_PARAMS_XML_NS_NETCONF_BASE_1_0,
  43                 XmlNetconfConstants.RPC_KEY);
  44         rpcElement.setAttributeNS(XmlNetconfConstants.URN_IETF_PARAMS_XML_NS_NETCONF_BASE_1_0,
  45                 XmlNetconfConstants.MESSAGE_ID, messageId);
  46
  47         // TODO draft http://tools.ietf.org/html/draft-varga-netconf-exi-capability-02#section-3.5.1 has no namespace for start-exi element in xml
  48         final Element startExiElement = doc.createElementNS(XmlNetconfConstants.URN_IETF_PARAMS_XML_NS_NETCONF_EXI_1_0,
  49                 START_EXI);
  50
  51         addAlignment(exiOptions, doc, startExiElement);
  52         addFidelity(exiOptions, doc, startExiElement);
  53
  54         rpcElement.appendChild(startExiElement);
  55
  56         doc.appendChild(rpcElement);
  57         return new NetconfStartExiMessage(doc);
  58     }
  59
  60     private static void addFidelity(final EXIOptions exiOptions, final Document doc, final Element startExiElement) {
  61         final List<Element> fidelityElements = Lists.newArrayList();
  62         createFidelityElement(doc, fidelityElements, exiOptions.getPreserveComments(), COMMENTS_KEY);
  63         createFidelityElement(doc, fidelityElements, exiOptions.getPreserveDTD(), DTD_KEY);
  64         createFidelityElement(doc, fidelityElements, exiOptions.getPreserveLexicalValues(), LEXICAL_VALUES_KEY);
  65         createFidelityElement(doc, fidelityElements, exiOptions.getPreservePIs(), PIS_KEY);
  66         createFidelityElement(doc, fidelityElements, exiOptions.getPreserveNS(), PREFIXES_KEY);
  67
  68         if (fidelityElements.isEmpty() == false) {
  69             final Element fidelityElement = doc.createElementNS(
  70                     XmlNetconfConstants.URN_IETF_PARAMS_XML_NS_NETCONF_EXI_1_0, FIDELITY_KEY);
  71             for (final Element element : fidelityElements) {
  72                 fidelityElement.appendChild(element);
  73             }
  74             startExiElement.appendChild(fidelityElement);
  75         }
  76     }
  77
  78     private static void addAlignment(final EXIOptions exiOptions, final Document doc, final Element startExiElement) {
  79         final Element alignmentElement = doc.createElementNS(XmlNetconfConstants.URN_IETF_PARAMS_XML_NS_NETCONF_EXI_1_0,
  80                 ALIGNMENT_KEY);
  81
  82         String alignmentString;
  83         switch (exiOptions.getAlignmentType()) {
  84         case byteAligned: {
  85             alignmentString = EXIParameters.EXI_PARAMETER_BYTE_ALIGNED;
  86             break;
  87         }
  88         case compress: {
  89             alignmentString = EXIParameters.EXI_PARAMETER_COMPRESSED;
  90             break;
  91         }
  92         case preCompress: {
  93             alignmentString = EXIParameters.EXI_PARAMETER_PRE_COMPRESSION;
  94             break;
  95         }
  96         default:
  97             LOG.warn("Unexpected value in EXI alignment type: {} , using default value", exiOptions.getAlignmentType());
  98         case bitPacked: {
  99             alignmentString = EXIParameters.EXI_PARAMETER_BIT_PACKED;
 100             break;
 101         }
 102         }
 103
 104         alignmentElement.setTextContent(alignmentString);
 105         startExiElement.appendChild(alignmentElement);
 106     }
 107
 108     private static void createFidelityElement(final Document doc, final List<Element> fidelityElements, final boolean fidelity, final String fidelityName) {
 109
 110         if (fidelity) {
 111             fidelityElements.add(doc.createElementNS(XmlNetconfConstants.URN_IETF_PARAMS_XML_NS_NETCONF_EXI_1_0,
 112                     fidelityName));
 113         }
 114
 115     }
 116 }