Java tutorial
/** * Copyright (c) 2010-2013, openHAB.org and others. * * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at * http://www.eclipse.org/legal/epl-v10.html */ package org.openhab.binding.dmlsmeter.internal; import java.util.Dictionary; import java.util.Enumeration; import java.util.HashMap; import java.util.HashSet; import java.util.Map; import java.util.Map.Entry; import java.util.Set; import java.util.regex.Matcher; import java.util.regex.Pattern; import org.apache.commons.lang.StringUtils; import org.openhab.binding.dmlsmeter.DmlsMeterBindingProvider; import org.openhab.core.binding.AbstractActiveBinding; import org.openhab.core.items.Item; import org.openhab.core.library.items.NumberItem; import org.openhab.core.library.items.StringItem; import org.openhab.core.library.types.DecimalType; import org.openhab.core.library.types.StringType; import org.openhab.core.types.Command; import org.openhab.core.types.State; import org.openmuc.j62056.DataSet; import org.osgi.service.cm.ConfigurationException; import org.osgi.service.cm.ManagedService; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Implement this class if you are going create an actively polling service like querying a Website/Device. * * @author Peter Kreutzer * @author Gnter Speckhofer * @since 1.4.0 */ public class DmlsMeterBinding extends AbstractActiveBinding<DmlsMeterBindingProvider> implements ManagedService { private static final Logger logger = LoggerFactory.getLogger(DmlsMeterBinding.class); // regEx to validate a meter config // <code>'^(.*?)\\.(serialPort|baudRateChangeDelay|echoHandling)$'</code> private final Pattern METER_CONFIG_PATTERN = Pattern .compile("^(.*?)\\.(serialPort|baudRateChangeDelay|echoHandling)$"); private static final long DEFAULT_REFRESH_INTERVAL = 60 * 10; // 10 minutes in seconds /** * the refresh interval which is used to poll values from the dmlsMeter server (optional, defaults to 10 minutes) */ private long refreshInterval = DEFAULT_REFRESH_INTERVAL; // configured meter devices - keyed by meter device name private final Map<String, DmlsMeterReader> meterDevices = new HashMap<String, DmlsMeterReader>(); public DmlsMeterBinding() { } public void activate() { } public void deactivate() { meterDevices.clear(); } /** * @{inheritDoc */ @Override protected long getRefreshInterval() { return refreshInterval * 1000; } /** * @{inheritDoc */ @Override protected String getName() { return "dmlsMeter Refresh Service"; } private final DmlsMeterReader createDmlsMeterReader(String name, DmlsMeterDeviceConfig config) { DmlsMeterReader reader = null; if (System.getProperty("DmlsMeterSimulate") != null) { reader = new SimulateDmlsMeterReader(name, config); } else { reader = new DmlsMeterReaderImpl(name, config); } return reader; } /** * @{inheritDoc */ @Override protected void execute() { // the frequently executed code (polling) goes here ... for (Entry<String, DmlsMeterReader> entry : meterDevices.entrySet()) { DmlsMeterReader reader = entry.getValue(); Map<String, DataSet> dataSets = reader.read(); for (DmlsMeterBindingProvider provider : providers) { for (String itemName : provider.getItemNames()) { String obis = provider.getObis(itemName); if (obis != null && dataSets.containsKey(obis)) { DataSet dataSet = dataSets.get(obis); Class<? extends Item> itemType = provider.getItemType(itemName); if (itemType.isAssignableFrom(NumberItem.class)) { double value = Double.parseDouble(dataSet.getValue()); eventPublisher.postUpdate(itemName, new DecimalType(value)); } if (itemType.isAssignableFrom(StringItem.class)) { String value = dataSet.getValue(); eventPublisher.postUpdate(itemName, new StringType(value)); } } } } } } /** * @{inheritDoc */ @Override protected void internalReceiveCommand(String itemName, Command command) { // the code being executed when a command was sent on the openHAB // event bus goes here. This method is only called if one of the // BindingProviders provide a binding for the given 'itemName'. logger.debug("internalReceiveCommand() is called!"); } /** * @{inheritDoc */ @Override protected void internalReceiveUpdate(String itemName, State newState) { // the code being executed when a state was sent on the openHAB // event bus goes here. This method is only called if one of the // BindingProviders provide a binding for the given 'itemName'. logger.debug("internalReceiveCommand() is called!"); } /** * @{inheritDoc */ @Override public void updated(Dictionary<String, ?> config) throws ConfigurationException { if (config == null || config.isEmpty()) { logger.warn("Empty or null configuration. Ignoring."); return; } Set<String> names = getNames(config); for (String name : names) { String value = (String) config.get(name + ".serialPort"); String serialPort = value != null ? value : DmlsMeterDeviceConfig.DEFAULT_SERIAL_PORT; value = (String) config.get(name + ".baudRateChangeDelay"); int baudRateChangeDelay = value != null ? Integer.valueOf(value) : DmlsMeterDeviceConfig.DEFAULT_BAUD_RATE_CHANGE_DELAY; value = (String) config.get(name + ".echoHandling"); boolean echoHandling = value != null ? Boolean.valueOf(value) : DmlsMeterDeviceConfig.DEFAULT_ECHO_HANDLING; DmlsMeterReader reader = createDmlsMeterReader(name, new DmlsMeterDeviceConfig(serialPort, baudRateChangeDelay, echoHandling)); if (meterDevices.put(reader.getName(), reader) != null) { logger.info("Recreated reader {} with {}!", reader.getName(), reader.getConfig()); } else { logger.info("Created reader {} with {}!", reader.getName(), reader.getConfig()); } } if (config != null) { // to override the default refresh interval one has to add a // parameter to openhab.cfg like // <bindingName>:refresh=<intervalInMs> if (StringUtils.isNotBlank((String) config.get("refresh"))) { refreshInterval = Long.parseLong((String) config.get("refresh")); } setProperlyConfigured(true); } } private Set<String> getNames(Dictionary<String, ?> config) { Set<String> set = new HashSet<String>(); Enumeration<String> keys = config.keys(); while (keys.hasMoreElements()) { String key = (String) keys.nextElement(); // the config-key enumeration contains additional keys that we // don't want to process here ... if ("service.pid".equals(key) || "refresh".equals(key)) { continue; } Matcher meterMatcher = METER_CONFIG_PATTERN.matcher(key); if (!meterMatcher.matches()) { logger.debug("given config key '" + key + "' does not follow the expected pattern '<meterName>.<serialPort|baudRateChangeDelay|echoHandling>'"); continue; } meterMatcher.reset(); meterMatcher.find(); set.add(meterMatcher.group(1)); } return set; } }