OpenPathsGenericBindingProvider.java

/**
 * Copyright (c) 2010-2016 by the respective copyright holders.
 *
 * 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.openpaths.internal;

import org.apache.commons.lang.StringUtils;
import org.openhab.binding.openpaths.OpenPathsBindingProvider;
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.items.SwitchItem;
import org.openhab.model.item.binding.AbstractGenericBindingProvider;
import org.openhab.model.item.binding.BindingConfigParseException;

/**
 * This class is responsible for parsing the binding configuration. A valid
 * items binding configuration file will look like the following:
 *
 * <pre>
 * Switch Person_A	"Person A"	{ openpaths="personA" }
 * Switch Person_B  "Person B"	{ openpaths="personB" }
 * </pre>
 *
 * @author Ben Jones
 * @since 1.4.0
 */
public class OpenPathsGenericBindingProvider extends AbstractGenericBindingProvider
        implements OpenPathsBindingProvider {

    /**
     * {@inheritDoc}
     */
    @Override
    public String getBindingType() {
        return "openpaths";
    }

    /**
     * @{inheritDoc
     */
    @Override
    public void validateItemType(Item item, String bindingConfig) throws BindingConfigParseException {
        if (!(item instanceof SwitchItem) && !(item instanceof NumberItem) && !(item instanceof StringItem)) {
            throw new BindingConfigParseException(
                    "item '" + item.getName() + "' is of type '" + item.getClass().getSimpleName()
                            + "', only Switch,Number and String are allowed - please check your *.items configuration");
        }
    }

    /**
     * {@inheritDoc}
     */
    @Override
    public void processBindingConfiguration(String context, Item item, String bindingConfig)
            throws BindingConfigParseException {
        super.processBindingConfiguration(context, item, bindingConfig);

        if (StringUtils.isEmpty(bindingConfig)) {
            throw new BindingConfigParseException(
                    "Null config for " + item.getName() + " - expecting an OpenPaths name");
        }

        OpenPathsBindingConfig openPathsBindingConfig = new OpenPathsBindingConfig(bindingConfig);

        addBindingConfig(item, openPathsBindingConfig);
    }

    /**
     * {@inheritDoc}
     */
    @Override
    public OpenPathsBindingConfig getItemConfig(String itemName) {
        return (OpenPathsBindingConfig) bindingConfigs.get(itemName);
    }
}