Angel3 RethinkDB

Pub Version (including pre-releases) Null Safety Discord License

This is RethinkDB service for Angel3 framework. RethinkDB is an open-source database for the realtime web.


Add the following to your pubspec.yaml:

  angel3_rethink: ^8.0.0

belatuk-rethinkdb driver will be used for connecting to RethinkDB.


This library exposes one class: RethinkService. By default, these services will listen to changefeeds from the database, which makes them very suitable for WebSocket use. However, only CREATED, UPDATED and REMOVED events will be fired. Technically not a problem, as it lowers the number of events that need to be handled on the client side.


Model is class with no real functionality; however, it represents a basic document, and your services should host inherited classes. Other Angel service providers host Model as well, so you will easily be able to modify your application if you ever switch databases.

class User extends Model {
  String username;
  String password;

main() async {
    var r = RethinkDb();
    var conn = await r.connect(
        db: 'testDB',
        host: "localhost",
        port: 28015,
        user: "admin",
        password: "");

    app.use('/api/users', RethinkService(conn, r.table('users')));
    // Add type de/serialization if you want
    app.use('/api/users', TypedService<User>(RethinkService(conn, r.table('users'))));

    // You don't have to even use a table...
    app.use('/api/pro_users', RethinkService(conn, r.table('users').filter({'membership': 'pro'})));
    app.service('api/users').afterCreated.listen((event) {
        print("New user: ${event.result}");


This class interacts with a Query (usually a table) and serializes data to and from Maps.


Does the same as above, but serializes to and from a target class using belatuk_json_serializer and it supports reflection.


You can query these services as follows:


The above will query the database to find records where foo equals bar. The former will sort result in ascending order of creation, and so will the latter.

You can use advanced queries:

// Pass an actual query...
service.index({'query': r.table('foo').filter(...)});

// Or, a function that creates a query from a table...
service.index({'query': (table) => table.getAll('foo')});

// Or, a Map, which will be transformed into a `filter` query:
service.index({'query': {'foo': 'bar', 'baz': 'quux'}});

You can also apply sorting by adding a reql parameter on the server-side.

service.index({'reql': (query) => query.sort(...)});

See the tests for more usage examples.