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

   1 /**
   2  * Copyright (c) 2010-2021 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.io.openhabcloud.internal;
  14
  15 import java.io.File;
  16 import java.io.FileNotFoundException;
  17 import java.io.IOException;
  18 import java.nio.charset.StandardCharsets;
  19 import java.nio.file.Files;
  20 import java.security.SecureRandom;
  21 import java.util.Arrays;
  22 import java.util.HashSet;
  23 import java.util.List;
  24 import java.util.Map;
  25 import java.util.Set;
  26
  27 import org.eclipse.jdt.annotation.Nullable;
  28 import org.eclipse.jetty.client.HttpClient;
  29 import org.openhab.core.OpenHAB;
  30 import org.openhab.core.config.core.ConfigurableService;
  31 import org.openhab.core.events.Event;
  32 import org.openhab.core.events.EventFilter;
  33 import org.openhab.core.events.EventPublisher;
  34 import org.openhab.core.events.EventSubscriber;
  35 import org.openhab.core.id.InstanceUUID;
  36 import org.openhab.core.io.net.http.HttpClientFactory;
  37 import org.openhab.core.items.Item;
  38 import org.openhab.core.items.ItemNotFoundException;
  39 import org.openhab.core.items.ItemRegistry;
  40 import org.openhab.core.items.events.ItemEventFactory;
  41 import org.openhab.core.items.events.ItemStateEvent;
  42 import org.openhab.core.library.items.RollershutterItem;
  43 import org.openhab.core.library.items.SwitchItem;
  44 import org.openhab.core.library.types.OnOffType;
  45 import org.openhab.core.library.types.UpDownType;
  46 import org.openhab.core.model.script.engine.action.ActionService;
  47 import org.openhab.core.net.HttpServiceUtil;
  48 import org.openhab.core.types.Command;
  49 import org.openhab.core.types.TypeParser;
  50 import org.openhab.io.openhabcloud.NotificationAction;
  51 import org.osgi.framework.BundleContext;
  52 import org.osgi.framework.Constants;
  53 import org.osgi.service.component.annotations.Activate;
  54 import org.osgi.service.component.annotations.Component;
  55 import org.osgi.service.component.annotations.Deactivate;
  56 import org.osgi.service.component.annotations.Modified;
  57 import org.osgi.service.component.annotations.Reference;
  58 import org.slf4j.Logger;
  59 import org.slf4j.LoggerFactory;
  60
  61 /**
  62  * This class starts the cloud connection service and implements interface to communicate with the cloud.
  63  *
  64  * @author Victor Belov - Initial contribution
  65  * @author Kai Kreuzer - migrated code to new Jetty client and ESH APIs
  66  */
  67 @Component(service = { CloudService.class, EventSubscriber.class,
  68         ActionService.class }, configurationPid = "org.openhab.openhabcloud", property = Constants.SERVICE_PID
  69                 + "=org.openhab.openhabcloud")
  70 @ConfigurableService(category = "io", label = "openHAB Cloud", description_uri = "io:openhabcloud")
  71 public class CloudService implements ActionService, CloudClientListener, EventSubscriber {
  72
  73     private static final String CFG_EXPOSE = "expose";
  74     private static final String CFG_BASE_URL = "baseURL";
  75     private static final String CFG_MODE = "mode";
  76     private static final String SECRET_FILE_NAME = "openhabcloud" + File.separator + "secret";
  77     private static final String DEFAULT_URL = "https://myopenhab.org/";
  78     private static final int DEFAULT_LOCAL_OPENHAB_MAX_CONCURRENT_REQUESTS = 200;
  79     private static final int DEFAULT_LOCAL_OPENHAB_REQUEST_TIMEOUT = 30000;
  80     private static final String HTTPCLIENT_NAME = "openhabcloud";
  81     private static final String CHARS = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
  82     private static final SecureRandom SR = new SecureRandom();
  83
  84     private final Logger logger = LoggerFactory.getLogger(CloudService.class);
  85
  86     public static String clientVersion = null;
  87     private CloudClient cloudClient;
  88     private String cloudBaseUrl = null;
  89     private final HttpClient httpClient;
  90     protected final ItemRegistry itemRegistry;
  91     protected final EventPublisher eventPublisher;
  92
  93     private boolean remoteAccessEnabled = true;
  94     private Set<String> exposedItems = null;
  95     private int localPort;
  96
  97     @Activate
  98     public CloudService(final @Reference HttpClientFactory httpClientFactory,
  99             final @Reference ItemRegistry itemRegistry, final @Reference EventPublisher eventPublisher) {
 100         this.httpClient = httpClientFactory.createHttpClient(HTTPCLIENT_NAME);
 101         this.httpClient.setStopTimeout(0);
 102         this.httpClient.setMaxConnectionsPerDestination(DEFAULT_LOCAL_OPENHAB_MAX_CONCURRENT_REQUESTS);
 103         this.httpClient.setConnectTimeout(DEFAULT_LOCAL_OPENHAB_REQUEST_TIMEOUT);
 104         this.httpClient.setFollowRedirects(false);
 105
 106         this.itemRegistry = itemRegistry;
 107         this.eventPublisher = eventPublisher;
 108     }
 109
 110     /**
 111      * This method sends notification message to mobile app through the openHAB Cloud service
 112      *
 113      * @param userId the {@link String} containing the openHAB Cloud user id to send message to
 114      * @param message the {@link String} containing a message to send to specified user id
 115      * @param icon the {@link String} containing a name of the icon to be used with this notification
 116      * @param severity the {@link String} containing severity (good, info, warning, error) of notification
 117      */
 118     public void sendNotification(String userId, String message, @Nullable String icon, @Nullable String severity) {
 119         logger.debug("Sending message '{}' to user id {}", message, userId);
 120         cloudClient.sendNotification(userId, message, icon, severity);
 121     }
 122
 123     /**
 124      * Sends an advanced notification to log. Log notifications are not pushed to user
 125      * devices but are shown to all account users in notifications log
 126      *
 127      * @param message the {@link String} containing a message to send to specified user id
 128      * @param icon the {@link String} containing a name of the icon to be used with this notification
 129      * @param severity the {@link String} containing severity (good, info, warning, error) of notification
 130      */
 131     public void sendLogNotification(String message, @Nullable String icon, @Nullable String severity) {
 132         logger.debug("Sending log message '{}'", message);
 133         cloudClient.sendLogNotification(message, icon, severity);
 134     }
 135
 136     /**
 137      * Sends a broadcast notification. Broadcast notifications are pushed to all
 138      * mobile devices of all users of the account
 139      *
 140      * @param message the {@link String} containing a message to send to specified user id
 141      * @param icon the {@link String} containing a name of the icon to be used with this notification
 142      * @param severity the {@link String} containing severity (good, info, warning, error) of notification
 143      */
 144     public void sendBroadcastNotification(String message, @Nullable String icon, @Nullable String severity) {
 145         logger.debug("Sending broadcast message '{}' to all users", message);
 146         cloudClient.sendBroadcastNotification(message, icon, severity);
 147     }
 148
 149     private String substringBefore(String str, String separator) {
 150         int index = str.indexOf(separator);
 151         return index == -1 ? str : str.substring(0, index);
 152     }
 153
 154     @Activate
 155     protected void activate(BundleContext context, Map<String, ?> config) {
 156         clientVersion = substringBefore(context.getBundle().getVersion().toString(), ".qualifier");
 157         localPort = HttpServiceUtil.getHttpServicePort(context);
 158         if (localPort == -1) {
 159             logger.warn("openHAB Cloud connector not started, since no local HTTP port could be determined");
 160         } else {
 161             logger.debug("openHAB Cloud connector activated");
 162             checkJavaVersion();
 163             modified(config);
 164         }
 165     }
 166
 167     private void checkJavaVersion() {
 168         String version = System.getProperty("java.version");
 169         if (version.charAt(2) == '8') {
 170             // we are on Java 8, let's check the update
 171             String update = version.substring(version.indexOf('_') + 1);
 172             try {
 173                 Integer uVersion = Integer.valueOf(update);
 174                 if (uVersion < 101) {
 175                     logger.warn(
 176                             "You are running Java {} - the openhab Cloud connection requires at least Java 1.8.0_101, if your cloud server uses Let's Encrypt certificates!",
 177                             version);
 178                 }
 179             } catch (NumberFormatException e) {
 180                 logger.debug("Could not determine update version of java {}", version);
 181             }
 182         }
 183     }
 184
 185     @Deactivate
 186     protected void deactivate() {
 187         logger.debug("openHAB Cloud connector deactivated");
 188         cloudClient.shutdown();
 189         try {
 190             httpClient.stop();
 191         } catch (Exception e) {
 192             logger.debug("Could not stop Jetty http client", e);
 193         }
 194     }
 195
 196     @Modified
 197     protected void modified(Map<String, ?> config) {
 198         if (config != null && config.get(CFG_MODE) != null) {
 199             remoteAccessEnabled = "remote".equals(config.get(CFG_MODE));
 200         } else {
 201             logger.debug("remoteAccessEnabled is not set, keeping value '{}'", remoteAccessEnabled);
 202         }
 203
 204         if (config.get(CFG_BASE_URL) != null) {
 205             cloudBaseUrl = (String) config.get(CFG_BASE_URL);
 206         } else {
 207             cloudBaseUrl = DEFAULT_URL;
 208         }
 209
 210         exposedItems = new HashSet<>();
 211         Object expCfg = config.get(CFG_EXPOSE);
 212         if (expCfg instanceof String) {
 213             String value = (String) expCfg;
 214             while (value.startsWith("[")) {
 215                 value = value.substring(1);
 216             }
 217             while (value.endsWith("]")) {
 218                 value = value.substring(0, value.length() - 1);
 219             }
 220             for (String itemName : Arrays.asList((value).split(","))) {
 221                 exposedItems.add(itemName.trim());
 222             }
 223         } else if (expCfg instanceof Iterable) {
 224             for (Object entry : ((Iterable<?>) expCfg)) {
 225                 exposedItems.add(entry.toString());
 226             }
 227         }
 228
 229         logger.debug("UUID = {}, secret = {}", InstanceUUID.get(), getSecret());
 230
 231         if (cloudClient != null) {
 232             cloudClient.shutdown();
 233         }
 234
 235         if (!httpClient.isRunning()) {
 236             try {
 237                 httpClient.start();
 238             } catch (Exception e) {
 239                 logger.error("Could not start Jetty http client", e);
 240             }
 241         }
 242
 243         String localBaseUrl = "http://localhost:" + localPort;
 244         cloudClient = new CloudClient(httpClient, InstanceUUID.get(), getSecret(), cloudBaseUrl, localBaseUrl,
 245                 remoteAccessEnabled, exposedItems);
 246         cloudClient.setOpenHABVersion(OpenHAB.getVersion());
 247         cloudClient.connect();
 248         cloudClient.setListener(this);
 249         NotificationAction.cloudService = this;
 250     }
 251
 252     @Override
 253     public String getActionClassName() {
 254         return NotificationAction.class.getCanonicalName();
 255     }
 256
 257     @Override
 258     public Class<?> getActionClass() {
 259         return NotificationAction.class;
 260     }
 261
 262     /**
 263      * Reads the first line from specified file
 264      */
 265
 266     private String readFirstLine(File file) {
 267         List<String> lines = null;
 268         try {
 269             lines = Files.readAllLines(file.toPath(), StandardCharsets.UTF_8);
 270         } catch (IOException e) {
 271             // no exception handling - we just return the empty String
 272         }
 273         return lines == null || lines.isEmpty() ? "" : lines.get(0);
 274     }
 275
 276     /**
 277      * Writes a String to a specified file
 278      */
 279
 280     private void writeFile(File file, String content) {
 281         // create intermediary directories
 282         file.getParentFile().mkdirs();
 283         try {
 284             Files.writeString(file.toPath(), content, StandardCharsets.UTF_8);
 285             logger.debug("Created file '{}' with content '{}'", file.getAbsolutePath(), content);
 286         } catch (FileNotFoundException e) {
 287             logger.error("Couldn't create file '{}'.", file.getPath(), e);
 288         } catch (IOException e) {
 289             logger.error("Couldn't write to file '{}'.", file.getPath(), e);
 290         }
 291     }
 292
 293     private String randomString(int length) {
 294         StringBuilder sb = new StringBuilder(length);
 295         for (int i = 0; i < length; i++) {
 296             sb.append(CHARS.charAt(SR.nextInt(CHARS.length())));
 297         }
 298         return sb.toString();
 299     }
 300
 301     /**
 302      * Creates a random secret and writes it to the <code>userdata/openhabcloud</code>
 303      * directory. An existing <code>secret</code> file won't be overwritten.
 304      * Returns either existing secret from the file or newly created secret.
 305      */
 306     private String getSecret() {
 307         File file = new File(OpenHAB.getUserDataFolder() + File.separator + SECRET_FILE_NAME);
 308         String newSecretString = "";
 309
 310         if (!file.exists()) {
 311             newSecretString = randomString(20);
 312             logger.debug("New secret = {}", newSecretString);
 313             writeFile(file, newSecretString);
 314         } else {
 315             newSecretString = readFirstLine(file);
 316             logger.debug("Using secret at '{}' with content '{}'", file.getAbsolutePath(), newSecretString);
 317         }
 318
 319         return newSecretString;
 320     }
 321
 322     @Override
 323     public void sendCommand(String itemName, String commandString) {
 324         try {
 325             Item item = itemRegistry.getItem(itemName);
 326             Command command = null;
 327             if ("toggle".equalsIgnoreCase(commandString)
 328                     && (item instanceof SwitchItem || item instanceof RollershutterItem)) {
 329                 if (OnOffType.ON.equals(item.getStateAs(OnOffType.class))) {
 330                     command = OnOffType.OFF;
 331                 }
 332                 if (OnOffType.OFF.equals(item.getStateAs(OnOffType.class))) {
 333                     command = OnOffType.ON;
 334                 }
 335                 if (UpDownType.UP.equals(item.getStateAs(UpDownType.class))) {
 336                     command = UpDownType.DOWN;
 337                 }
 338                 if (UpDownType.DOWN.equals(item.getStateAs(UpDownType.class))) {
 339                     command = UpDownType.UP;
 340                 }
 341             } else {
 342                 command = TypeParser.parseCommand(item.getAcceptedCommandTypes(), commandString);
 343             }
 344             if (command != null) {
 345                 logger.debug("Received command '{}' for item '{}'", commandString, itemName);
 346                 eventPublisher.post(ItemEventFactory.createCommandEvent(itemName, command));
 347             } else {
 348                 logger.warn("Received invalid command '{}' for item '{}'", commandString, itemName);
 349             }
 350         } catch (ItemNotFoundException e) {
 351             logger.warn("Received command '{}' for a non-existent item '{}'", commandString, itemName);
 352         }
 353     }
 354
 355     @Override
 356     public Set<String> getSubscribedEventTypes() {
 357         return Set.of(ItemStateEvent.TYPE);
 358     }
 359
 360     @Override
 361     public EventFilter getEventFilter() {
 362         return null;
 363     }
 364
 365     @Override
 366     public void receive(Event event) {
 367         ItemStateEvent ise = (ItemStateEvent) event;
 368         if (exposedItems != null && exposedItems.contains(ise.getItemName())) {
 369             cloudClient.sendItemUpdate(ise.getItemName(), ise.getItemState().toString());
 370         }
 371     }
 372 }