com.ibm.jusb

Class UsbStringDescriptorImp

java.lang.Object

com.ibm.jusb.UsbDescriptorImp

com.ibm.jusb.UsbStringDescriptorImp

All Implemented Interfaces:

UsbDescriptor, UsbStringDescriptor

public class UsbStringDescriptorImp
extends UsbDescriptorImp
implements UsbStringDescriptor

UsbStringDescriptor implementation.

Author:

Dan Streetman

Field Summary

Fields

Modifier and Type	Field and Description
static String[]	ENCODING These are the encodings used to decode the USB String Descriptors.
static String	ENCODING_8BIT Fallback encoding if no 16-bit encoding is supported

Constructor Summary

Constructors

Constructor and Description
UsbStringDescriptorImp(byte bLength, byte bDescriptorType, byte[] bString) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
byte[]	bString() Get this descriptor's bString.
boolean	equals(Object object) Compare this to an Object.
String	getString() Get this descriptor's translated String.

Methods inherited from class com.ibm.jusb.UsbDescriptorImp

bDescriptorType, bLength, hashCode, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface javax.usb.UsbDescriptor

bDescriptorType, bLength

Field Detail

ENCODING

public static final String[] ENCODING

These are the encodings used to decode the USB String Descriptors.

For all encodings supported by Java, see:

Java 1 (1.1) Supported Encodings

Java 2 (1.3) Supported Encodings

Java 2 (1.3) Required Encodings

The translation is done using the first available of these encodings:

• UnicodeLittleUnmarked
• UnicodeLittle
• UTF-16LE
• ASCII (after conversion from 16 bit to 8 bit)

ENCODING_8BIT

public static final String ENCODING_8BIT

Fallback encoding if no 16-bit encoding is supported

See Also:

Constant Field Values

Constructor Detail

UsbStringDescriptorImp

public UsbStringDescriptorImp(byte bLength,
                      byte bDescriptorType,
                      byte[] bString)

Constructor.

Parameters:

bLength - This descriptor's bLength.

bDescriptorType - This descriptor's bDescriptorType.

bString - This descriptor's bString.

Method Detail

bString

public byte[] bString()

Get this descriptor's bString.

Specified by:

bString in interface UsbStringDescriptor

Returns:

This descriptor's bString.

getString

public String getString()
                 throws UsbEncodingException

Get this descriptor's translated String.

This is the String translation of the bString. The best available 16-bit encoding is used. If no 16-bit encoding is available, 8-bit encoding is used, unless any of the characters are 16 bit (high byte is non-zero); then 8-bit encoding is not used, and an UsbEncodingException is thrown.

Specified by:

getString in interface UsbStringDescriptor

Returns:

This descriptor's String.

Throws:

UsbEncodingException - If no encodings are available.

equals

public boolean equals(Object object)

Compare this to an Object.

Overrides:

equals in class UsbDescriptorImp

Parameters:

object - The Object to compare to.

Returns:

If this is equal to the Object.