Class StatusItem
dw.system
Class StatusItem
Object
dw.system.StatusItem
A StatusItem holds all the status information. Multi StatusItems are bundled together into a Status.
Properties
code  :  String
The status code is the unique identifier for the message and can be used by client programs to check for a specific status and to generate a localized message.
details  :  Map  (Read Only)
The optional details for this StatusItem.
error  :  boolean  (Read Only)
Returns whether this Status Item represents and error.
message  :  String
The default human readable message for this Status. Note: Custom code and client programs must not use this message to identify a specific status. The getCode() must be used for that purpose. The actual message can change from release to release.
parameters  :  List
The parameters to construct a custom message.
status  :  Number
The status.
Constructor Summary
StatusItem()
Constructs a new OK StatusItem.
StatusItem(status : Number)
Constructs a new StatusItem with the given status.
StatusItem(status : Number, code : String)
Constructs a new StatusItem with the given status and code.
StatusItem(status : Number, code : String, message : String, parameters : Object...)
Constructs a new StatusItem with the given values.
Method Summary
addDetail(key : String, value : Object) : void
Add an additional detail to this StatusItem.
getCode() : String
The status code is the unique identifier for the message and can be used by client programs to check for a specific status and to generate a localized message.
getDetails() : Map
Returns the optional details for this StatusItem.
getMessage() : String
Returns the default human readable message for this Status.
getParameters() : List
Returns the parameters to construct a custom message.
getStatus() : Number
Returns the status.
isError() : boolean
Returns whether this Status Item represents and error.
setCode(code : String) : void
Method to set the status code.
setMessage(message : String) : void
Sets the default human readable message for this Status.
setParameters(parameters : Object...) : void
Sets the parameters for a custom message.
setStatus(status : Number) : void
Set the status.
Constructor Detail
StatusItem
public StatusItem()
Constructs a new OK StatusItem.

StatusItem
public StatusItem(status : Number)
Constructs a new StatusItem with the given status.
Parameters:
status - either Status.OK or Status.ERROR.

StatusItem
public StatusItem(status : Number, code : String)
Constructs a new StatusItem with the given status and code.
Parameters:
status - either Status.OK or Status.ERROR.
code - a string representing a more detailed status code, e.g. "IMPEX-120".

StatusItem
public StatusItem(status : Number, code : String, message : String, parameters : Object...)
Constructs a new StatusItem with the given values.
Parameters:
status - Status.OK or Status.ERROR.
code - a string representing a more detailed status code, e.g. "IMPEX-120".
message - a default human readable message
parameters - a list of parameters to construct a custom message

Method Detail
addDetail
addDetail(key : String, value : Object) : void
Add an additional detail to this StatusItem.
Parameters:
key - the key for the detail.
value - the detail value.

getCode
getCode() : String
The status code is the unique identifier for the message and can be used by client programs to check for a specific status and to generate a localized message.
Returns:
the status code.

getDetails
getDetails() : Map
Returns the optional details for this StatusItem.
Returns:
the optional details for this StatusItem.

getMessage
getMessage() : String
Returns the default human readable message for this Status. Note: Custom code and client programs must not use this message to identify a specific status. The getCode() must be used for that purpose. The actual message can change from release to release.
Returns:
the default human readable message for this Status.

getParameters
getParameters() : List
Returns the parameters to construct a custom message.
Returns:
the parameters to construct a custom message.

getStatus
getStatus() : Number
Returns the status.
Returns:
either Status.OK or Status.ERROR.

isError
isError() : boolean
Returns whether this Status Item represents and error.
Returns:
true is this item represents an error, false otherwise.

setCode
setCode(code : String) : void
Method to set the status code. The status code is the unique identifier for the message and can be used by client programs to check for a specific status and to generate a localized message.
Parameters:
code - the status code.

setMessage
setMessage(message : String) : void
Sets the default human readable message for this Status.
Parameters:
message - the default human readable message for this Status.

setParameters
setParameters(parameters : Object...) : void
Sets the parameters for a custom message.
Parameters:
parameters - the parameters for a custom message.

setStatus
setStatus(status : Number) : void
Set the status.
Parameters:
status - either Status.OK or Status.ERROR.