65 lines
1.9 KiB
Markdown
65 lines
1.9 KiB
Markdown
# Angel3 Mongo
|
|
|
|
|
|
[](https://dart.dev/null-safety)
|
|
[](https://gitter.im/angel_dart/discussion)
|
|
[](https://github.com/dart-backend/angel/tree/master/packages/mongo/LICENSE)
|
|
|
|
MongoDB-enabled services for the Angel3 framework.
|
|
|
|
## Installation
|
|
|
|
Add the following to your `pubspec.yaml`:
|
|
|
|
```yaml
|
|
dependencies:
|
|
angel3_mongo: ^8.0.0
|
|
```
|
|
|
|
## Usage
|
|
|
|
This library exposes one main class: `MongoService`.
|
|
|
|
## Model
|
|
|
|
`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.
|
|
|
|
```dart
|
|
class User extends Model {
|
|
String username;
|
|
String password;
|
|
}
|
|
|
|
void main() async {
|
|
var db = Db('mongodb://localhost:27017/local');
|
|
await db.open();
|
|
|
|
var service = app.use('/api/users', MongoService(db.collection("users")));
|
|
|
|
service.afterCreated.listen((event) {
|
|
print("New user: ${event.result}");
|
|
});
|
|
}
|
|
```
|
|
|
|
## MongoService
|
|
|
|
This class interacts with a `DbCollection` (from mongo_dart) and serializing data to and from Maps.
|
|
|
|
## Querying
|
|
|
|
You can query these services as follows:
|
|
|
|
```curl
|
|
/path/to/service?foo=bar
|
|
```
|
|
|
|
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.
|
|
|
|
```dart
|
|
List queried = await MyService.index({r"$query": where.id(new ObjectId.fromHexString("some hex string"})));
|
|
```
|
|
|
|
And, of course, you can use mongo_dart queries. Just pass it as `query` within `params`.
|
|
|
|
See the tests for more usage examples.
|