org.apache.dubbo.rpc

Class AppResponse

java.lang.Object

org.apache.dubbo.rpc.AppResponse

All Implemented Interfaces:

Serializable, Result

public class AppResponse
extends Object
implements Result

AsyncRpcResult is introduced in 3.0.0 to replace RpcResult, and RpcResult is replaced with AppResponse:

• AsyncRpcResult is the object that is actually passed in the call chain
• AppResponse only simply represents the business result

The relationship between them can be described as follow, an abstraction of the definition of AsyncRpcResult:

  
   Public class AsyncRpcResult implements CompletionStage {
       ......
  }
 

AsyncRpcResult is a future representing an unfinished RPC call, while AppResponse is the actual return type of this call. In theory, AppResponse does'n have to implement the {@link Result} interface, this is done mainly for compatibility purpose.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
AppResponse()
AppResponse(Object result)
AppResponse(Throwable exception)

Method Summary

Modifier and Type	Method and Description
void	addAttachments(Map<String,String> map) Add the specified map to existing attachments in this instance.
Result	get()
Result	get(long timeout, TimeUnit unit)
String	getAttachment(String key) get attachment by key.
String	getAttachment(String key, String defaultValue) get attachment by key with default value.
Map<String,String>	getAttachments() get attachments.
Throwable	getException() Get exception.
Object	getValue() Get invoke result.
boolean	hasException() Has exception.
Object	recreate() Recreate.
void	setAttachment(String key, String value)
void	setAttachments(Map<String,String> map) Append all items from the map into the attachment, if map is empty then nothing happens
void	setException(Throwable e)
void	setValue(Object value)
<U> CompletableFuture<U>	thenApply(Function<Result,? extends U> fn)
String	toString()
Result	whenCompleteWithContext(BiConsumer<Result,Throwable> fn) Add a callback which can be triggered when the RPC call finishes.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

AppResponse

public AppResponse()

AppResponse

public AppResponse(Object result)

AppResponse

public AppResponse(Throwable exception)

Method Detail

recreate

public Object recreate()
                throws Throwable

Description copied from interface: Result

Recreate.

if (hasException()) { throw getException(); } else { return getValue(); }

Specified by:

recreate in interface Result

Returns:

result.

Throws:

Throwable

getValue

public Object getValue()

Description copied from interface: Result

Get invoke result.

Specified by:

getValue in interface Result

Returns:

result. if no result return null.

setValue

public void setValue(Object value)

Specified by:

setValue in interface Result

getException

public Throwable getException()

Description copied from interface: Result

Get exception.

Specified by:

getException in interface Result

Returns:

exception. if no exception return null.

setException

public void setException(Throwable e)

Specified by:

setException in interface Result

hasException

public boolean hasException()

Description copied from interface: Result

Has exception.

Specified by:

hasException in interface Result

Returns:

has exception.

getAttachments

public Map<String,String> getAttachments()

Description copied from interface: Result

get attachments.

Specified by:

getAttachments in interface Result

Returns:

attachments.

setAttachments

public void setAttachments(Map<String,String> map)

Append all items from the map into the attachment, if map is empty then nothing happens

Specified by:

setAttachments in interface Result

Parameters:

map - contains all key-value pairs to append

addAttachments

public void addAttachments(Map<String,String> map)

Description copied from interface: Result

Add the specified map to existing attachments in this instance.

Specified by:

addAttachments in interface Result

getAttachment

public String getAttachment(String key)

Description copied from interface: Result

get attachment by key.

Specified by:

getAttachment in interface Result

Returns:

attachment value.

getAttachment

public String getAttachment(String key,
                            String defaultValue)

Description copied from interface: Result

get attachment by key with default value.

Specified by:

getAttachment in interface Result

Returns:

attachment value.

setAttachment

public void setAttachment(String key,
                          String value)

Specified by:

setAttachment in interface Result

whenCompleteWithContext

public Result whenCompleteWithContext(BiConsumer<Result,Throwable> fn)

Description copied from interface: Result

Add a callback which can be triggered when the RPC call finishes.

Just as the method name implies, this method will guarantee the callback being triggered under the same context as when the call was started, see implementation in Result.whenCompleteWithContext(BiConsumer)

Specified by:

whenCompleteWithContext in interface Result

Returns:

thenApply

public <U> CompletableFuture<U> thenApply(Function<Result,? extends U> fn)

Specified by:

thenApply in interface Result

get

public Result get()
           throws InterruptedException,
                  ExecutionException

Specified by:

get in interface Result

Throws:

InterruptedException

ExecutionException

get

public Result get(long timeout,
                  TimeUnit unit)
           throws InterruptedException,
                  ExecutionException,
                  TimeoutException

Specified by:

get in interface Result

Throws:

InterruptedException

ExecutionException

TimeoutException

toString

public String toString()

Overrides:

toString in class Object