com.ibm.jusb.os

Class DefaultUsbDeviceOsImp

java.lang.Object

com.ibm.jusb.os.DefaultUsbDeviceOsImp

All Implemented Interfaces:

UsbDeviceOsImp

public class DefaultUsbDeviceOsImp
extends Object
implements UsbDeviceOsImp

Default UsbDeviceOsImp implementation.

This is an optional default implementation that handles all methods. Those methods may be overridden by the implementation if desired. The implementation is not required to extend this class. All methods are implemented using the asyncSubmit(UsbControlIrpImp) method; this method, at a minimum, must be implemented in order to provide any actual functionality.

The default action for this class is to throw a UsbException for all submission methods.

Author:

Dan Streetman

Field Summary

Fields

Modifier and Type	Field and Description
static String	HOST_CONTROLLER_SUBMIT_STRING
protected RunnableManager	runnableManager
static String	SUBMIT_STRING
protected String	submitString

Constructor Summary

Constructors

Constructor and Description
DefaultUsbDeviceOsImp() Constructor.
DefaultUsbDeviceOsImp(String submitString) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	asyncSubmit(List list) Asynchronously submit a List of UsbControlIrpImps.
void	asyncSubmit(UsbControlIrpImp usbControlIrpImp) Asynchronously submit a UsbControlIrpImp.
protected String	getSubmitString()
void	syncSubmit(List list) Synchronously submit a List of UsbControlIrpImps.
void	syncSubmit(UsbControlIrpImp usbControlIrpImp) Synchronously submit a UsbControlIrpImp.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

runnableManager

protected RunnableManager runnableManager

submitString

protected String submitString

SUBMIT_STRING

public static final String SUBMIT_STRING

See Also:

Constant Field Values

HOST_CONTROLLER_SUBMIT_STRING

public static final String HOST_CONTROLLER_SUBMIT_STRING

See Also:

Constant Field Values

Constructor Detail

DefaultUsbDeviceOsImp

public DefaultUsbDeviceOsImp()

Constructor.

DefaultUsbDeviceOsImp

public DefaultUsbDeviceOsImp(String submitString)

Constructor.

Parameters:

submitString - The String to be used in UsbExceptions thrown from a submission method.

Method Detail

syncSubmit

public void syncSubmit(UsbControlIrpImp usbControlIrpImp)
                throws UsbException

Synchronously submit a UsbControlIrpImp.

This method is implemented using asyncSubmit(UsbControlIrpImp).

Specified by:

syncSubmit in interface UsbDeviceOsImp

Parameters:

usbControlIrpImp - The UsbControlIrpImp.

Throws:

UsbException - If the submission is unsuccessful.

asyncSubmit

public void asyncSubmit(UsbControlIrpImp usbControlIrpImp)
                 throws UsbException

Asynchronously submit a UsbControlIrpImp.

This throws a UsbException with the specified string. The implementation should override (at least) this method.

Specified by:

asyncSubmit in interface UsbDeviceOsImp

Parameters:

usbControlIrpImp - The UsbControlIrpImp.

Throws:

UsbException - If the submission is unsucessful.

syncSubmit

public void syncSubmit(List list)
                throws UsbException

Synchronously submit a List of UsbControlIrpImps.

This method is implemented using syncSubmit(UsbControlIrpImp). If an UsbException occurrs, it is thrown immediately and any remaining UsbControlIrpImps are not submitted nor modified.

Specified by:

syncSubmit in interface UsbDeviceOsImp

Parameters:

list - The List.

Throws:

UsbException - If the one (or more) submissions are unsuccessful (optional).

asyncSubmit

public void asyncSubmit(List list)
                 throws UsbException

Asynchronously submit a List of UsbControlIrpImps.

This method is implemented using asyncSubmit(UsbControlIrpImp). If an UsbException occurrs, it is thrown immediately and any remaining UsbControlIrpImps are not submitted nor modified.

Specified by:

asyncSubmit in interface UsbDeviceOsImp

Parameters:

list - The List.

Throws:

UsbException - If the one (or more) submissions are unsuccessful (optional).

getSubmitString

protected String getSubmitString()

Returns:

The String to be used in UsbExceptions thrown from submit methods.