Sinobu

Scheduling tasks to run at specific times or intervals is a common requirement. Sinobu provides a simple yet powerful mechanism for this, based on the well-known Cron expression format. It integrates seamlessly with Sinobu's reactive streams.

✨ Simple API

Schedule tasks with a single static method call: I#schedule(String). No complex setup or scheduler instances needed.

void scheduling() {
    I.schedule(() -> {
        // execute your job immediately on job thread
    });

    I.schedule("0 0 * * *").to(() -> {
        // execute your job regularly on job thread
    });
}

🗓️ Cron Expression Syntax

Define complex schedules using the standard Cron format, specifying minutes, hours, days, months, and weekdays. Sinobu supports standard fields and special characters like *, /, -, ,, L, W, #, ?, and the randomizer R.

🔄 Reactive Integration

Scheduled events are delivered as a Signal, allowing you to use reactive operators for flow control (e.g., take), transformation, and lifecycle management (Disposable).

You can use I#schedule(String) to schedule jobs by cron expression.

void scheduling() {
    I.schedule("0 0 * * *").to(() -> {
        // execute your job
    });
}

To stop continuous task scheduling, execute the return value Disposable.

void stopScheduling() {
    Disposable disposer = I.schedule("0 0 * * *").to(() -> {
        // execute your job
    });

    // stop scheduling
    disposer.dispose();
}

Since the return value is Signal, it is easy to stop after five executions.

void stopSchedulingAfter5Executions() {
    I.schedule("0 0 * * *").take(5).to(() -> {
        // execute your job
    });
}

A Cron expression consists of five or six fields, separated by spaces. From left to right, they represent seconds, minutes, hours, days, months, and days of the week, with seconds being optional. The possible values for each field are as follows, and some special function characters can also be used.

If you want to specify 9:00 every morning, it would look like this

0 0 9 * * *

Seconds field is optional and can be omitted.

0 9 * * *

In addition to numbers, each field can contain characters with special meanings and functions.

Complex time specifications can be made by combining several special characters as follows