CallOptions (grpc-all 1.0.1 API)

java.lang.Object
- io.grpc.CallOptions

```
@Immutable
public final class CallOptions
extends Object
```
The collection of runtime options for a new RPC call.
A field that is not set is null.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class CallOptions.Key<T>

Nested Classes
Modifier and Type	Class and Description
`static class`	`CallOptions.Key<T>`

Field Summary

Fields
Modifier and Type Field and Description

static CallOptions DEFAULT
A blank CallOptions that all fields are not set.

Fields
Modifier and Type	Field and Description
`static CallOptions`	`DEFAULT` A blank `CallOptions` that all fields are not set.

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`Attributes`	`getAffinity()` Returns the attributes for affinity-based routing.
`String`	`getAuthority()` Override the HTTP/2 authority the channel claims to be connecting to.
`String`	`getCompressor()` Returns the compressor's name.
`CallCredentials`	`getCredentials()` Returns the call credentials.
`Deadline`	`getDeadline()` Returns the deadline or `null` if the deadline is not set.
`Long`	`getDeadlineNanoTime()` Deprecated. Use `getDeadline()` instead.
`Executor`	`getExecutor()`
`<T> T`	`getOption(CallOptions.Key<T> key)` Get the value for a custom option or its inherent default.
`boolean`	`isWaitForReady()` Returns whether 'wait for ready' option is enabled for the call.
`String`	`toString()`
`CallOptions`	`withAffinity(Attributes affinity)` Returns a new `CallOptions` with attributes for affinity-based routing.
`CallOptions`	`withAuthority(String authority)` Override the HTTP/2 authority the channel claims to be connecting to.
`CallOptions`	`withCallCredentials(CallCredentials credentials)` Returns a new `CallOptions` with the given call credentials.
`CallOptions`	`withCompression(String compressorName)` Sets the compression to use for the call.
`CallOptions`	`withDeadline(Deadline deadline)` Returns a new `CallOptions` with the given absolute deadline.
`CallOptions`	`withDeadlineAfter(long duration, TimeUnit unit)` Returns a new `CallOptions` with a deadline that is after the given `duration` from now.
`CallOptions`	`withDeadlineNanoTime(Long deadlineNanoTime)` Deprecated. Use `withDeadline(Deadline)` instead.
`CallOptions`	`withExecutor(Executor executor)` Returns a new `CallOptions` with `executor` to be used instead of the default executor specified with `ManagedChannelBuilder.executor(java.util.concurrent.Executor)`.
`<T> CallOptions`	`withOption(CallOptions.Key<T> key, T value)` Sets a custom option.
`CallOptions`	`withoutWaitForReady()` Disables 'wait for ready' feature for the call.
`CallOptions`	`withWaitForReady()` Enables 'wait for ready' feature for the call.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - DEFAULT
```
public static final CallOptions DEFAULT
```
    A blank CallOptions that all fields are not set.
- Method Detail
  - withAuthority
```
@ExperimentalApi(value="https://github.com/grpc/grpc-java/issues/1767")
public CallOptions withAuthority(@Nullable
                                                                                                         String authority)
```
    Override the HTTP/2 authority the channel claims to be connecting to. This is not generally safe. Overriding allows advanced users to re-use a single Channel for multiple services, even if those services are hosted on different domain names. That assumes the server is virtually hosting multiple domains and is guaranteed to continue doing so. It is rare for a service provider to make such a guarantee. At this time, there is no security verification of the overridden value, such as making sure the authority matches the server's TLS certificate.
  - withCallCredentials
```
@ExperimentalApi(value="https//github.com/grpc/grpc-java/issues/1914")
public CallOptions withCallCredentials(@Nullable
                                                                                                              CallCredentials credentials)
```
    Returns a new CallOptions with the given call credentials.
  - withCompression
```
@ExperimentalApi(value="https://github.com/grpc/grpc-java/issues/1704")
public CallOptions withCompression(@Nullable
                                                                                                           String compressorName)
```
    Sets the compression to use for the call. The compressor must be a valid name known in the CompressorRegistry.
  - withDeadline
```
public CallOptions withDeadline(@Nullable
                                Deadline deadline)
```
    Returns a new CallOptions with the given absolute deadline.
    This is mostly used for propagating an existing deadline. withDeadlineAfter(long, java.util.concurrent.TimeUnit) is the recommended way of setting a new deadline,
    
    Parameters:
    
    deadline - the deadline or null for unsetting the deadline.
  - withDeadlineNanoTime
```
@Deprecated
public CallOptions withDeadlineNanoTime(@Nullable
                                                    Long deadlineNanoTime)
```
    Deprecated. Use withDeadline(Deadline) instead.
    
    Returns a new CallOptions with the given absolute deadline in nanoseconds in the clock as per System.nanoTime().
    This is mostly used for propagating an existing deadline. withDeadlineAfter(long, java.util.concurrent.TimeUnit) is the recommended way of setting a new deadline,
    
    Parameters:
    
    deadlineNanoTime - the deadline in the clock as per System.nanoTime(). null for unsetting the deadline.
  - withDeadlineAfter
```
public CallOptions withDeadlineAfter(long duration,
                                     TimeUnit unit)
```
    Returns a new CallOptions with a deadline that is after the given duration from now.
  - getDeadlineNanoTime
```
@Deprecated
public Long getDeadlineNanoTime()
```
    Deprecated. Use getDeadline() instead.
    
    Returns the deadline in nanoseconds in the clock as per System.nanoTime(). null if the deadline is not set.
  - getDeadline
```
@Nullable
public Deadline getDeadline()
```
    Returns the deadline or null if the deadline is not set.
  - withAffinity
```
@ExperimentalApi(value="https://github.com/grpc/grpc-java/issues/1766")
public CallOptions withAffinity(Attributes affinity)
```
    Returns a new CallOptions with attributes for affinity-based routing.
  - withWaitForReady
```
@ExperimentalApi(value="https://github.com/grpc/grpc-java/issues/1915")
public CallOptions withWaitForReady()
```
    Enables 'wait for ready' feature for the call. 'Fail fast' is the default option for gRPC calls and 'wait for ready' is the opposite to it.
  - withoutWaitForReady
```
@ExperimentalApi(value="https://github.com/grpc/grpc-java/issues/1915")
public CallOptions withoutWaitForReady()
```
    Disables 'wait for ready' feature for the call. This method should be rarely used because the default is without 'wait for ready'.
  - getAffinity
```
@ExperimentalApi(value="https://github.com/grpc/grpc-java/issues/1766")
public Attributes getAffinity()
```
    Returns the attributes for affinity-based routing.
  - getCompressor
```
@ExperimentalApi(value="https://github.com/grpc/grpc-java/issues/1704")
 @Nullable
public String getCompressor()
```
    Returns the compressor's name.
  - getAuthority
```
@Nullable
 @ExperimentalApi(value="https://github.com/grpc/grpc-java/issues/1767")
public String getAuthority()
```
    Override the HTTP/2 authority the channel claims to be connecting to. This is not generally safe. Overriding allows advanced users to re-use a single Channel for multiple services, even if those services are hosted on different domain names. That assumes the server is virtually hosting multiple domains and is guaranteed to continue doing so. It is rare for a service provider to make such a guarantee. At this time, there is no security verification of the overridden value, such as making sure the authority matches the server's TLS certificate.
  - getCredentials
```
@ExperimentalApi(value="https//github.com/grpc/grpc-java/issues/1914")
 @Nullable
public CallCredentials getCredentials()
```
    Returns the call credentials.
  - withExecutor
```
public CallOptions withExecutor(Executor executor)
```
    Returns a new CallOptions with executor to be used instead of the default executor specified with ManagedChannelBuilder.executor(java.util.concurrent.Executor).
  - withOption
```
@ExperimentalApi(value="https://github.com/grpc/grpc-java/issues/1869")
public <T> CallOptions withOption(CallOptions.Key<T> key,
                                                                                                          T value)
```
    Sets a custom option. Any existing value for the key is overwritten.
    
    Parameters:
    
    key - The option key
    
    value - The option value.
  - getOption
```
@ExperimentalApi(value="https://github.com/grpc/grpc-java/issues/1869")
public <T> T getOption(CallOptions.Key<T> key)
```
    Get the value for a custom option or its inherent default.
    
    Parameters:
    
    key - Key identifying option
  - getExecutor
```
@Nullable
public Executor getExecutor()
```
  - isWaitForReady
```
@ExperimentalApi(value="https://github.com/grpc/grpc-java/issues/1915")
public boolean isWaitForReady()
```
    Returns whether 'wait for ready' option is enabled for the call. 'Fail fast' is the default option for gRPC calls and 'wait for ready' is the opposite to it.
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class CallOptions

Nested Class Summary

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DEFAULT

Method Detail

withAuthority

withCallCredentials

withCompression

withDeadline

withDeadlineNanoTime

withDeadlineAfter

getDeadlineNanoTime

getDeadline

withAffinity

withWaitForReady

withoutWaitForReady

getAffinity

getCompressor

getAuthority

getCredentials

withExecutor

withOption

getOption

getExecutor

isWaitForReady

toString