com.hp.device

Interface DeviceIdentityHandler

All Superinterfaces:

DeviceIdentity, Facet, HandlerFacet

All Known Implementing Classes:

DefaultDeviceIdentityHandler, ManualDeviceIdentityHandler

public interface DeviceIdentityHandler
extends DeviceIdentity, HandlerFacet

A generic Facet that provides read-write access concerning a device's identity.

Author:

Simon Hunt

Method Summary

Methods

Modifier and Type	Method and Description
void	digest(Object memento) Accepts an opaque memento containing device identity information, presumably obtained from a prior communication with the device.
DeviceInfo	evolve() Return an evolved device info context.
void	generateUniqueId() Generates a globally unique device ID using device specific information and a type-specific algorithm and stamps it into the associated device info entity.
void	setContact(String contact) Set the device contact.
void	setLocation(String location) Set the device location.
void	setName(String name) Set the device name.

Methods inherited from interface com.hp.device.DeviceIdentity

getContact, getDescription, getDriverFirmwareVersion, getFamily, getFirmwareVersion, getIpAddress, getLocation, getModelNumber, getName, getProductNumber, getSerialNumber, getUniqueId, getVendor

Methods inherited from interface com.hp.device.HandlerFacet

apply, fetch, getIpAddress, setIpAddress

Methods inherited from interface com.hp.device.Facet

getContext, getTypeName

Method Detail

setName

void setName(String name)

Set the device name.

Parameters:

name - the device name

setLocation

void setLocation(String location)

Set the device location.

Parameters:

location - the device location

setContact

void setContact(String contact)

Set the device contact.

Parameters:

contact - the device contact

generateUniqueId

void generateUniqueId()

Generates a globally unique device ID using device specific information and a type-specific algorithm and stamps it into the associated device info entity.

digest

void digest(Object memento)

Accepts an opaque memento containing device identity information, presumably obtained from a prior communication with the device. This allows information learned about the device in some protocol-specific manner to be used to avoid a repeated trip (via HandlerFacet.fetch() method) to the device in order to obtain the same information.

Implementations are to interpret and digest the information in this memento into the associated device info instance.

Parameters:

memento - opaque container of device identity information

evolve

DeviceInfo evolve()

Return an evolved device info context.

Note: implementations should use DeviceDriverProvider.switchType(com.hp.device.MutableDeviceInfo, java.lang.String) if it is determined that the device type needs to change.

Returns:

the evolved info potentially backed by a different device type