meteorify
meteorify copied to clipboard
A dart package for interacting with Meteor
Meteorify
A Dart package to interact with the Meteor framework.
Connect your web or flutter apps, written in Dart, to the Meteor framework.
Features
- Connect to Meteor server
- Use Meteor Subscriptions
- Meteor Authentication
- Call custom Methods on Meteor
- Access underlying databases
Dependency
Add this to your package's pubspec.yaml
file:
dependencies:
meteorify: ^1.0.7
Usage
Capturing the result of operations
You can use either the then-catchError
or await
syntax to capture the result of operations and handle errors.
I'll be using the await
syntax in this documentation to keep it short and straight.
You can use either catchError
on Future
object or try/catch
syntax to catch errors.
Connection Operations
Connecting with Meteor
Using then-catchError
:
import 'package:meteorify/meteorify.dart';
main() async{
Meteor.connect('ws://example.meteor.com/websocket')
.then((status){
// Do something after connection is successful
})
.catchError((error){
print(error);
//Handle error
});
}
Using await
:
import 'package:meteorify/meteorify.dart';
main() async{
try{
var status = await Meteor.connect('ws://example.meteor.com/websocket');
// Do something after connection is successful
}catch(error){
print(error);
//Handle error
}
}
Check connection status
var isConnected = Meteor.isConnected;
Disconnect from server
Meteor.disconnect();
Listen for connection updates
Meteor.connectionListener = (ConnectionStatus connectionStatus){
print(connectionStatus);
}
Subscriptions
Subscribe to Data
var subscriptionId = await Meteor.subscribe(subscriptionName);
Subscriptions with Parameters
var subscriptionId = await Meteor.subscribe(subscriptionName,args:[arg1,arg2]);
Unsubscribe from Data
await Meteor.unsubscribe(subscriptionId);
Get subscribed data/collection
SubscribedCollection collection = await Meteor.collection(collectionName);
//collection.find({selectors});
//collection.findAll();
//collection.findOne(id);
Authentication
Creating New Account
var userId = await Accounts.createUser(username,email,password,profileOptions);
Login
-
Login with password
String loginToken = await Meteor.loginWithPassword(emailOrUsername,password);
-
Login with token
String token = await Meteor.loginWithToken(loginToken);
-
Change Password (need to be logged in)
String result = await Accounts.changePassword(oldPassword,newPassword);
-
Forgot Password
String result = await Accounts.forgotPassword(email);
-
Reset Password
String result = await Accounts.resetPassword(resetToken,newPassword);
-
Logout
await Meteor.logout();
-
Get logged in userId
String userId = Meteor.currentUserId;
-
Check if logged in
bool isLoggedIn = Meteor.isLoggedIn();
-
Get current user as map
Map<String,dynamic> currentUser = await Meteor.userAsMap();
Call Custom Methods
Defining custom methods in meteor server
export const helloWorld = new ValidatedMethod({
name: 'hello',
validate: new SimpleSchema({
firstname: {type: String},
lastname: {type: String},
}).validator(),
run({ firstname,lastname }) {
const message = "hello "+firstname+" "+lastname;
console.log(message);
return message;
},
});
Invoking custom methods
try{
var result = await Meteor.call('hello',[{'firstname':'Shivam','lastname':'Arora'}]);
print(result);
}catch(error){
print(error);
}
Using Mongo Databases to manage data
Meteorify uses the mongo_dart
package internally to provide access to actual database.
For more instructions regarding use of mongo_dart
, visit their mongo_dart guide.
Get Meteor Database
import 'package:mongo_dart/mongo_dart.dart';
Db db = await Meteor.getMeteorDatabase();
Get custom database
import 'package:mongo_dart/mongo_dart.dart';
Db db = await Meteor.getCustomDatabase(dbUrl);
await db.open();
Get collection
import 'package:mongo_dart/mongo_dart.dart';
DbCollection collection = await db.collection('collectionName');