oracle.lite.resource.dm

Class DeviceCommand

java.lang.Object

oracle.lite.resource.Resource

oracle.lite.resource.dm.DeviceCommand

All Implemented Interfaces:

ResourceConst, oracle.lite.util.Sortable

public class DeviceCommand
extends Resource

This class will hold all the relevent information about a Device Management command issued (or to be issued) to a client device.

Field Summary

Fields

Modifier and Type	Field and Description
static int	HIGH_PRIORITY
static int	LOW_PRIORITY Command priorities.
static int	MEDIUM_PRIORITY
static java.lang.String	SELECT

Fields inherited from interface oracle.lite.resource.ResourceConst

AUTH_TYPE, CONN_MAX_EXCEEDED, DEVICE_DELETE, DEVICE_REGISTER, EMPTY_STR, INVALID_ADDRESS, INVALID_DEVICE, INVALID_DIR, INVALID_ID, INVALID_INF, INVALID_NAME, INVALID_PARAM, INVALID_PLATFORM, INVALID_PROVIDER, INVALID_RESOURCE, INVALID_TYPE, INVALID_URL, NOT_FOUND, NOT_INITIALIZED, NOTIFY_CLASS, NOTIFY_ON_STATUS, NOTIFY_ON_VERIFY, RESOURCE_ENABLED, RESOURCE_VALID, SEP, STR_ANY, STR_BASE_NAME, STR_DMC, STR_EMPTY, STR_FALSE, STR_INF, STR_INF_EXT, STR_ONE, STR_TRUE, STR_WILD, STR_ZERO, SYSTEM_ID, TIME, UPDATE_MAJOR, UPDATE_MINOR, UPDATE_SOFTWARE, UPDATE_SOFTWARE_APPS, UPDATE_SOFTWARE_DMC

Constructor Summary

Constructors

Constructor and Description
DeviceCommand(Command cmd, Device dev) Construct a new DeviceCommand object from a Command object.
DeviceCommand(java.sql.ResultSet rs, Device device) Construct a DeviceCommand object from a ResultSet.

Method Summary

Methods

Modifier and Type	Method and Description
Command	getCommand() Get the command object referenced by this DeviceCommand object
java.lang.String	getCommandId() Get the command id
java.lang.String	getCommandString() Get command string of the command object.
java.lang.String	getParams() Get the params
java.sql.Timestamp	getSendTime() Get date & time when the request was sent to the client.
java.lang.String	getStatusMessage() Get client status message of the request.
java.sql.Timestamp	getStatusTime() Get date & time when the request status was updated.
java.sql.Timestamp	getVerificationTime() Get date & time when the request was verified
void	queue() Queue this command in the device queue
void	send(int priority, Address address) Send this command to the device.
void	setAddress(java.lang.String address) Set address
void	setAlwaysAccept(boolean accept)
void	setIOSParams(java.lang.String value) set iOS device command parameters current iOS commands take at most 1 parameter, if they take more than 1 parameter, the function needs to be modified.
void	setParameter(java.lang.String name, java.lang.String value) Set parameter - Name/Value pair
void	setParameters(java.lang.String param) Set device command parameters
void	setPriority(int priority) Set a new request priority.
void	setPseudo(boolean pseudo)
void	setStatus(java.lang.String time, java.lang.String msg) Update the status time of the DeviceCommand object
void	setUdid(java.lang.String udid)
void	setUuid(java.lang.String uuid)
void	setVerify() Set verification status of DeviceCommand object

Methods inherited from class oracle.lite.resource.Resource

delete, equals, getAttribute, getId, getKey, hashCode, isEnabled, isSystemResource, isValid, removeAttribute, save, setAttribute, setEnabled, setNew, validateAttribute

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

HIGH_PRIORITY

public static final int HIGH_PRIORITY

See Also:

Constant Field Values

LOW_PRIORITY

public static final int LOW_PRIORITY

Command priorities.

See Also:

Constant Field Values

MEDIUM_PRIORITY

public static final int MEDIUM_PRIORITY

See Also:

Constant Field Values

SELECT

public static final java.lang.String SELECT

See Also:

Constant Field Values

Constructor Detail

DeviceCommand

public DeviceCommand(Command cmd,
             Device dev)
              throws ResourceException

Construct a new DeviceCommand object from a Command object.

Parameters:

cmd - oracle.lite.resource.dm.Command object

dev - Device object

Throws:

oracle.lite.resource.ResourceException

ResourceException

DeviceCommand

public DeviceCommand(java.sql.ResultSet rs,
             Device device)
              throws java.sql.SQLException

Construct a DeviceCommand object from a ResultSet.

Parameters:

rs - java.sql.ResultSet object

device - oracle.lite.resource.Device object

Throws:

java.sql.SQLException

java.sql.SQLException

Method Detail

getCommand

public Command getCommand()

Get the command object referenced by this DeviceCommand object

Returns:

oracle.lite.resource.dm.Command object

getCommandId

public java.lang.String getCommandId()

Get the command id

Returns:

cmdId

getCommandString

public java.lang.String getCommandString()

Get command string of the command object. Command String format should be as follows: Command: [?] arglist: arg1=val1&arg2=val2... Group command is a collection of individual commands and/or other group commands. groupcommand: \r\n \r\n .. .. \r\n [?] Here 'cmdname/groupcmdname' mean either command name OR a group command name.

Returns:

Full command string.

getParams

public java.lang.String getParams()

Get the params

Returns:

params

getSendTime

public java.sql.Timestamp getSendTime()

Get date & time when the request was sent to the client.

Returns:

Timestamp representation of 'SEND' time.

getStatusMessage

public java.lang.String getStatusMessage()

Get client status message of the request.

Returns:

Status message.

getStatusTime

public java.sql.Timestamp getStatusTime()

Get date & time when the request status was updated.

Returns:

Timestamp representation of 'STATUS' time.

getVerificationTime

public java.sql.Timestamp getVerificationTime()

Get date & time when the request was verified

Returns:

Timestamp representation of 'VERIFICATION' time.

queue

public void queue()
           throws ResourceException

Queue this command in the device queue

Throws:

oracle.lite.resource.ResourceException

ResourceException

send

public void send(int priority,
        Address address)
          throws ResourceException

Send this command to the device.

Parameters:

priority - Command priority

address - Device address

Throws:

oracle.lite.resource.ResourceException

ResourceException

setAddress

public void setAddress(java.lang.String address)

Set address

Parameters:

address - Device address

setAlwaysAccept

public void setAlwaysAccept(boolean accept)

setIOSParams

public void setIOSParams(java.lang.String value)

set iOS device command parameters current iOS commands take at most 1 parameter, if they take more than 1 parameter, the function needs to be modified.

Parameters:

value -

setParameter

public void setParameter(java.lang.String name,
                java.lang.String value)

Set parameter - Name/Value pair

Parameters:

name - Parameter name

value - Parameter value

setParameters

public void setParameters(java.lang.String param)

Set device command parameters

Parameters:

param - Parameter string (must be in the format NAME1=VALUE1&NAME2=VALUE2)

setPriority

public void setPriority(int priority)

Set a new request priority. Request priority is transient and will be used to construct command string.

Parameters:

priority - Request priority.

setPseudo

public void setPseudo(boolean pseudo)

setStatus

public void setStatus(java.lang.String time,
             java.lang.String msg)
               throws ResourceException

Update the status time of the DeviceCommand object

Parameters:

time - Status time (must be in 'mm-dd-yyyy hh24:mi:ss' format)

msg - Status message.

Throws:

oracle.lite.resource.ResourceException

ResourceException

setUdid

public void setUdid(java.lang.String udid)

setUuid

public void setUuid(java.lang.String uuid)

setVerify

public void setVerify()
               throws ResourceException

Set verification status of DeviceCommand object

Throws:

oracle.lite.resource.ResourceException

ResourceException