RayRuntime (ray api 1.10.0 API)

```
public interface RayRuntime
```
Base interface of a Ray runtime.

方法概要

所有方法实例方法抽象方法
限定符和类型	方法和说明
`ObjectRef`	`call(PyFunction pyFunction, Object[] args, CallOptions options)` Invoke a remote Python function.
`ObjectRef`	`call(RayFunc func, Object[] args, CallOptions options)` Invoke a remote function.
`ObjectRef`	`callActor(ActorHandle<?> actor, RayFunc func, Object[] args, CallOptions options)` Invoke a remote function on an actor.
`ObjectRef`	`callActor(PyActorHandle pyActor, PyActorMethod pyActorMethod, Object[] args)` Invoke a remote Python function on an actor.
`PyActorHandle`	`createActor(PyActorClass pyActorClass, Object[] args, ActorCreationOptions options)` Create a Python actor on a remote node.
`<T> ActorHandle<T>`	`createActor(RayFunc actorFactoryFunc, Object[] args, ActorCreationOptions options)` Create an actor on a remote node.
`ConcurrencyGroup`	`createConcurrencyGroup(String name, int maxConcurrency, List<RayFunc> funcs)` Create concurrency group instance at runtime.
`PlacementGroup`	`createPlacementGroup(PlacementGroupCreationOptions creationOptions)` Create a placement group on remote nodes.
`void`	`exitActor()` Intentionally exit the current actor.
`void`	`free(List<ObjectRef<?>> objectRefs, boolean localOnly)` Free a list of objects from Plasma Store.
`<T> List<T>`	`get(List<ObjectRef<T>> objectRefs)` Get a list of objects from the object store.
`<T> List<T>`	`get(List<ObjectRef<T>> objectRefs, long timeoutMs)` Get a list of objects from the object store.
`<T> T`	`get(ObjectRef<T> objectRef)` Get an object from the object store.
`<T> T`	`get(ObjectRef<T> objectRef, long timeoutMs)` Get an object from the object store.
`<T extends BaseActorHandle> Optional<T>`	`getActor(String name, String namespace)` Get a handle to a named actor.
`<T extends BaseActorHandle> T`	`getActorHandle(ActorId actorId)`
`List<PlacementGroup>`	`getAllPlacementGroups()` Get all placement groups in this cluster.
`Object`	`getAsyncContext()`
`Map<String,List<ResourceValue>>`	`getAvailableResourceIds()` Get the resources available on this worker.
`String`	`getNamespace()` Get the namespace of this job.
`PlacementGroup`	`getPlacementGroup(PlacementGroupId id)` Get a placement group by id.
`PlacementGroup`	`getPlacementGroup(String name, String namespace)` Get a placement group by name.
`RuntimeContext`	`getRuntimeContext()`
`void`	`killActor(BaseActorHandle actor, boolean noRestart)` Kill the actor immediately.
`<T> ObjectRef<T>`	`put(T obj)` Store an object in the object store.
`<T> ObjectRef<T>`	`put(T obj, BaseActorHandle owner)` Store an object in the object store, and assign its ownership to owner.
`void`	`removePlacementGroup(PlacementGroupId id)` Remove a placement group by id.
`void`	`setAsyncContext(Object asyncContext)`
`void`	`shutdown()` Shutdown the runtime.
`<T> WaitResult<T>`	`wait(List<ObjectRef<T>> waitList, int numReturns, int timeoutMs, boolean fetchLocal)` Wait for a list of RayObjects to be available, until specified number of objects are ready, or specified timeout has passed.
`boolean`	`waitPlacementGroupReady(PlacementGroupId id, int timeoutSeconds)` Wait for the placement group to be ready within the specified time.
`<T> Callable<T>`	`wrapCallable(Callable<T> callable)` Wrap a `Callable` with necessary context capture.
`Runnable`	`wrapRunnable(Runnable runnable)` Wrap a `Runnable` with necessary context capture.

- 方法详细资料
  - shutdown
```
void shutdown()
```
    Shutdown the runtime.
  - put
```
<T> ObjectRef<T> put(T obj)
```
    Store an object in the object store.
    
    参数:
    
    obj - The Java object to be stored.
    
    返回:
    
    A ObjectRef instance that represents the in-store object.
  - put
```
<T> ObjectRef<T> put(T obj,
                     BaseActorHandle owner)
```
    Store an object in the object store, and assign its ownership to owner. This function is experimental.
    
    参数:
    
    obj - The Java object to be stored.
    
    owner - The actor that should own this object. This allows creating objects with lifetimes decoupled from that of the creating process. Note that the owner actor must be passed a reference to the object prior to the object creator exiting, otherwise the reference will still be lost.
    
    返回:
    
    A ObjectRef instance that represents the in-store object.
  - get
```
<T> T get(ObjectRef<T> objectRef)
```
    Get an object from the object store.
    
    参数:
    
    objectRef - The reference of the object to get.
    
    返回:
    
    The Java object.
  - get
```
<T> List<T> get(List<ObjectRef<T>> objectRefs)
```
    Get a list of objects from the object store.
    
    参数:
    
    objectRefs - The list of object references.
    
    返回:
    
    A list of Java objects.
  - get
```
<T> T get(ObjectRef<T> objectRef,
          long timeoutMs)
```
    Get an object from the object store.
    
    参数:
    
    objectRef - The reference of the object to get.
    
    timeoutMs - The maximum amount of time in millseconds to wait before returning.
    
    返回:
    
    The Java object.
  - get
```
<T> List<T> get(List<ObjectRef<T>> objectRefs,
                long timeoutMs)
```
    Get a list of objects from the object store.
    
    参数:
    
    objectRefs - The list of object references.
    
    timeoutMs - The maximum amount of time in millseconds to wait before returning.
    
    返回:
    
    A list of Java objects.
  - wait
```
<T> WaitResult<T> wait(List<ObjectRef<T>> waitList,
                       int numReturns,
                       int timeoutMs,
                       boolean fetchLocal)
```
    Wait for a list of RayObjects to be available, until specified number of objects are ready, or specified timeout has passed.
    
    参数:
    
    waitList - A list of ObjectRef to wait for.
    
    numReturns - The number of objects that should be returned.
    
    timeoutMs - The maximum time in milliseconds to wait before returning.
    
    fetchLocal - If true, wait for the object to be downloaded onto the local node before returning it as ready. If false, ray.wait() will not trigger fetching of objects to the local node and will return immediately once the object is available anywhere in the cluster.
    
    返回:
    
    Two lists, one containing locally available objects, one containing the rest.
  - free
```
void free(List<ObjectRef<?>> objectRefs,
          boolean localOnly)
```
    Free a list of objects from Plasma Store.
    
    参数:
    
    objectRefs - The object references to free.
    
    localOnly - Whether only free objects for local object store or not.
  - getActorHandle
```
<T extends BaseActorHandle> T getActorHandle(ActorId actorId)
```
  - getActor
```
<T extends BaseActorHandle> Optional<T> getActor(String name,
                                                 String namespace)
```
    Get a handle to a named actor.
    Gets a handle to a named actor with the given name. The actor must have been created with name specified.
    
    参数:
    
    name - The name of the named actor.
    
    namespace - The namespace of the actor.
    
    返回:
    
    ActorHandle to the actor.
  - killActor
```
void killActor(BaseActorHandle actor,
               boolean noRestart)
```
    Kill the actor immediately.
    
    参数:
    
    actor - The actor to be killed.
    
    noRestart - If set to true, the killed actor will not be restarted anymore.
  - call
```
ObjectRef call(RayFunc func,
               Object[] args,
               CallOptions options)
```
    Invoke a remote function.
    
    参数:
    
    func - The remote function to run.
    
    args - The arguments of the remote function.
    
    options - The options for this call.
    
    返回:
    
    The result object.
  - call
```
ObjectRef call(PyFunction pyFunction,
               Object[] args,
               CallOptions options)
```
    Invoke a remote Python function.
    
    参数:
    
    pyFunction - The Python function.
    
    args - Arguments of the function.
    
    options - The options for this call.
    
    返回:
    
    The result object.
  - callActor
```
ObjectRef callActor(ActorHandle<?> actor,
                    RayFunc func,
                    Object[] args,
                    CallOptions options)
```
    Invoke a remote function on an actor.
    
    参数:
    
    actor - A handle to the actor.
    
    func - The remote function to run, it must be a method of the given actor.
    
    args - The arguments of the remote function.
    
    返回:
    
    The result object.
  - callActor
```
ObjectRef callActor(PyActorHandle pyActor,
                    PyActorMethod pyActorMethod,
                    Object[] args)
```
    Invoke a remote Python function on an actor.
    
    参数:
    
    pyActor - A handle to the actor.
    
    pyActorMethod - The actor method.
    
    args - Arguments of the function.
    
    返回:
    
    The result object.
  - createActor
```
<T> ActorHandle<T> createActor(RayFunc actorFactoryFunc,
                               Object[] args,
                               ActorCreationOptions options)
```
    Create an actor on a remote node.
    
    类型参数:
    
    T - The type of the actor object.
    
    参数:
    
    actorFactoryFunc - A remote function whose return value is the actor object.
    
    args - The arguments for the remote function.
    
    options - The options for creating actor.
    
    返回:
    
    A handle to the actor.
  - createActor
```
PyActorHandle createActor(PyActorClass pyActorClass,
                          Object[] args,
                          ActorCreationOptions options)
```
    Create a Python actor on a remote node.
    
    参数:
    
    pyActorClass - The Python actor class.
    
    args - Arguments of the actor constructor.
    
    options - The options for creating actor.
    
    返回:
    
    A handle to the actor.
  - createPlacementGroup
```
PlacementGroup createPlacementGroup(PlacementGroupCreationOptions creationOptions)
```
    Create a placement group on remote nodes.
    
    参数:
    
    creationOptions - Creation options of the placement group.
    
    返回:
    
    A handle to the created placement group.
  - getRuntimeContext
```
RuntimeContext getRuntimeContext()
```
  - getAsyncContext
```
Object getAsyncContext()
```
  - setAsyncContext
```
void setAsyncContext(Object asyncContext)
```
  - wrapRunnable
```
Runnable wrapRunnable(Runnable runnable)
```
    Wrap a Runnable with necessary context capture.
    
    参数:
    
    runnable - The runnable to wrap.
    
    返回:
    
    The wrapped runnable.
  - wrapCallable
```
<T> Callable<T> wrapCallable(Callable<T> callable)
```
    Wrap a Callable with necessary context capture.
    
    参数:
    
    callable - The callable to wrap.
    
    返回:
    
    The wrapped callable.
  - exitActor
```
void exitActor()
```
    Intentionally exit the current actor.
  - getAvailableResourceIds
```
Map<String,List<ResourceValue>> getAvailableResourceIds()
```
    Get the resources available on this worker. Note that this API doesn't work on driver.
    
    返回:
    
    The resource info of one node.
  - getNamespace
```
String getNamespace()
```
    Get the namespace of this job.
  - getPlacementGroup
```
PlacementGroup getPlacementGroup(PlacementGroupId id)
```
    Get a placement group by id.
    
    参数:
    
    id - placement group id.
    
    返回:
    
    The placement group.
  - getPlacementGroup
```
PlacementGroup getPlacementGroup(String name,
                                 String namespace)
```
    Get a placement group by name.
    
    参数:
    
    name - The name of the placement group.
    
    namespace - The namespace of the placement group.
    
    返回:
    
    The placement group.
  - getAllPlacementGroups
```
List<PlacementGroup> getAllPlacementGroups()
```
    Get all placement groups in this cluster.
    
    返回:
    
    All placement groups.
  - removePlacementGroup
```
void removePlacementGroup(PlacementGroupId id)
```
    Remove a placement group by id.
    
    参数:
    
    id - Id of the placement group.
  - waitPlacementGroupReady
```
boolean waitPlacementGroupReady(PlacementGroupId id,
                                int timeoutSeconds)
```
    Wait for the placement group to be ready within the specified time.
    
    参数:
    
    id - Id of placement group.
    
    timeoutSeconds - Timeout in seconds.
    
    返回:
    
    True if the placement group is created. False otherwise.
  - createConcurrencyGroup
```
ConcurrencyGroup createConcurrencyGroup(String name,
                                        int maxConcurrency,
                                        List<RayFunc> funcs)
```
    Create concurrency group instance at runtime.

接口 RayRuntime

方法概要

方法详细资料

shutdown

put

put

get

get

get

get

wait

free

getActorHandle

getActor

killActor

call

call

callActor

callActor

createActor

createActor

createPlacementGroup

getRuntimeContext

getAsyncContext

setAsyncContext

wrapRunnable

wrapCallable

exitActor

getAvailableResourceIds

getNamespace

getPlacementGroup

getPlacementGroup

getAllPlacementGroups

removePlacementGroup

waitPlacementGroupReady

createConcurrencyGroup