Skip navigation links

oracle.irm.engine.core.device
Interface Device

public interface Device

A device. A device represents a physical device, such as a desktop computer, mobile phone or laptop. When a License is delivered to a device is is said to be served to that device. Depending on the type of license, a record of the device is made when the license is served. This information is used to prevent password sharing by stopping a license being served to multiple devices. The properties of a device are provided to help track where licenses have been served. These properties include the device host Name and a list of device network Adapters.

Creation

Instances of Device objects can be created using the following factory style method(s).

Device object = createDevice();

Device object = createDevice(uuid);

Device object = createDevice(
    uuid,
    name,
    adapters);

Collections

Collections for Device objects can be created using the following factory method. This method creates the most appropriate collection implementation class for storing Device elements.

 Collection<Device> object = createDevices();

Consult the Uuid property for more information on how this property can relate to Device collections.

XML Serialization

Device instances can be serialized as an XML document. This XML document can also be used to recreate a Device object. The following XML document shows an example Device in XML form.

<?xml version="1.0" encoding="UTF-8"?>
<core:Device xmlns:core="http://xmlns.oracle.com/irm/core">
<uuid>a7352732-dcd0-43af-93c5-0cbc7c1f203d</uuid>
<name>device1</name>
<adapters>
<macAddress>01-23-45-67-89-ab</macAddress>
<ipAddresses>192.168.0.1</ipAddresses>
<ipAddresses>192.168.0.2</ipAddresses>
</adapters>
</core:Device>

Method Summary

Collection<NetworkAdapter>	getAdapters() The network adapters of the device.
String	getName() The name of the device.
UUID	getUuid() The globally unique device UUID.

Method Detail

getUuid

UUID getUuid()

The globally unique device UUID. The device UUID is used to logically identify a place that can stores licenses. This may be a one to one mapping with a physical device (if it has one place to store licenses) or could be a per device, per account UUID (if the device is used by multiple accounts and licenses are stored in separate locations).

Collections

This property value can be used to retrieve the object from a collection using getDeviceByUuid.

Returns:

the value of the property. This method will never return null.

getName

String getName()

The name of the device. This information can change over the life time of a device. This is typically the host name of the device.

Size

This property is limited to 255 characters in length.

Returns:

the value of the property. This method will never return null.

getAdapters

Collection<NetworkAdapter> getAdapters()

The network adapters of the device. This list typically contains a list of network adapters available to the device. It does not indicate which adapter was used to communicate to the server, rather a list of all adapters that the device can use. This information is provided with the aim of helping identify the physical device.

State

The collection returned by this method is an unmodifiable view on the internal collection state of the object.

Returns:

the value of the property. If this collection is empty this method returns an empty collection rather than returning null.

Skip navigation links