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.binding.pushover.internal.handler;
  14
  15 import static org.openhab.binding.pushover.internal.PushoverBindingConstants.DEFAULT_SOUND;
  16
  17 import java.util.Collection;
  18 import java.util.List;
  19 import java.util.Set;
  20
  21 import org.eclipse.jdt.annotation.NonNullByDefault;
  22 import org.eclipse.jdt.annotation.Nullable;
  23 import org.eclipse.jetty.client.HttpClient;
  24 import org.openhab.binding.pushover.internal.actions.PushoverActions;
  25 import org.openhab.binding.pushover.internal.config.PushoverAccountConfiguration;
  26 import org.openhab.binding.pushover.internal.config.PushoverConfigOptionProvider;
  27 import org.openhab.binding.pushover.internal.connection.PushoverAPIConnection;
  28 import org.openhab.binding.pushover.internal.connection.PushoverCommunicationException;
  29 import org.openhab.binding.pushover.internal.connection.PushoverConfigurationException;
  30 import org.openhab.binding.pushover.internal.connection.PushoverMessageBuilder;
  31 import org.openhab.binding.pushover.internal.dto.Sound;
  32 import org.openhab.core.thing.ChannelUID;
  33 import org.openhab.core.thing.Thing;
  34 import org.openhab.core.thing.ThingStatus;
  35 import org.openhab.core.thing.ThingStatusDetail;
  36 import org.openhab.core.thing.binding.BaseThingHandler;
  37 import org.openhab.core.thing.binding.ThingHandlerService;
  38 import org.openhab.core.types.Command;
  39
  40 /**
  41  * The {@link PushoverAccountHandler} is responsible for handling commands, which are sent to one of the channels.
  42  *
  43  * @author Christoph Weitkamp - Initial contribution
  44  */
  45 @NonNullByDefault
  46 public class PushoverAccountHandler extends BaseThingHandler {
  47
  48     private static final Collection<Class<? extends ThingHandlerService>> SUPPORTED_THING_ACTIONS = Set
  49             .of(PushoverActions.class, PushoverConfigOptionProvider.class);
  50
  51     private final HttpClient httpClient;
  52
  53     private @NonNullByDefault({}) PushoverAccountConfiguration config;
  54     private @Nullable PushoverAPIConnection connection;
  55
  56     public PushoverAccountHandler(Thing thing, HttpClient httpClient) {
  57         super(thing);
  58         this.httpClient = httpClient;
  59     }
  60
  61     @Override
  62     public void handleCommand(ChannelUID channelUID, Command command) {
  63         // nothing
  64     }
  65
  66     @Override
  67     public void initialize() {
  68         config = getConfigAs(PushoverAccountConfiguration.class);
  69
  70         boolean configValid = true;
  71         final String apikey = config.apikey;
  72         if (apikey == null || apikey.isEmpty()) {
  73             updateStatus(ThingStatus.OFFLINE, ThingStatusDetail.CONFIGURATION_ERROR,
  74                     "@text/offline.conf-error-missing-apikey");
  75             configValid = false;
  76         }
  77         final String user = config.user;
  78         if (user == null || user.isEmpty()) {
  79             updateStatus(ThingStatus.OFFLINE, ThingStatusDetail.CONFIGURATION_ERROR,
  80                     "@text/offline.conf-error-missing-user");
  81             configValid = false;
  82         }
  83
  84         if (configValid) {
  85             updateStatus(ThingStatus.UNKNOWN);
  86
  87             connection = new PushoverAPIConnection(httpClient, config);
  88             scheduler.submit(this::asyncValidateUser);
  89         }
  90     }
  91
  92     @Override
  93     public Collection<Class<? extends ThingHandlerService>> getServices() {
  94         return SUPPORTED_THING_ACTIONS;
  95     }
  96
  97     /**
  98      * Retrieves the list of current sounds and their descriptions from the Pushover API.
  99      *
 100      * @return a list of {@link Sound}s
 101      */
 102     public List<Sound> getSounds() {
 103         return connection != null ? connection.getSounds() : List.of();
 104     }
 105
 106     /**
 107      * Returns a preconfigured {@link PushoverMessageBuilder}.
 108      *
 109      * @param message the message
 110      * @return a {@link PushoverMessageBuilder} instance
 111      */
 112     public PushoverMessageBuilder getDefaultPushoverMessageBuilder(String message) {
 113         PushoverMessageBuilder builder = PushoverMessageBuilder.getInstance(config.apikey, config.user)
 114                 .withMessage(message) //
 115                 .withTitle(config.title) //
 116                 .withRetry(config.retry) //
 117                 .withExpire(config.expire);
 118         // specify format if defined
 119         switch (config.format) {
 120             case PushoverMessageBuilder.MESSAGE_KEY_HTML:
 121                 builder.withHtmlFormatting();
 122                 break;
 123             case PushoverMessageBuilder.MESSAGE_KEY_MONOSPACE:
 124                 builder.withMonospaceFormatting();
 125             default:
 126                 break;
 127         }
 128         // add sound if defined
 129         if (!DEFAULT_SOUND.equals(config.sound)) {
 130             builder.withSound(config.sound);
 131         }
 132         return builder;
 133     }
 134
 135     public boolean sendMessage(PushoverMessageBuilder messageBuilder) {
 136         if (connection != null) {
 137             try {
 138                 return connection.sendMessage(messageBuilder);
 139             } catch (PushoverCommunicationException e) {
 140                 // do nothing, causing exception is already logged
 141             } catch (PushoverConfigurationException e) {
 142                 updateStatus(ThingStatus.OFFLINE, ThingStatusDetail.CONFIGURATION_ERROR, e.getMessage());
 143             }
 144             return false;
 145         } else {
 146             throw new IllegalArgumentException("PushoverAPIConnection is null!");
 147         }
 148     }
 149
 150     public String sendPriorityMessage(PushoverMessageBuilder messageBuilder) {
 151         if (connection != null) {
 152             try {
 153                 return connection.sendPriorityMessage(messageBuilder);
 154             } catch (PushoverCommunicationException e) {
 155                 // do nothing, causing exception is already logged
 156             } catch (PushoverConfigurationException e) {
 157                 updateStatus(ThingStatus.OFFLINE, ThingStatusDetail.CONFIGURATION_ERROR, e.getMessage());
 158             }
 159             return "";
 160         } else {
 161             throw new IllegalArgumentException("PushoverAPIConnection is null!");
 162         }
 163     }
 164
 165     public boolean cancelPriorityMessage(String receipt) {
 166         if (connection != null) {
 167             try {
 168                 return connection.cancelPriorityMessage(receipt);
 169             } catch (PushoverCommunicationException e) {
 170                 // do nothing, causing exception is already logged
 171             } catch (PushoverConfigurationException e) {
 172                 updateStatus(ThingStatus.OFFLINE, ThingStatusDetail.CONFIGURATION_ERROR, e.getMessage());
 173             }
 174             return false;
 175         } else {
 176             throw new IllegalArgumentException("PushoverAPIConnection is null!");
 177         }
 178     }
 179
 180     @SuppressWarnings("null")
 181     private void asyncValidateUser() {
 182         try {
 183             connection.validateUser();
 184             updateStatus(ThingStatus.ONLINE);
 185         } catch (PushoverCommunicationException | PushoverConfigurationException e) {
 186             updateStatus(ThingStatus.OFFLINE, ThingStatusDetail.CONFIGURATION_ERROR, e.getMessage());
 187         }
 188     }
 189 }