enhanced_meteorify 1.0.1 enhanced_meteorify: ^1.0.1 copied to clipboard
Carefully extended meteorify package to interact with the Meteor framework. Connect your web or flutter apps, written in Dart, with the Meteor framework.
Meteorify #
Carefully extended meteorify 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
- oAuth Authentication with Google (needs server-side code in JavaScript for use with Meteor)
- Call custom Methods on Meteor
- Access underlying databases
Dependency #
Add this to your package's pubspec.yaml
file:
dependencies:
enhanced_meteorify: ^1.0.0
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
// Login with email String loginToken = await Meteor.loginWithPassword(email, password); // Login with username String loginToken = await Meteor.loginWithPassword(username, password);
-
Login with token
String token = await Meteor.loginWithToken(loginToken);
-
Login with Google
// `email` to register with. Must be fetched from the Google oAuth API // The unique Google `userId`. Must be fetched from the Google oAuth API // `authHeaders` from Google oAuth API for server side validation String token = await Meteor.loginWithGoogle(email, userId, authHeaders)
-
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');