Class UnaryCallable<RequestT,ResponseT> (2.8.1)
- 2.72.2 (latest)
- 2.72.1
- 2.71.0
- 2.70.3
- 2.69.0
- 2.68.2
- 2.67.0
- 2.66.0
- 2.65.0
- 2.63.1
- 2.62.0
- 2.61.0
- 2.60.0
- 2.59.1
- 2.58.0
- 2.57.0
- 2.55.0
- 2.54.1
- 2.53.0
- 2.52.0
- 2.51.0
- 2.50.0
- 2.49.0
- 2.48.1
- 2.47.0
- 2.46.1
- 2.45.0
- 2.43.0
- 2.42.0
- 2.41.0
- 2.39.0
- 2.38.0
- 2.37.0
- 2.36.0
- 2.35.0
- 2.34.1
- 2.33.0
- 2.32.1
- 2.31.1
- 2.30.1
- 2.24.0
- 2.23.3
- 2.22.0
- 2.21.0
- 2.20.1
- 2.19.6
- 2.18.7
- 2.17.0
- 2.16.0
- 2.15.0
- 2.14.0
- 2.13.0
- 2.12.2
- 2.11.0
- 2.10.0
- 2.9.0
- 2.8.1
- 2.7.1
publicabstractclassUnaryCallable<RequestT,ResponseT>A UnaryCallable is an immutable object which is capable of making RPC calls to non-streaming API methods.
In typical usage, the request to send to the remote service will not be bound to the UnaryCallable, but instead is provided at call time, which allows for a UnaryCallable to be saved and used indefinitely.
There are two styles of calls that can be made through a UnaryCallable: synchronous and asynchronous.
Synchronous example:
RequestTyperequest=RequestType.newBuilder().build();UnaryCallableAsynchronous example:
RequestTyperequest=RequestType.newBuilder().build();UnaryCallableIt is considered advanced usage for a user to create a UnaryCallable themselves. This class is intended to be created by a generated client class, and configured by instances of UnaryCallSettings.Builder which are exposed through the client settings class.
Inherited Members
Type Parameters
| Name | Description |
| RequestT | |
| ResponseT |
Constructors
UnaryCallable()
protectedUnaryCallable()Methods
call(RequestT request)
publicResponseTcall(RequestTrequest)Same as#call(Object, ApiCallContext), with a null context.
| Name | Description |
| request | RequestTThe request to send to the service. |
| Type | Description |
| ResponseT | the call result |
call(RequestT request, ApiCallContext context)
publicResponseTcall(RequestTrequest,ApiCallContextcontext)Perform a call synchronously.
| Name | Description |
| request | RequestTThe request to send to the service. |
| context | ApiCallContextApiCallContext to make the call with |
| Type | Description |
| ResponseT | the call result |
futureCall(RequestT request)
publicApiFuture<ResponseT>futureCall(RequestTrequest)Same as#futureCall(Object, ApiCallContext), with a null context.
| Name | Description |
| request | RequestTrequest |
| Type | Description |
| com.google.api.core.ApiFuture<ResponseT> | ApiFuture for the call result |
futureCall(RequestT request, ApiCallContext context)
publicabstractApiFuture<ResponseT>futureCall(RequestTrequest,ApiCallContextcontext)Perform a call asynchronously.
| Name | Description |
| request | RequestT |
| context | ApiCallContextApiCallContext to make the call with |
| Type | Description |
| com.google.api.core.ApiFuture<ResponseT> | ApiFuture for the call result |
withDefaultCallContext(ApiCallContext defaultCallContext)
publicUnaryCallable<RequestT,ResponseT>withDefaultCallContext(ApiCallContextdefaultCallContext)Returns a newUnaryCallable with anApiCallContext that is used as a default when none is supplied in individual calls.
| Name | Description |
| defaultCallContext | ApiCallContextthe defaultApiCallContext. |
| Type | Description |
| UnaryCallable<RequestT,ResponseT> |
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-12-17 UTC.