Actions & Conditions

📃

Ressor

Search…

Introduction

Core Components

Rest

Actions & Conditions

Ressor provides you with the opportunity to perform several actions upon the reload process. This actions can also abort current reload, if some conditions are not met.
Action is represented by ReloadAction interface, and is executed right before the data reload from the source.
There are some number of built-in actions, which are described in the next paragraphs.
Predicates
Abort service reload if some condition is not met:
1
import static xyz.ressor.service.action.Actions.*;
2
​
3
ressor.actions().onReload(isbn, abortIf(rs -> someCondition()))
Copied!
There is also same predicate, but which provides old and new version of the resource:
1
import static xyz.ressor.service.action.Actions.*;
2
​
3
ressor.actions().onReload(isbn, abortIf(
4
                (oldVersion, newVersion) -> isForbidden(newVersion))
Copied!
Service Dependencies
When isbn service is being reloaded, trigger asynchronous reload of books service and proceed immediately:
1
import static xyz.ressor.service.action.Actions.*;
2
​
3
ressor.actions().onReload(isbn, 
4
                  triggerReload(books));
5
ressor.poll(isbn).every(5, SECONDS); 
Copied!
When isbn service is being reloaded, trigger and wait synchronously for the reload of books service. This way,  books service will always be reloaded strictly prior to isbn service:
1
import static xyz.ressor.service.action.Actions.*;
2
​
3
ressor.actions().onReload(isbn, 
4
                   triggerAndWaitReload(books));
5
ressor.poll(isbn).every(5, SECONDS);
Copied!
Logical Operations
You can union multiple actions in logical conditions like math OR, AND:
1
import static xyz.ressor.service.action.Actions.*;
2
​
3
// if either action1 or action2 return positive value
4
// service1 will be reloaded
5
ressor.actions().onReload(service1, or(action1, action2));
6
// if both action3 or action4 return positive value
7
// service2 will be reloaded
8
ressor.actions().onReload(service2, and(action3, action4));
Copied!
Since the action itself can be blocking operation, you can take profit from parallel implementations of such logical conditions.
For example, when isbn service is reloaded, reload in parallel books and dvds services and wait for the positive result from both. In that case, reload isbn:
1
import static xyz.ressor.service.action.Actions.*;
2
​
3
ressor.actions().onReload(isbn, 
4
      andParallel(triggerAndWaitReload(books), 
5
                  triggerAndWaitReload(dvds)));
6
​
7
ressor.poll(isbn).every(5, SECONDS);
Copied!
​

Core Components - Previous

Error Handling

Next - Core Components

Special Notes

Last modified 2yr ago

Copy link

Contents

Predicates

Service Dependencies

Logical Operations