io.grpc

Class Context.CancellableContext

java.lang.Object

io.grpc.Context

io.grpc.Context.CancellableContext

Enclosing class:

Context

public static final class Context.CancellableContext
extends Context

A context which inherits cancellation from its parent but which can also be independently cancelled and which will propagate cancellation to its descendants.

Nested Class Summary

Nested classes/interfaces inherited from class io.grpc.Context

Context.CancellableContext, Context.CancellationListener, Context.Key<T>

Field Summary

Fields inherited from class io.grpc.Context

ROOT

Method Summary

Modifier and Type	Method and Description
Context	attach() Attach this context to the thread and make it Context.current(), the previously current context is returned.
Closeable	attachAsCloseable() Attach this context to the thread and return a AutoCloseable that can be used with try-with-resource statements to properly attach the previously bound context when AutoCloseable.close() is called.
boolean	cancel(Throwable cause) Cancel this context and optionally provide a cause for the cancellation.
Throwable	cause() If a context Context.isCancelled() then return the cause of the cancellation or null if context was cancelled without a cause.
void	detach(Context toAttach) Detach the current context from the thread and attach the provided replacement.
void	detachAndCancel(Context toAttach, Throwable cause) Cancel this context and detach it as the current context from the thread.
boolean	isCancelled() Is this context cancelled.
boolean	isCurrent()

Methods inherited from class io.grpc.Context

addListener, current, fork, key, keyWithDefault, propagate, removeListener, withCancellation, withDeadlineAfter, withDeadlineNanoTime, withValue, withValues, withValues, wrap, wrap, wrap

Methods inherited from class java.lang.Object

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

Method Detail

attach

public Context attach()

Description copied from class: Context

Attach this context to the thread and make it Context.current(), the previously current context is returned. It is allowed to attach contexts where Context.isCancelled() is true.

Overrides:

attach in class Context

detach

public void detach(Context toAttach)

Description copied from class: Context

Detach the current context from the thread and attach the provided replacement. If this context is not Context.current() a SEVERE message will be logged but the context to attach will still be bound.

Overrides:

detach in class Context

isCurrent

public boolean isCurrent()

attachAsCloseable

public Closeable attachAsCloseable()

Attach this context to the thread and return a AutoCloseable that can be used with try-with-resource statements to properly attach the previously bound context when AutoCloseable.close() is called.

Returns:

a Closeable which can be used with try-with-resource blocks.

cancel

public boolean cancel(@Nullable
                      Throwable cause)

Cancel this context and optionally provide a cause for the cancellation. This will trigger notification of listeners.

Returns:

true if this context cancelled the context and notified listeners, false if the context was already cancelled.

detachAndCancel

public void detachAndCancel(Context toAttach,
                            @Nullable
                            Throwable cause)

Cancel this context and detach it as the current context from the thread.

Parameters:

toAttach - context to make current.

cause - of cancellation, can be null.

isCancelled

public boolean isCancelled()

Description copied from class: Context

Is this context cancelled.

Overrides:

isCancelled in class Context

cause

@Nullable
public Throwable cause()

Description copied from class: Context

If a context Context.isCancelled() then return the cause of the cancellation or null if context was cancelled without a cause. If the context is not yet cancelled will always return null.

The cause is provided for informational purposes only and implementations should generally assume that it has already been handled and logged properly.

Overrides:

cause in class Context