Actors (kontraktor 3.00 API)

java.lang.Object
- org.nustaq.kontraktor.Actors

Direct Known Subclasses:

Actor
```
public class Actors
extends Object
```
Copyright (c) 2012, Ruediger Moeller. All rights reserved. This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA Date: 04.01.14 Time: 19:50 A set of static async helper methods. Note Actor inherits from this class.

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`CONT` use value as error to indicate more messages are to come (else remoting will close channel).
`static int`	`DEFAULT_TIMOUT`
`static java.util.function.Supplier<Scheduler>`	`defaultScheduler`
`static Timer`	`delayedCalls`
`static ThreadPoolExecutor`	`exec`
`static String`	`FIN` use this value to signal no more messages.
`static String`	`FINSILENT` use value to signal no more messages.
`static ActorsImpl`	`instance`
`static int`	`MAX_EXTERNAL_THREADS_POOL_SIZE`

Constructor Summary

Constructors
Constructor and Description

Actors()

Constructors
Constructor and Description
`Actors()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`AddDeadLetter(String s)`
`static <T> IPromise<IPromise<T>[]>`	`all(IPromise<T>... futures)` similar to es6 Promise.all method, however non-IPromise objects are not allowed returns a future which is settled once all promises provided are settled
`static <T> IPromise<List<IPromise<T>>>`	`all(List<IPromise<T>> futures)` similar to es6 Promise.all method, however non-IPromise objects are not allowed returns a future which is settled once all promises provided are settled
`static <T extends Actor> T`	`AsActor(Class<T> actorClazz)` create an new actor.
`static <T extends Actor> T`	`AsActor(Class<T> actorClazz, int qSize)` create an new actor.
`static <T extends Actor> T`	`AsActor(Class<T> actorClazz, Scheduler scheduler)` create an new actor dispatched in the given DispatcherThread
`static <T extends Actor> T`	`AsActor(Class<T> actorClazz, Scheduler scheduler, int qsize)` create an new actor dispatched in the given DispatcherThread
`static <T> java.util.stream.Stream<T>`	`awaitAll(IPromise<T>... futures)` await until all futures are settled and stream their results.
`static <T> java.util.stream.Stream<T>`	`awaitAll(List<IPromise<T>> futures)`
`static <T> java.util.stream.Stream<T>`	`awaitAll(long timeoutMS, IPromise<T>... futures)` await until all futures are settled and stream their results
`static <T> java.util.stream.Stream<T>`	`awaitAll(long timeoutMS, List<IPromise<T>> futures)`
`static IPromise`	`complete()` abbreviation for Promise creation to make code more concise
`static <T> IPromise<T>`	`complete(T res, Object err)` abbreviation for Promise creation to make code more concise
`static ConcurrentLinkedQueue<String>`	`DeadLetters()` messages that have been dropped or have been sent to stopped actors
`static <T> T`	`InThread(T anInterface)` in case called from an actor, wraps the given interface instance into a proxy such that all calls on the interface get scheduled on the calling actors thread (avoids accidental multithreading when handing out callback/listener interfaces from an actor) if called from outside an actor thread, NOP
`static boolean`	`isCont(Object o)` helper to check for "special" error objects.
`static boolean`	`isError(Object o)` helper to check for "special" error objects.
`static boolean`	`isFinal(Object error)` return if given error Object signals end of callback stream
`static boolean`	`isResult(Object error)`
`static boolean`	`isSilentFinal(Object o)` helper to check for "special" error objects.
`static <T> IPromise<T>`	`race(Collection<IPromise<T>> futures)` similar to es6 Promise.race method, however non-IPromise objects are not allowed returns a future which is settled once one of the futures provided gets settled
`static <T> IPromise<T>`	`race(IPromise<T>... futures)` similar to es6 Promise.race method, however non-IPromise objects are not allowed returns a future which is settled once one of the futures provided gets settled
`static <T> IPromise<T>`	`reject(Object err)` abbreviation for Promise creation to make code more concise
`static IPromise`	`resolve()` abbreviation for Promise creation to make code more concise
`static <T> IPromise<T>`	`resolve(T res)` abbreviation for Promise creation to make code more concise
`static <T> java.util.stream.Stream<T>`	`stream(T... t)` utility addition to java 8 streams
`static void`	`SubmitDelayed(long millis, Runnable task)` utility function.
`static void`	`yield()` processes messages from mailbox / callbackqueue until no messages are left NOP if called from non actor thread.
`static void`	`yield(long timeout)` process messages on the mailbox/callback queue until timeout is reached.

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

- Field Detail
  - MAX_EXTERNAL_THREADS_POOL_SIZE
```
public static int MAX_EXTERNAL_THREADS_POOL_SIZE
```
  - DEFAULT_TIMOUT
```
public static int DEFAULT_TIMOUT
```
  - exec
```
public static ThreadPoolExecutor exec
```
  - instance
```
public static ActorsImpl instance
```
  - delayedCalls
```
public static Timer delayedCalls
```
  - defaultScheduler
```
public static java.util.function.Supplier<Scheduler> defaultScheduler
```
  - FINSILENT
```
public static final String FINSILENT
```
    use value to signal no more messages. THE RECEIVER CALLBACK WILL NOT SEE THIS MESSAGE.
    
    See Also:
    
    Constant Field Values
  - CONT
```
public static final String CONT
```
    use value as error to indicate more messages are to come (else remoting will close channel).
    
    See Also:
    
    Constant Field Values
  - FIN
```
public static final String FIN
```
    use this value to signal no more messages. The receiver callback will complete the message. Note that any value except CONT will also close the callback channel. So this is informal.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - Actors
```
public Actors()
```
- Method Detail
  - isFinal
```
public static boolean isFinal(Object error)
```
    return if given error Object signals end of callback stream
    
    Parameters:
    
    error -
    
    Returns:
  - isSilentFinal
```
public static boolean isSilentFinal(Object o)
```
    helper to check for "special" error objects.
    
    Parameters:
    
    o -
    
    Returns:
  - isCont
```
public static boolean isCont(Object o)
```
    helper to check for "special" error objects.
    
    Parameters:
    
    o -
    
    Returns:
  - isResult
```
public static boolean isResult(Object error)
```
  - isError
```
public static boolean isError(Object o)
```
    helper to check for "special" error objects.
    
    Parameters:
    
    o -
    
    Returns:
  - SubmitDelayed
```
public static void SubmitDelayed(long millis,
                                 Runnable task)
```
    utility function. Executed in foreign thread. Use Actor::delayed() to have the runnable executed inside actor thread
  - AddDeadLetter
```
public static void AddDeadLetter(String s)
```
  - InThread
```
public static <T> T InThread(T anInterface)
```
    in case called from an actor, wraps the given interface instance into a proxy such that all calls on the interface get scheduled on the calling actors thread (avoids accidental multithreading when handing out callback/listener interfaces from an actor) if called from outside an actor thread, NOP
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    anInterface -
    
    Returns:
  - DeadLetters
```
public static ConcurrentLinkedQueue<String> DeadLetters()
```
    messages that have been dropped or have been sent to stopped actors
    
    Returns:
    
    queue of dead letters. Note: only strings are recorded to avoid accidental references.
  - AsActor
```
public static <T extends Actor> T AsActor(Class<T> actorClazz)
```
    create an new actor. If this is called outside an actor, a new DispatcherThread will be scheduled. If called from inside actor code, the new actor will share the thread+queue with the caller.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    actorClazz -
    
    Returns:
  - AsActor
```
public static <T extends Actor> T AsActor(Class<T> actorClazz,
                                          int qSize)
```
    create an new actor. If this is called outside an actor, a new DispatcherThread will be scheduled. If called from inside actor code, the new actor will share the thread+queue with the caller.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    actorClazz -
    
    Returns:
  - AsActor
```
public static <T extends Actor> T AsActor(Class<T> actorClazz,
                                          Scheduler scheduler)
```
    create an new actor dispatched in the given DispatcherThread
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    actorClazz -
    
    Returns:
  - AsActor
```
public static <T extends Actor> T AsActor(Class<T> actorClazz,
                                          Scheduler scheduler,
                                          int qsize)
```
    create an new actor dispatched in the given DispatcherThread
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    actorClazz -
    
    Returns:
  - all
```
public static <T> IPromise<IPromise<T>[]> all(IPromise<T>... futures)
```
    similar to es6 Promise.all method, however non-IPromise objects are not allowed returns a future which is settled once all promises provided are settled
  - all
```
public static <T> IPromise<List<IPromise<T>>> all(List<IPromise<T>> futures)
```
    similar to es6 Promise.all method, however non-IPromise objects are not allowed returns a future which is settled once all promises provided are settled
  - awaitAll
```
public static <T> java.util.stream.Stream<T> awaitAll(long timeoutMS,
                                                      IPromise<T>... futures)
```
    await until all futures are settled and stream their results
  - awaitAll
```
public static <T> java.util.stream.Stream<T> awaitAll(IPromise<T>... futures)
```
    await until all futures are settled and stream their results. Uses Actors.DEFAULT_TIMEOUT
  - awaitAll
```
public static <T> java.util.stream.Stream<T> awaitAll(List<IPromise<T>> futures)
```
  - awaitAll
```
public static <T> java.util.stream.Stream<T> awaitAll(long timeoutMS,
                                                      List<IPromise<T>> futures)
```
  - race
```
public static <T> IPromise<T> race(IPromise<T>... futures)
```
    similar to es6 Promise.race method, however non-IPromise objects are not allowed returns a future which is settled once one of the futures provided gets settled
  - race
```
public static <T> IPromise<T> race(Collection<IPromise<T>> futures)
```
    similar to es6 Promise.race method, however non-IPromise objects are not allowed returns a future which is settled once one of the futures provided gets settled
  - stream
```
public static <T> java.util.stream.Stream<T> stream(T... t)
```
    utility addition to java 8 streams
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    t -
    
    Returns:
  - resolve
```
public static <T> IPromise<T> resolve(T res)
```
    abbreviation for Promise creation to make code more concise
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    res -
    
    Returns:
  - reject
```
public static <T> IPromise<T> reject(Object err)
```
    abbreviation for Promise creation to make code more concise
  - complete
```
public static <T> IPromise<T> complete(T res,
                                       Object err)
```
    abbreviation for Promise creation to make code more concise
  - complete
```
public static IPromise complete()
```
    abbreviation for Promise creation to make code more concise
  - resolve
```
public static IPromise resolve()
```
    abbreviation for Promise creation to make code more concise
  - yield
```
public static void yield()
```
    processes messages from mailbox / callbackqueue until no messages are left NOP if called from non actor thread.
  - yield
```
public static void yield(long timeout)
```
    process messages on the mailbox/callback queue until timeout is reached. In case timeout is 0, process until mailbox+callback queue is empty. If called from a non-actor thread, either sleep until timeout or (if timeout == 0) its a NOP.
    
    Parameters:
    
    timeout -

Class Actors

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

MAX_EXTERNAL_THREADS_POOL_SIZE

DEFAULT_TIMOUT

exec

instance

delayedCalls

defaultScheduler

FINSILENT

CONT

FIN

Constructor Detail

Actors

Method Detail

isFinal

isSilentFinal

isCont

isResult

isError

SubmitDelayed

AddDeadLetter

InThread

DeadLetters

AsActor

AsActor

AsActor

AsActor

all

all

awaitAll

awaitAll

awaitAll

awaitAll

race

race

stream

resolve

reject

complete

complete

resolve

yield

yield