org.brutusin.rpc.http

Class SafeAction<I,O>

java.lang.Object

org.brutusin.rpc.RpcComponent

org.brutusin.rpc.RpcAction<I,O>

org.brutusin.rpc.http.HttpAction<I,Cacheable<O>>

org.brutusin.rpc.http.SafeAction<I,O>

Type Parameters:

I - Input POJO class.

O - Output POJO class.

public abstract class SafeAction<I,O>
extends HttpAction<I,Cacheable<O>>

Used to define business operations considered safe according to the HTTP definition, meaning that the action "... defined semantics are essentially read-only; i.e., the client does not request, and does not expect, any state change on the origin server as a result of applying a safe method to a target resource. Likewise, reasonable use of a safe method is not expected to cause any harm, loss of property, or unusual burden on the origin server."

Threading issues: Instances of this class will be accessed by several threads concurrently, so implementing subclasses must be thread-safe.

Instance life-cycle: For each request received the following methods are (can be) executed:

1. #getCachingInfo(java.lang.Object): That returns caching information for this request.
2. RpcAction.execute(java.lang.Object): Depending on the client request being conditional, and on the value returned by the previous method, this method is or is not executed.

See section 4.2.1 of rfc7231 for more details.

Author:

Ignacio del Valle Alles idelvall@brutusin.org

See Also:

UnsafeAction

Constructor Summary

Constructors

Constructor and Description
SafeAction()

Method Summary

Modifier and Type	Method and Description
protected Long	getLastModified(I input)
Type	getOutputType()
boolean	isIdempotent() Action idempotence (http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html#sec9.1.2)

Methods inherited from class org.brutusin.rpc.RpcAction

execute, getInputType

Methods inherited from class org.brutusin.rpc.RpcComponent

destroy, getId, getType, init, init

Methods inherited from class java.lang.Object

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

Constructor Detail

SafeAction

public SafeAction()

Method Detail

getLastModified

protected Long getLastModified(I input)

isIdempotent

public final boolean isIdempotent()

Description copied from class: HttpAction

Action idempotence (http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html#sec9.1.2)

Specified by:

isIdempotent in class HttpAction<I,Cacheable<O>>

Returns:

getOutputType

public Type getOutputType()

Overrides:

getOutputType in class RpcAction<I,Cacheable<O>>