jdk.dio

Class RegistrationEvent<P extends Device<? super P>>

java.lang.Object

java.util.EventObject

jdk.dio.RegistrationEvent<P>

Type Parameters:

P - the device type the event is defined for.

public class RegistrationEvent<P extends Device<? super P>>
extends java.util.EventObject

The RegistrationEvent class encapsulates device registration and unregistration conditions.

Since:

1.0

See Also:

DeviceManager, RegistrationListener

Constructor Summary

Constructors

Constructor and Description
RegistrationEvent(DeviceDescriptor<P> descriptor) Creates a new RegistrationEvent with the specified device descriptor and no initiator name.
RegistrationEvent(java.lang.String initiator, DeviceDescriptor<P> descriptor) Creates a new RegistrationEvent with the specified device descriptor and initiator.

Method Summary

Methods

Modifier and Type	Method and Description
DeviceDescriptor<P>	getDescriptor() Returns the identifying and descriptive information of the registered or unregistered device.
java.lang.String	getInitiator() Returns the free-formed name of the registration/unregistration initiator.

Methods inherited from class java.util.EventObject

getSource, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

RegistrationEvent

public RegistrationEvent(java.lang.String initiator,
                 DeviceDescriptor<P> descriptor)

Creates a new RegistrationEvent with the specified device descriptor and initiator.

Parameters:

initiator - the free-formed name of the initiator of the registration or unregistration; or null if none is defined.

descriptor - the identifying and descriptive information of the registered or unregistered device.

Throws:

java.lang.IllegalArgumentException - if descriptor is null.

RegistrationEvent

public RegistrationEvent(DeviceDescriptor<P> descriptor)

Creates a new RegistrationEvent with the specified device descriptor and no initiator name.

Parameters:

descriptor - the identifying and descriptive information of the registered or unregistered device.

Throws:

java.lang.IllegalArgumentException - if descriptor is null.

Method Detail

getDescriptor

public DeviceDescriptor<P> getDescriptor()

Returns the identifying and descriptive information of the registered or unregistered device.

Returns:

the device descriptor.

getInitiator

public java.lang.String getInitiator()

Returns the free-formed name of the registration/unregistration initiator.

Returns:

a String name identifying the initiator; or null if none is defined.