Interface IRequest
-
public interface IRequest
- Since:
- CS5
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description java.lang.String
call()
IClient
client()
Returns the client initiating the request.void
fail(java.lang.String reasonCode, java.lang.String errMessage)
Marks the request as failed.NCMap
params()
Returns the request parameters.NCMap
results()
Returns the results map.void
setProgress(java.lang.String taskname, double progress)
Update progress information for this request [0.0 ...boolean
succeeded()
Returns true if the request was processed successfully.
-
-
-
Method Detail
-
call
java.lang.String call()
- Returns:
- NativeService call name
-
params
NCMap params()
Returns the request parameters.- Returns:
- the request parameters
-
results
NCMap results()
Returns the results map.- Returns:
- the results map
-
client
IClient client()
Returns the client initiating the request.- Returns:
- the client initiating the request
-
succeeded
boolean succeeded()
Returns true if the request was processed successfully. A request is considered not successful if either the fail() method was called or theIHostDelegate#execute(IRequest)
method throws an exception.- Returns:
- true if the request was processed successfully
-
fail
void fail(java.lang.String reasonCode, java.lang.String errMessage)
Marks the request as failed. The reason code and error message are transmitted to ncomm client and will result in an ncomm exception on the client side.- Parameters:
reasonCode
- - error codeerrMessage
- - error message
-
setProgress
void setProgress(java.lang.String taskname, double progress) throws ServiceAbortException
Update progress information for this request [0.0 ... 1.0]- Parameters:
taskname
- the task currently being performedprogress
- the new progress value [0.0 ... 1.0]- Throws:
ServiceAbortException
- if the request was aborted
-
-