co.stateful

Class Atomic<T>

java.lang.Object

co.stateful.Atomic<T>

All Implemented Interfaces:

Callable<T>

@Loggable(value=1)
public final class Atomic<T>
extends Object
implements Callable<T>

Atomic block of code.

This class runs your Callable in a concurrent thread-safe manner, using a lock from Stateful.co. For example:

 Callable<String> origin = new Callable<String>() {
   @Override
   public String call() {
     // fetch it from a thread-critical resource
     // and return
   }
 };
 Lock lock = new RtSttc(new URN("urn:github:12345"), "token")
   .locks().lock("test");
 String result = new Atomic<String>(origin, lock).call();

If you want to use Runnable instead, try static method Executors.callable(Runnable). If you want to avoid checked exceptions, use callQuietly().

Since:

0.6

Version:

$Id$

Author:

Yegor Bugayenko (yegor@tpc2.com)

Constructor Summary

Constructors

Constructor and Description
Atomic(Callable<T> clbl, Lock lck) Public ctor (default maximum waiting time of five minutes).
Atomic(Callable<T> clbl, Lock lck, long maximum) Public ctor.

Method Summary

Methods

Modifier and Type	Method and Description
T	call()
T	callQuietly() Call without exception throwing.

Methods inherited from class java.lang.Object

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

Constructor Detail

Atomic

public Atomic(Callable<T> clbl,
      Lock lck)

Public ctor (default maximum waiting time of five minutes).

Parameters:

clbl - Callable to use

lck - Lock to use

Atomic

public Atomic(Callable<T> clbl,
      Lock lck,
      long maximum)

Public ctor.

Parameters:

clbl - Callable to use

lck - Lock to use

maximum - Maximum waiting time

Since:

0.8

Method Detail

call

public T call()
       throws Exception

Specified by:

call in interface Callable<T>

Throws:

Exception

callQuietly

public T callQuietly()

Call without exception throwing.

Returns:

Result

Since:

0.9