bayou.async

Class FiberLocal<T>

java.lang.Object

bayou.async.FiberLocal<T>

public class FiberLocal<T>
extends Object

A fiber-local variable. This class is an analogue of `ThreadLocal`.

Example usage:

     static final FiberLocal<User> fiberLocalUser = new FiberLocal<>();

     Async<Void> action1()
     {
         fiberLocalUser.set(user);
         return Fiber.sleep(Duration.ofSeconds(1))
             .then( v->action2() );
     }
     Async<Void> action2()
     {
         User user = fiberLocalUser.get();
         ...
     }
 

The initial fiber-local value of a FiberLocal is always null.

Constructor Summary

Constructors

Constructor and Description
FiberLocal() Create a FiberLocal variable.

Method Summary

Instance Methods
T	get() Get the fiber-local value for this variable.
void	set(T value) Set the fiber-local value for this variable.

Methods inherited from class java.lang.Object

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

Constructor Detail

FiberLocal

public FiberLocal()

Create a FiberLocal variable. The result object is usually assigned to a static final variable.

Method Detail

get

public T get()
      throws IllegalStateException

Get the fiber-local value for this variable.

The initial fiber-local value, before any set() calls, is null.

Throws:

IllegalStateException - if `Fiber.current()==null`

set

public void set(T value)
         throws IllegalStateException

Set the fiber-local value for this variable.

Throws:

IllegalStateException - if `Fiber.current()==null`