git.basschouten.com Git - openhab-addons.git/blob

   1 /**
   2  * Copyright (c) 2010-2020 Contributors to the openHAB project
   3  *
   4  * See the NOTICE file(s) distributed with this work for additional
   5  * information.
   6  *
   7  * This program and the accompanying materials are made available under the
   8  * terms of the Eclipse Public License 2.0 which is available at
   9  * http://www.eclipse.org/legal/epl-2.0
  10  *
  11  * SPDX-License-Identifier: EPL-2.0
  12  */
  13 package org.openhab.binding.lutron.internal.xml;
  14
  15 import java.io.File;
  16 import java.io.Reader;
  17 import java.net.URL;
  18
  19 import org.eclipse.jdt.annotation.NonNullByDefault;
  20 import org.eclipse.jdt.annotation.Nullable;
  21 import org.openhab.binding.lutron.internal.discovery.project.Area;
  22 import org.openhab.binding.lutron.internal.discovery.project.Component;
  23 import org.openhab.binding.lutron.internal.discovery.project.Device;
  24 import org.openhab.binding.lutron.internal.discovery.project.DeviceGroup;
  25 import org.openhab.binding.lutron.internal.discovery.project.GreenMode;
  26 import org.openhab.binding.lutron.internal.discovery.project.Output;
  27 import org.openhab.binding.lutron.internal.discovery.project.Project;
  28 import org.openhab.binding.lutron.internal.discovery.project.Timeclock;
  29
  30 import com.thoughtworks.xstream.XStream;
  31 import com.thoughtworks.xstream.converters.ConversionException;
  32 import com.thoughtworks.xstream.io.xml.StaxDriver;
  33
  34 /**
  35  * The {@link DbXmlInfoReader} reads Lutron XML project files and converts them to {@link Project}
  36  * objects describing the device things contained within the Lutron system.
  37  *
  38  * @author Allan Tong - Initial contribution
  39  * @author Bob Adair - Added support for reading XML from a file. Requires using XStream directly
  40  *         instead of XmlDocumentReader.
  41  */
  42 @NonNullByDefault
  43 public class DbXmlInfoReader {
  44
  45     private final XStream xstream;
  46
  47     public DbXmlInfoReader() {
  48         StaxDriver driver = new StaxDriver();
  49
  50         xstream = new XStream(driver);
  51
  52         configureSecurity(xstream);
  53         setClassLoader(Project.class.getClassLoader());
  54         registerAliases(xstream);
  55     }
  56
  57     private void configureSecurity(XStream xstream) {
  58         XStream.setupDefaultSecurity(xstream);
  59         xstream.allowTypesByWildcard(new String[] { Project.class.getPackageName() + ".**" });
  60     }
  61
  62     private void setClassLoader(ClassLoader classLoader) {
  63         xstream.setClassLoader(classLoader);
  64     }
  65
  66     private void registerAliases(XStream xstream) {
  67         xstream.alias("Project", Project.class);
  68         xstream.aliasField("AppVer", Project.class, "appVersion");
  69         xstream.aliasField("XMLVer", Project.class, "xmlVersion");
  70         xstream.aliasField("Areas", Project.class, "areas");
  71         xstream.aliasField("Timeclocks", Project.class, "timeclocks");
  72         xstream.aliasField("GreenModes", Project.class, "greenmodes");
  73
  74         xstream.alias("Area", Area.class);
  75         xstream.aliasField("Name", Area.class, "name");
  76         xstream.useAttributeFor(Area.class, "name");
  77         xstream.aliasField("IntegrationID", Area.class, "integrationId");
  78         xstream.useAttributeFor(Area.class, "integrationId");
  79         xstream.aliasField("DeviceGroups", Area.class, "deviceNodes");
  80         xstream.aliasField("Outputs", Area.class, "outputs");
  81         xstream.aliasField("Areas", Area.class, "areas");
  82
  83         xstream.alias("DeviceGroup", DeviceGroup.class);
  84         xstream.aliasField("Name", DeviceGroup.class, "name");
  85         xstream.useAttributeFor(DeviceGroup.class, "name");
  86         xstream.aliasField("Devices", DeviceGroup.class, "devices");
  87
  88         xstream.alias("Device", Device.class);
  89         xstream.aliasField("Name", Device.class, "name");
  90         xstream.useAttributeFor(Device.class, "name");
  91         xstream.aliasField("IntegrationID", Device.class, "integrationId");
  92         xstream.useAttributeFor(Device.class, "integrationId");
  93         xstream.aliasField("DeviceType", Device.class, "type");
  94         xstream.useAttributeFor(Device.class, "type");
  95         xstream.aliasField("Components", Device.class, "components");
  96
  97         xstream.alias("Component", Component.class);
  98         xstream.aliasField("ComponentNumber", Component.class, "componentNumber");
  99         xstream.useAttributeFor(Component.class, "componentNumber");
 100         xstream.aliasField("ComponentType", Component.class, "type");
 101         xstream.useAttributeFor(Component.class, "type");
 102
 103         xstream.alias("Output", Output.class);
 104         xstream.aliasField("Name", Output.class, "name");
 105         xstream.useAttributeFor(Output.class, "name");
 106         xstream.aliasField("IntegrationID", Output.class, "integrationId");
 107         xstream.useAttributeFor(Output.class, "integrationId");
 108         xstream.aliasField("OutputType", Output.class, "type");
 109         xstream.useAttributeFor(Output.class, "type");
 110
 111         xstream.alias("Timeclock", Timeclock.class);
 112         xstream.aliasField("Name", Timeclock.class, "name");
 113         xstream.useAttributeFor(Timeclock.class, "name");
 114         xstream.aliasField("IntegrationID", Timeclock.class, "integrationId");
 115         xstream.useAttributeFor(Timeclock.class, "integrationId");
 116
 117         xstream.alias("GreenMode", GreenMode.class);
 118         xstream.aliasField("Name", GreenMode.class, "name");
 119         xstream.useAttributeFor(GreenMode.class, "name");
 120         xstream.aliasField("IntegrationID", GreenMode.class, "integrationId");
 121         xstream.useAttributeFor(GreenMode.class, "integrationId");
 122
 123         // This reader is only interested in device thing information and does not read
 124         // everything contained in DbXmlInfo. Ignoring unknown elements also makes the
 125         // binding more tolerant of potential future changes to the XML schema.
 126         xstream.ignoreUnknownElements();
 127     }
 128
 129     public @Nullable Project readFromXML(@Nullable URL xmlURL) throws ConversionException {
 130         if (xmlURL != null) {
 131             return (Project) xstream.fromXML(xmlURL);
 132         }
 133
 134         return null;
 135     }
 136
 137     public @Nullable Project readFromXML(@Nullable File xmlFile) throws ConversionException {
 138         if (xmlFile != null) {
 139             return (Project) xstream.fromXML(xmlFile);
 140         }
 141
 142         return null;
 143     }
 144
 145     public @Nullable Project readFromXML(@Nullable Reader xmlReader) throws ConversionException {
 146         if (xmlReader != null) {
 147             return (Project) xstream.fromXML(xmlReader);
 148         }
 149
 150         return null;
 151     }
 152
 153     public @Nullable Project readFromXML(@Nullable String xmlString) throws ConversionException {
 154         if (xmlString != null) {
 155             return (Project) xstream.fromXML(xmlString);
 156         }
 157
 158         return null;
 159     }
 160 }