README.md

Exclutor

Implementation of exclusive-able asynchronous process

example case: we need multiple asynchronous process to read data from database, but only one asynchronouse process for write data to database and the next read process will on hold till the write process finish.

Status

Usage

Adding dependency

maven

<repositories>
    <repository>
        <id>krybrig-repository-public</id>
        <name>mvn.kry.ovh</name>
        <url>https://mvn.kry.ovh/public</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
	<groupId>org.krybrig</groupId>
	<artifactId>exclutor-core</artifactId>
	<version>1.3.1</version>
    </dependency>
    <dependency>
	<groupId>org.krybrig</groupId>
	<artifactId>exclutor-rx</artifactId>
	<version>1.3.1</version>
    </dependency>
</dependencies>

gradle

repositories {
    maven {
        url "https://app.krybrig.org/maven/repository/public"
    }
}

dependencies {
    compile 'org.krybrig:exclutor-core:1.3.0'
    compile 'org.krybrig:exclutor-rx:1.3.0'
}

Notes:

• change exclutor-rx to version 1.2.2 if still want to use rxjava2

Code

Java Executor

String scope = "db.table.users";
Executor executor = ExclusiveExecutorFactory.create(Runtime.getRuntime().availableProcessors());
executor.execute(new AbstractExclusiveRunnable(scope, true) {
    @Override
    public void run() {
        // insert to database
    }
});
executor.execute(new AbstractExclusiveRunnable(scope, false) {
    @Override
    public void run() {
        // select from database
    }
});

Java Executor Service

String scope = "db.table.users";
ExecutorService service = ExclusiveExecutorFactory.createExecutorService(Runtime.getRuntime().availableProcessors());
service.submit(new AbstractExclusiveRunnable(scope, true) {
    @Override
    public void run() {
        // insert to database
    }
});
service.submit(new AbstractExclusiveRunnable(scope, false) {
    @Override
    public void run() {
        // select from database
    }
});

RxJava

ExclusiveSchedulerFactory schedulerFactory = new ExclusiveSchedulerFactory(Runtime.getRuntime().availableProcessors());
Flowable.range(0, 100)
    .observeOn(schedulerFactory.createScheduler(scope, false))
    .doOnNext(new Consumer<Integer>() {
        @Override
        public void accept(Integer index) throws Exception {
            // select from db
        }
    })
    .observeOn(schedulerFactory.createScheduler(scope, true))
    .doOnNext(new Consumer<Integer>() {
        @Override
        public void accept(Integer index) throws Exception {
            // insert to db
        }
    })
    .subscribe();

Build

mvn compile
mvn package
mvn install