/* * ============================================================================ * The Apache Software License, Version 1.1 * ============================================================================ * * Copyright (C) 2002 The Apache Software Foundation. All rights reserved. * * Redistribution and use in source and binary forms, with or without modifica- * tion, are permitted provided that the following conditions are met: * * 1. Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * * 2. Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * * 3. The end-user documentation included with the redistribution, if any, must * include the following acknowledgment: "This product includes software * developed by SuperBonBon Industries (http://www.sbbi.net/)." * Alternately, this acknowledgment may appear in the software itself, if * and wherever such third-party acknowledgments normally appear. * * 4. The names "UPNPLib" and "SuperBonBon Industries" must not be * used to endorse or promote products derived from this software without * prior written permission. For written permission, please contact * info@sbbi.net. * * 5. Products derived from this software may not be called * "SuperBonBon Industries", nor may "SBBI" appear in their name, * without prior written permission of SuperBonBon Industries. * * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE * APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, * INDIRECT,INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLU- * DING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * * This software consists of voluntary contributions made by many individuals * on behalf of SuperBonBon Industries. For more information on * SuperBonBon Industries, please see . */ package net.sbbi.upnp.services; import java.io.IOException; import java.net.URI; import java.util.Date; import java.util.Set; import net.sbbi.upnp.messages.StateVariableMessage; import net.sbbi.upnp.messages.UPNPMessageFactory; import net.sbbi.upnp.messages.UPNPResponseException; /** * Class to contain a service state variable definition * @author SuperBonBon * @version 1.0 */ @SuppressWarnings("unchecked") public class ServiceStateVariable implements ServiceStateVariableTypes { private StateVariableMessage stateVarMsg = null; protected String name; protected boolean sendEvents; protected String dataType; protected String defaultValue; protected String minimumRangeValue; protected String maximumRangeValue; protected String stepRangeValue; protected Set allowedvalues; protected UPNPService parent; protected ServiceStateVariable() { } /** * Call to the UPNP device to retreive the state variable actual value * @return the state variable actual value on the device, should be never null, an empty string could be returned by the device * @throws UPNPResponseException if the device throws an exception during query * @throws IOException if some IO error with device occurs during query */ public String getValue() throws UPNPResponseException, IOException { if ( stateVarMsg == null ) { synchronized( this ) { if ( stateVarMsg == null ) { UPNPMessageFactory factory = UPNPMessageFactory.getNewInstance( parent ); stateVarMsg = factory.getStateVariableMessage( name ); } } } return stateVarMsg.service().getStateVariableValue(); } /** * State variable name * @return the state variable name */ public String getName() { return name; } /** * The parent UPNPService Object * @return the parent object instance */ public UPNPService getParent() { return parent; } /** * Boolean to indicate if the variable is sending events when value * of the var is changing. The events can be subscribed via the {@link net.sbbi.upnp.ServicesEventing} * class * @return true if sending events */ public boolean isSendEvents() { return sendEvents; } /** * The default value of the state variable * @return the default value representation as an string */ public String getDefaultValue() { return defaultValue; } /** * The variable UPNP data type * @return the data type */ public String getDataType() { return dataType; } /** * The varialbe JAVA data type (using an UPNP->Java mapping) * @return the class mapped */ public Class getDataTypeAsClass() { return getDataTypeClassMapping( dataType ); } /** * A set of allowed values (String objects) for the variable * @return the allowed values or null if none */ public Set getAllowedvalues() { return allowedvalues; } /** * The minimum value as a string * @return the minimum value or null if no restriction */ public String getMinimumRangeValue() { return minimumRangeValue; } /** * The maximum value as a string * @return the maximum value or null if no restriction */ public String getMaximumRangeValue() { return maximumRangeValue; } /** * The value step range as a string * @return the value step raqnge or null if no restriction */ public String getStepRangeValue() { return stepRangeValue; } public static Class getDataTypeClassMapping( String dataType ) { int hash = dataType.hashCode(); if ( hash == UI1_INT ) return Short.class; else if ( hash == UI2_INT ) return Integer.class; else if ( hash == UI4_INT ) return Long.class; else if ( hash == I1_INT ) return Byte.class; else if ( hash == I2_INT ) return Short.class; else if ( hash == I4_INT ) return Integer.class; else if ( hash == INT_INT ) return Integer.class; else if ( hash == R4_INT ) return Float.class; else if ( hash == R8_INT ) return Double.class; else if ( hash == NUMBER_INT ) return Double.class; else if ( hash == FIXED_14_4_INT ) return Double.class; else if ( hash == FLOAT_INT ) return Float.class; else if ( hash == CHAR_INT) return Character.class; else if ( hash == STRING_INT ) return String.class; else if ( hash == DATE_INT ) return Date.class; else if ( hash == DATETIME_INT ) return Date.class; else if ( hash == DATETIME_TZ_INT ) return Date.class; else if ( hash == TIME_INT ) return Date.class; else if ( hash == TIME_TZ_INT ) return Date.class; else if ( hash == BOOLEAN_INT ) return Boolean.class; else if ( hash == BIN_BASE64_INT ) return String.class; else if ( hash == BIN_HEX_INT ) return String.class; else if ( hash == URI_INT ) return URI.class; else if ( hash == UUID_INT ) return String.class; return null; } public static String getUPNPDataTypeMapping( String className ) { if ( className.equals( Short.class.getName() ) || className.equals( "short" )) return I2; else if ( className.equals( Byte.class.getName() ) || className.equals( "byte" )) return I1; else if ( className.equals( Integer.class.getName() ) || className.equals( "int" ) ) return INT; else if ( className.equals( Long.class.getName() ) || className.equals( "long" ) ) return UI4; else if ( className.equals( Float.class.getName() ) || className.equals( "float" )) return FLOAT; else if ( className.equals( Double.class.getName() ) || className.equals( "double" ) ) return NUMBER; else if ( className.equals( Character.class.getName() ) || className.equals( "char" ) ) return CHAR; else if ( className.equals( String.class.getName() ) || className.equals( "string" ) ) return STRING; else if ( className.equals( Date.class.getName() ) ) return DATETIME; else if ( className.equals( Boolean.class.getName() ) || className.equals( "boolean" ) ) return BOOLEAN; else if ( className.equals( URI.class.getName() ) ) return URI; return null; } public static Object UPNPToJavaObject( String dataType, String value ) throws Throwable { if ( value == null ) throw new Exception( "null value" ); if ( dataType == null ) throw new Exception( "null dataType" ); int hash = dataType.hashCode(); if ( hash == UI1_INT ) return new Short( value ); else if ( hash == UI2_INT ) return new Integer( value ); else if ( hash == UI4_INT ) return new Long( value ); else if ( hash == I1_INT ) return new Byte( value ); else if ( hash == I2_INT ) return new Short( value ); else if ( hash == I4_INT ) return new Integer( value ); else if ( hash == INT_INT ) return new Integer( value ); else if ( hash == R4_INT ) return new Float( value ); else if ( hash == R8_INT ) return new Double( value ); else if ( hash == NUMBER_INT ) return new Double( value ); else if ( hash == FIXED_14_4_INT ) return new Double( value ); else if ( hash == FLOAT_INT ) return new Float( value ); else if ( hash == CHAR_INT) return new Character( value.charAt( 0 ) ); else if ( hash == STRING_INT ) return value; else if ( hash == DATE_INT ) return ISO8601Date.parse( value ); else if ( hash == DATETIME_INT ) return ISO8601Date.parse( value ); else if ( hash == DATETIME_TZ_INT ) return ISO8601Date.parse( value ); else if ( hash == TIME_INT ) return ISO8601Date.parse( value ); else if ( hash == TIME_TZ_INT ) return ISO8601Date.parse( value ); else if ( hash == BOOLEAN_INT ) { if ( value.equals( "1" ) || value.equalsIgnoreCase( "yes" ) || value.equals( "true" ) ) { return Boolean.TRUE; } return Boolean.FALSE; } else if ( hash == BIN_BASE64_INT ) return value; else if ( hash == BIN_HEX_INT ) return value; else if ( hash == URI_INT ) return new URI( value ); else if ( hash == UUID_INT ) return value; throw new Exception( "Unhandled data type " + dataType ); } }