com.hp.device

Interface DeviceDriverProvider

All Known Subinterfaces:

DeviceDriverBroker, DeviceDriverService

All Known Implementing Classes:

AbstractDeviceDriverProvider, DefaultDeviceDriverProvider, DeviceDriverFactory, DeviceDriverServiceAdapter

public interface DeviceDriverProvider

A provider of DeviceInfo, DeviceHandler and DeviceLoader instances, backed by implementations appropriate to the requested type of device.

Author:

Simon Hunt, Thomas Vachuska

Method Summary

Methods

Modifier and Type	Method and Description
DeviceHandler	create(DeviceInfo info, IpAddress ip) Creates an instance of DeviceHandler, bound to the specified device target, and associated with the specified instance of DeviceInfo.
DeviceLoader	create(DeviceInfo info, String uid) Creates an instance of DeviceLoader, bound to the specified device UID, and associated with the specified instance of DeviceInfo.
DeviceInfo	create(String typeName) Creates an instance of DeviceInfo backed by the specified device type and void of any specific device information.
DeviceHandler	create(String typeName, IpAddress ip) Creates an instance of DeviceHandler, bound to the specified device target, and associated with a new instance of DeviceInfo backed by the specified device type and void of any specific device information.
DeviceLoader	create(String typeName, String uid) Creates an instance of DeviceLoader, bound to the specified device UID, and associated with a new instance of DeviceInfo backed by the specified device type.
Set<String>	getDeviceTypeNames() Returns a set of device type names for which this provider can create instances of DeviceInfo, DeviceHandler and DeviceLoader.
void	switchType(MutableDeviceInfo mutableDeviceInfo, String newTypeName) Given a device info instance and a type name, replace the backing device type in that instance, with the named device type.

Method Detail

getDeviceTypeNames

Set<String> getDeviceTypeNames()

Returns a set of device type names for which this provider can create instances of DeviceInfo, DeviceHandler and DeviceLoader.

Returns:

array of device type names

create

DeviceInfo create(String typeName)

Creates an instance of DeviceInfo backed by the specified device type and void of any specific device information. Returns null if there is no such mapping for the specified device type.

Parameters:

typeName - the name of the required device type

Returns:

a new device info instance; or null

create

DeviceHandler create(String typeName,
                   IpAddress ip)

Creates an instance of DeviceHandler, bound to the specified device target, and associated with a new instance of DeviceInfo backed by the specified device type and void of any specific device information. Returns null if there is no such mapping for the specified device type.

Parameters:

typeName - the name of the required device type

ip - the device IP address

Returns:

an available device handler instance; or null

create

DeviceHandler create(DeviceInfo info,
                   IpAddress ip)

Creates an instance of DeviceHandler, bound to the specified device target, and associated with the specified instance of DeviceInfo. Returns null if there is no such mapping for the specified device type.

Parameters:

info - the device info instance

ip - the device IP address

Returns:

an available device handler instance; or null

create

DeviceLoader create(String typeName,
                  String uid)

Creates an instance of DeviceLoader, bound to the specified device UID, and associated with a new instance of DeviceInfo backed by the specified device type. Returns null if there is no such mapping for the specified device type.

Parameters:

typeName - the name of the required device type

uid - the key by which the set of information describing the device can be looked up in the persistence store

Returns:

an available device loader instance; or null

create

DeviceLoader create(DeviceInfo info,
                  String uid)

Creates an instance of DeviceLoader, bound to the specified device UID, and associated with the specified instance of DeviceInfo. Returns null if there is no such mapping for the specified device type.

Parameters:

info - the device info instance

uid - the key by which the set of information describing the device can be looked up in the persistence store

Returns:

an available device loader instance; or null

switchType

void switchType(MutableDeviceInfo mutableDeviceInfo,
              String newTypeName)

Given a device info instance and a type name, replace the backing device type in that instance, with the named device type.

Parameters:

mutableDeviceInfo - the device info to be adjusted

newTypeName - the name of the replacement device type