restconf/restconf-nb-bierman02/src/main/java/org/opendaylight/netconf/sal/streams/listeners/AbstractQueryParams.java

   1 /*
   2  * Copyright (c) 2016 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 package org.opendaylight.netconf.sal.streams.listeners;
   9
  10 import com.google.common.annotations.VisibleForTesting;
  11 import com.google.common.base.Preconditions;
  12 import java.io.StringReader;
  13 import java.time.Instant;
  14 import java.util.Optional;
  15 import javax.xml.XMLConstants;
  16 import javax.xml.parsers.DocumentBuilderFactory;
  17 import javax.xml.parsers.ParserConfigurationException;
  18 import javax.xml.xpath.XPath;
  19 import javax.xml.xpath.XPathConstants;
  20 import javax.xml.xpath.XPathFactory;
  21 import org.opendaylight.netconf.sal.restconf.impl.RestconfDocumentedException;
  22 import org.w3c.dom.Document;
  23 import org.xml.sax.InputSource;
  24
  25 /**
  26  * Features of query parameters part of both notifications.
  27  *
  28  */
  29 abstract class AbstractQueryParams extends AbstractNotificationsData {
  30     // FIXME: BUG-7956: switch to using UntrustedXML
  31     private static final DocumentBuilderFactory DBF;
  32
  33     static {
  34         final DocumentBuilderFactory f = DocumentBuilderFactory.newInstance();
  35         f.setCoalescing(true);
  36         f.setExpandEntityReferences(false);
  37         f.setIgnoringElementContentWhitespace(true);
  38         f.setIgnoringComments(true);
  39         f.setXIncludeAware(false);
  40         try {
  41             f.setFeature(XMLConstants.FEATURE_SECURE_PROCESSING, true);
  42             f.setFeature("http://apache.org/xml/features/disallow-doctype-decl", true);
  43             f.setFeature("http://xml.org/sax/features/external-general-entities", false);
  44             f.setFeature("http://xml.org/sax/features/external-parameter-entities", false);
  45         } catch (final ParserConfigurationException e) {
  46             throw new ExceptionInInitializerError(e);
  47         }
  48         DBF = f;
  49     }
  50
  51     // FIXME: these should be final
  52     private Instant start = null;
  53     private Instant stop = null;
  54     private String filter = null;
  55     private boolean leafNodesOnly = false;
  56
  57     @VisibleForTesting
  58     public final Instant getStart() {
  59         return start;
  60     }
  61
  62     /**
  63      * Set query parameters for listener.
  64      *
  65      * @param start
  66      *            start-time of getting notification
  67      * @param stop
  68      *            stop-time of getting notification
  69      * @param filter
  70      *            indicate which subset of all possible events are of interest
  71      * @param leafNodesOnly
  72      *            if true, notifications will contain changes to leaf nodes only
  73      */
  74     public void setQueryParams(final Instant start, final Optional<Instant> stop, final Optional<String> filter,
  75                                final boolean leafNodesOnly) {
  76         this.start = Preconditions.checkNotNull(start);
  77         this.stop = stop.orElse(null);
  78         this.filter = filter.orElse(null);
  79         this.leafNodesOnly = leafNodesOnly;
  80     }
  81
  82     /**
  83      * Check whether this query should only notify about leaf node changes.
  84      *
  85      * @return true if this query should only notify about leaf node changes
  86      */
  87     public boolean getLeafNodesOnly() {
  88         return leafNodesOnly;
  89     }
  90
  91     /**
  92      * Checking query parameters on specific notification.
  93      *
  94      * @param xml       data of notification
  95      * @param listener  listener of notification
  96      * @return true if notification meets the requirements of query parameters,
  97      *         false otherwise
  98      */
  99     @SuppressWarnings("checkstyle:IllegalCatch")
 100     protected <T extends BaseListenerInterface> boolean checkQueryParams(final String xml, final T listener) {
 101         final Instant now = Instant.now();
 102         if (this.stop != null) {
 103             if ((this.start.compareTo(now) < 0) && (this.stop.compareTo(now) > 0)) {
 104                 return checkFilter(xml);
 105             }
 106             if (this.stop.compareTo(now) < 0) {
 107                 try {
 108                     listener.close();
 109                 } catch (final Exception e) {
 110                     throw new RestconfDocumentedException("Problem with unregister listener." + e);
 111                 }
 112             }
 113         } else if (this.start != null) {
 114             if (this.start.compareTo(now) < 0) {
 115                 this.start = null;
 116                 return checkFilter(xml);
 117             }
 118         } else {
 119             return checkFilter(xml);
 120         }
 121         return false;
 122     }
 123
 124     /**
 125      * Check if is filter used and then prepare and post data do client.
 126      *
 127      * @param xml   data of notification
 128      */
 129     @SuppressWarnings("checkstyle:IllegalCatch")
 130     private boolean checkFilter(final String xml) {
 131         if (this.filter == null) {
 132             return true;
 133         }
 134
 135         try {
 136             return parseFilterParam(xml);
 137         } catch (final Exception e) {
 138             throw new RestconfDocumentedException("Problem while parsing filter.", e);
 139         }
 140     }
 141
 142     /**
 143      * Parse and evaluate filter value by xml.
 144      *
 145      * @return true or false - depends on filter expression and data of
 146      *         notifiaction
 147      * @throws Exception if operation fails
 148      */
 149     private boolean parseFilterParam(final String xml) throws Exception {
 150         final Document docOfXml = DBF.newDocumentBuilder().parse(new InputSource(new StringReader(xml)));
 151         final XPath xPath = XPathFactory.newInstance().newXPath();
 152         // FIXME: BUG-7956: xPath.setNamespaceContext(nsContext);
 153         return (boolean) xPath.compile(this.filter).evaluate(docOfXml, XPathConstants.BOOLEAN);
 154     }
 155 }