org.apache.beam.vendor.grpc.v1p48p1.io.grpc.internal

类 SharedResourceHolder

java.lang.Object

org.apache.beam.vendor.grpc.v1p48p1.io.grpc.internal.SharedResourceHolder

@ThreadSafe
public final class SharedResourceHolder
extends Object

A holder for shared resource singletons.

Components like client channels and servers need certain resources, e.g. a thread pool, to run. If the user has not provided such resources, these components will use a default one, which is shared as a static resource. This class holds these default resources and manages their life-cycles.

A resource is identified by the reference of a SharedResourceHolder.Resource object, which is typically a singleton, provided to the get() and release() methods. Each Resource object (not its class) maps to an object cached in the holder.

Resources are ref-counted and shut down after a delay when the ref-count reaches zero.

嵌套类概要

嵌套类

限定符和类型	类和说明
static interface	SharedResourceHolder.Resource<T> Defines a resource, and the way to create and destroy instances of it.

方法概要

限定符和类型	方法和说明
static <T> T	get(SharedResourceHolder.Resource<T> resource) Try to get an existing instance of the given resource.
static <T> T	release(SharedResourceHolder.Resource<T> resource, T instance) Releases an instance of the given resource.

从类继承的方法 java.lang.Object

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

方法详细资料

get

public static <T> T get(SharedResourceHolder.Resource<T> resource)

Try to get an existing instance of the given resource. If an instance does not exist, create a new one with the given factory.

参数:

resource - the singleton object that identifies the requested static resource

release

public static <T> T release(SharedResourceHolder.Resource<T> resource,
                            T instance)

Releases an instance of the given resource.

The instance must have been obtained from get(Resource). Otherwise will throw IllegalArgumentException.

Caller must not release a reference more than once. It's advisory that you clear the reference to the instance with the null returned by this method.

参数:

resource - the singleton Resource object that identifies the released static resource

instance - the released static resource

返回:

a null which the caller can use to clear the reference to that instance.