56 lines
1.5 KiB
Markdown
56 lines
1.5 KiB
Markdown
# angel_client
|
|
|
|
[](https://pub.dartlang.org/packages/angel_client)
|
|
[](https://travis-ci.org/angel-dart/client)
|
|
|
|
Client library for the Angel framework.
|
|
This library provides virtually the same API as an Angel server.
|
|
The client can run in the browser or on the command-line.
|
|
In addition, the client supports `angel_auth` authentication.
|
|
|
|
# Usage
|
|
|
|
```dart
|
|
// Choose one or the other, depending on platform
|
|
import 'package:angel_client/io.dart';
|
|
import 'package:angel_client/browser.dart';
|
|
|
|
main() async {
|
|
Angel app = new Rest("http://localhost:3000");
|
|
}
|
|
```
|
|
|
|
You can call `service` to receive an instance of `Service`, which acts as a client to a
|
|
service on the server at the given path (say that five times fast!).
|
|
|
|
```dart
|
|
foo() async {
|
|
Service Todos = app.service("todos");
|
|
List<Map> todos = await Todos.index();
|
|
|
|
print(todos.length);
|
|
}
|
|
```
|
|
|
|
The CLI client also supports reflection via `json_god`. There is no need to work with Maps;
|
|
you can use the same class on the client and the server.
|
|
|
|
```dart
|
|
class Todo extends Model {
|
|
String text;
|
|
|
|
Todo({String this.text});
|
|
}
|
|
|
|
bar() async {
|
|
// By the next release, this will just be:
|
|
// app.service<Todo>("todos")
|
|
Service Todos = app.service("todos", type: Todo);
|
|
List<Todo> todos = await Todos.index();
|
|
|
|
print(todos.length);
|
|
}
|
|
```
|
|
|
|
Just like on the server, services support `index`, `read`, `create`, `modify`, `update` and
|
|
`remove`.
|