com.iotize.android.device.device.impl.manager

Class DeviceManager

java.lang.Object

com.iotize.android.device.device.impl.manager.DeviceManager

public class DeviceManager
extends java.lang.Object

Helper class to store created tap device. You can add new device with create(IoTizeDevice) methods You can get them with get(String) method

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	DeviceManager.OnDeviceCreatedListener
static interface	DeviceManager.OnDeviceRemovedListener
static interface	DeviceManager.OnEvent

Method Summary

Modifier and Type	Method and Description
DeviceManager	addListener(DeviceManager.OnDeviceCreatedListener onDeviceCreatedListener)
void	addListener(DeviceManager.OnDeviceRemovedListener onDeviceRemovedListener)
void	clear() Clear all registered device and make sure to disconnect theme before Disconnection errors are ignored
IoTizeDevice	create(ComProtocol comProtocol)
IoTizeDevice	create(ComProtocol comProtocol, java.lang.String tag)
IoTizeDevice	create(IoTizeDevice device)
IoTizeDevice	create(IoTizeDevice ioTizeDevice, java.lang.String tag) TODO move inside protocol factory ?
IoTizeDevice	get(java.lang.String tag) Get an IoTize device by tag (identifier)
static DeviceManager	getDefaultInstance()
java.util.HashMap<java.lang.String,IoTizeDevice>	getDevices()
IoTizeDevice	getFirstConnectedDevice() Get a random connected device
IoTizeDevice	getIfExists(java.lang.String deviceTag) Get device if it exists, null otherwise
DeviceManager.OnEvent	getProgressListener()
IoTizeDevice	getSafely(java.lang.String deviceTag) Get device or throw IllegalArgumentException if it does not exist
boolean	hasDevice(java.lang.String deviceTag)
static DeviceManager	newInstance()
static <any>	readRequiredInfo(IoTizeDevice device)
void	registerDevice(IoTizeDevice ioTizeDevice) Register a new device If device already exists, it is merged
void	remove(IoTizeDevice ioTizeDevice) Remove a device from the device manager If device is still connected, it will be disconnected before being removed
boolean	removeListener(DeviceManager.OnDeviceCreatedListener listener)
boolean	removeListener(DeviceManager.OnDeviceRemovedListener listener)
void	setProgressListener(DeviceManager.OnEvent progressListener)

Methods inherited from class java.lang.Object

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

Method Detail

getDefaultInstance

@NonNull
public static DeviceManager getDefaultInstance()

newInstance

@NonNull
public static DeviceManager newInstance()

Returns:

new instance

addListener

public DeviceManager addListener(@NonNull
                                 DeviceManager.OnDeviceCreatedListener onDeviceCreatedListener)

addListener

public void addListener(@NonNull
                        DeviceManager.OnDeviceRemovedListener onDeviceRemovedListener)

removeListener

public boolean removeListener(@NonNull
                              DeviceManager.OnDeviceCreatedListener listener)

removeListener

public boolean removeListener(@NonNull
                              DeviceManager.OnDeviceRemovedListener listener)

getProgressListener

@Nullable
public DeviceManager.OnEvent getProgressListener()

setProgressListener

public void setProgressListener(@Nullable
                                DeviceManager.OnEvent progressListener)

get

@NonNull
public IoTizeDevice get(@NonNull
                                  java.lang.String tag)
                           throws UnknownDeviceException

Get an IoTize device by tag (identifier)

Parameters:

tag - device identifier

Returns:

the device

Throws:

UnknownDeviceException - if device does not exist

readRequiredInfo

public static <any> readRequiredInfo(IoTizeDevice device)
                              throws java.lang.Exception

Throws:

java.lang.Exception

create

@NonNull
public IoTizeDevice create(@NonNull
                                     IoTizeDevice ioTizeDevice,
                                     @Nullable
                                     java.lang.String tag)
                              throws java.lang.Exception

TODO move inside protocol factory ?

Parameters:

ioTizeDevice -

tag -

Returns:

Throws:

java.lang.Exception

create

@NonNull
public IoTizeDevice create(@NonNull
                                     IoTizeDevice device)
                              throws java.lang.Exception

Throws:

java.lang.Exception

create

@NonNull
public IoTizeDevice create(@NonNull
                                     ComProtocol comProtocol,
                                     @Nullable
                                     java.lang.String tag)
                              throws java.lang.Exception

Throws:

java.lang.Exception

create

@NonNull
public IoTizeDevice create(@NonNull
                                     ComProtocol comProtocol)
                              throws java.lang.Exception

Throws:

java.lang.Exception

registerDevice

public void registerDevice(@NonNull
                           IoTizeDevice ioTizeDevice)

Register a new device If device already exists, it is merged

Parameters:

ioTizeDevice - the new device

getDevices

@NonNull
public java.util.HashMap<java.lang.String,IoTizeDevice> getDevices()

getFirstConnectedDevice

@Nullable
public IoTizeDevice getFirstConnectedDevice()

Get a random connected device

Returns:

one random instance or null if nothing

remove

public void remove(IoTizeDevice ioTizeDevice)

Remove a device from the device manager If device is still connected, it will be disconnected before being removed

Parameters:

ioTizeDevice - to remove

clear

public void clear()

Clear all registered device and make sure to disconnect theme before Disconnection errors are ignored

hasDevice

public boolean hasDevice(java.lang.String deviceTag)

Parameters:

deviceTag - identifier

Returns:

true if device exists

getSafely

@NonNull
public IoTizeDevice getSafely(java.lang.String deviceTag)

Get device or throw IllegalArgumentException if it does not exist

Parameters:

deviceTag - identifier

Returns:

the device

getIfExists

@Nullable
public IoTizeDevice getIfExists(java.lang.String deviceTag)

Get device if it exists, null otherwise

Parameters:

deviceTag - identifier

Returns:

the device if it exists, null otherwise