/* Copyright 2004 Intel Corporation This file is part of Blue Cove. Blue Cove is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. Blue Cove is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with Blue Cove; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA */package javax.bluetooth;import java.util.Enumeration;import java.util.Vector;public class DataElement {	/*	 * Defines data of type NULL. The value for data type DataElement.NULL is	 * implicit, i.e., there is no representation of it. Accordingly there is no	 * method to retrieve it, and attempts to retrieve the value will throw an	 * exception. The value of NULL is 0x00 (0).	 */	public static final int NULL = 0;	/*	 * Defines an unsigned integer of size one byte. The value of the constant	 * U_INT_1 is 0x08 (8).	 */	public static final int U_INT_1 = 8;	/*	 * Defines an unsigned integer of size two bytes. The value of the constant	 * U_INT_2 is 0x09 (9).	 */	public static final int U_INT_2 = 9;	/*	 * Defines an unsigned integer of size four bytes. The value of the constant	 * U_INT_4 is 0x0A (10).	 */	public static final int U_INT_4 = 10;	/*	 * Defines an unsigned integer of size eight bytes. The value of the	 * constant U_INT_8 is 0x0B (11).	 */	public static final int U_INT_8 = 11;	/*	 * Defines an unsigned integer of size sixteen bytes. The value of the	 * constant U_INT_16 is 0x0C (12).	 */	public static final int U_INT_16 = 12;	/*	 * Defines a signed integer of size one byte. The value of the constant	 * INT_1 is 0x10 (16).	 */	public static final int INT_1 = 16;	/*	 * Defines a signed integer of size two bytes. The value of the constant	 * INT_2 is 0x11 (17).	 */	public static final int INT_2 = 17;	/*	 * Defines a signed integer of size four bytes. The value of the constant	 * INT_4 is 0x12 (18).	 */	public static final int INT_4 = 18;	/*	 * Defines a signed integer of size eight bytes. The value of the constant	 * INT_8 is 0x13 (19).	 */	public static final int INT_8 = 19;	/*	 * Defines a signed integer of size sixteen bytes. The value of the constant	 * INT_16 is 0x14 (20).	 */	public static final int INT_16 = 20;	/*	 * Defines data of type URL. The value of the constant URL is 0x40 (64).	 */	public static final int URL = 64;	/*	 * Defines data of type UUID. The value of the constant UUID is 0x18 (24).	 */	public static final int UUID = 24;	/*	 * Defines data of type BOOL. The value of the constant BOOL is 0x28 (40).	 */	public static final int BOOL = 40;	/*	 * Defines data of type STRING. The value of the constant STRING is 0x20	 * (32).	 */	public static final int STRING = 32;	/*	 * Defines data of type DATSEQ. The service attribute value whose data has	 * this type must consider all the elements of the list, i.e. the value is	 * the whole set and not a subset. The elements of the set can be of any	 * type defined in this class, including DATSEQ. The value of the constant	 * DATSEQ is 0x30 (48).	 */	public static final int DATSEQ = 48;	/*	 * Defines data of type DATALT. The service attribute value whose data has	 * this type must consider only one of the elements of the set, i.e., the	 * value is the not the whole set but only one element of the set. The user	 * is free to choose any one element. The elements of the set can be of any	 * type defined in this class, including DATALT. The value of the constant	 * DATALT is 0x38 (56).	 */	public static final int DATALT = 56;	private Object value;	private int valueType;	/*	 * Creates a DataElement of type NULL, DATALT, or DATSEQ. Parameters:	 * valueType - the type of DataElement to create: NULL, DATALT, or DATSEQ	 * Throws: IllegalArgumentException - if valueType is not NULL, DATALT, or	 * DATSEQ See Also: NULL, DATALT, DATSEQ	 */	public DataElement(int valueType) {		switch (valueType) {		case NULL:			value = null;			break;		case DATALT:		case DATSEQ:			value = new Vector();			break;		default:			throw new IllegalArgumentException();		}		this.valueType = valueType;	}	/*	 * Creates a DataElement whose data type is BOOL and whose value is equal to	 * bool Parameters: bool - the value of the DataElement of type BOOL. See	 * Also: BOOL	 */	public DataElement(boolean bool) {		value = new Boolean(bool);		valueType = BOOL;	}	/*	 * Creates a DataElement that encapsulates an integer value of size U_INT_1,	 * U_INT_2, U_INT_4, INT_1, INT_2, INT_4, and INT_8. The legal values for	 * the valueType and the corresponding attribute values are: Value Type	 * Value Range U_INT_1 [0, 2^8-1] U_INT_2 [0, 2^16-1] U_INT_4 [0, 2^32-1]	 * INT_1 [-2^7, 2^7-1] INT_2 [-2^15, 2^15-1] INT_4 [-2^31, 2^31-1] INT_8	 * [-2^63, 2^63-1] All other pairings are illegal and will cause an	 * IllegalArgumentException to be thrown. Parameters: valueType - the data	 * type of the object that is being created; must be one of the following:	 * U_INT_1, U_INT_2, U_INT_4, INT_1, INT_2, INT_4, or INT_8 value - the	 * value of the object being created; must be in the range specified for the	 * given valueType Throws: IllegalArgumentException - if the valueType is	 * not valid or the value for the given legal valueType is outside the valid	 * range See Also: U_INT_1, U_INT_2, U_INT_4, INT_1, INT_2, INT_4, INT_8	 */	public DataElement(int valueType, long value) {		switch (valueType) {		case U_INT_1:			if (value < 0 || value > 0xff)				throw new IllegalArgumentException();			break;		case U_INT_2:			if (value < 0 || value > 0xffff)				throw new IllegalArgumentException();			break;		case U_INT_4:			if (value < 0 || value > 0xffffffffl)				throw new IllegalArgumentException();			break;		case INT_1:			if (value < -0x80 || value > 0x7f)				throw new IllegalArgumentException();			break;		case INT_2:			if (value < -0x8000 || value > 0x7fff)				throw new IllegalArgumentException();			break;		case INT_4:			if (value < -0x80000000 || value > 0x7fffffff)				throw new IllegalArgumentException();			break;		case INT_8:			break;		default:			throw new IllegalArgumentException();		}		this.value = new Long(value);		this.valueType = valueType;	}	/*	 * Creates a DataElement whose data type is given by valueType and whose	 * value is specified by the argument value. The legal values for the	 * valueType and the corresponding attribute values are: Value Type Java	 * Type / Value Range URL java.lang.String UUID javax.bluetooth.UUID STRING	 * java.lang.String INT_16 [-2127, 2127-1] as a byte array whose length must	 * be 16 U_INT_8 [0, 264-1] as a byte array whose length must be 8 U_INT_16	 * [0, 2128-1] as a byte array whose length must be 16 All other pairings	 * are illegal and would cause an IllegalArgumentException exception.	 * Parameters: valueType - the data type of the object that is being	 * created; must be one of the following: URL, UUID, STRING, INT_16,	 * U_INT_8, or U_INT_16 value - the value for the DataElement being created	 * of type valueType Throws: IllegalArgumentException - if the value is not	 * of the valueType type or is not in the range specified or is null See	 * Also: URL, UUID, STRING, U_INT_8, INT_16, U_INT_16	 */	public DataElement(int valueType, Object value) {		if (value == null)			throw new IllegalArgumentException();		switch (valueType) {		case URL:		case STRING:			if (!(value instanceof String))				throw new IllegalArgumentException();			break;