de.taimos.dvalin.interconnect.model.service

Annotation Type DaemonRequestMethod

@Target(value=METHOD)
 @Retention(value=RUNTIME)
public @interface DaemonRequestMethod

A request method:
- MUST have a single parameter extending IVO
- MUST have a return value of:
* extending IVO
* void (an VoidIVO is send as response)
* List<? extends IVO>
* extending IVO[]
* MUST throw an DaemonError
It is used for something like request/response scenarios.

See Also:

Daemon

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
boolean	idempotent The method can be executed multiple times and always produces the same result.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
boolean	secure Requests must be send in secure mode (encrypted communication).
long	timeout The maximum amount of time the requester have to wait for a response from the daemon. After the timeout is reached the requester will not receive a response from the daemon any more. ATTENTION: The request can be executed successfully although the timeout was reached and no response was delivered!
TimeUnit	timeoutUnit The time unit of the timeout parameter.

Element Detail

idempotent

public abstract boolean idempotent

The method can be executed multiple times and always produces the same result. (if the call fails and the method is idempotent the call will be retried several times)

Returns:

true if the call is idempotent

timeout

public abstract long timeout

The maximum amount of time the requester have to wait for a response from the daemon.
After the timeout is reached the requester will not receive a response from the daemon any more.
ATTENTION: The request can be executed successfully although the timeout was reached and no response was delivered!

Returns:

the timeout of the method

Default:

10L

timeoutUnit

public abstract TimeUnit timeoutUnit

The time unit of the timeout parameter.

Returns:

the TimeUnit of the timeout

Default:

java.util.concurrent.TimeUnit.SECONDS

secure

public abstract boolean secure

Requests must be send in secure mode (encrypted communication). Otherwise a request is rejected by the daemon.

Returns:

true if secure mode is enabled

Default:

false