See whats ahead in Mongoose v3

1. MONGOOSE V3
Looking ahead
jsconf.ar 2012
@aaronheckmann

5. MONGOOSE V3

6. MONGOOSE V3
•What’s wrong

7. MONGOOSE V3
•What’s wrong
•The Fix

8. MONGOOSE V3
•What’s wrong
•The Fix
•Improvements

9. MONGOOSE V3
•What’s wrong
•The Fix
•Improvements
•Support

10. MONGOOSE V3
The Future Is Bright

11. MONGOOSE V3
What’s Wrong?

12. MONGOOSE V3
Beautiful is better than ugly.
Explicit is better than implicit.
Simple is better than complex.
Complex is better than complicated.
Flat is better than nested.
Sparse is better than dense.
Readability counts.
Special cases aren't special enough to break the rules.
Although practicality beats purity.
Errors should never pass silently.
Unless explicitly silenced.
In the face of ambiguity, refuse the temptation to guess.
There should be one-- and preferably only one --obvious way to do it.
Although that way may not be obvious at first unless you're Dutch.
Now is better than never.
Although never is often better than *right* now.
If the implementation is hard to explain, it's a bad idea.
If the implementation is easy to explain, it may be a good idea.
Namespaces are one honking great idea -- let's do more of those!
-- Tim Peters, The Zen of Python http://www.python.org/dev/peps/pep-0020/

13. MONGOOSE V3
Beautiful is better than ugly.
Explicit is better than implicit.
Simple is better than complex.
Complex is better than complicated.
Flat is better than nested.
Sparse is better than dense.
There should be one--
Readability counts.
Special cases aren't special enough to break the rules.
Although practicality beats purity.
and preferably only one
Errors should never pass silently.
Unless explicitly silenced.
In the face of ambiguity, refuse the temptation to guess.
There should be one-- and preferably only one --obvious way to do it.
--obvious way to do it.
Although that way may not be obvious at first unless you're Dutch.
Now is better than never.
Although never is often better than *right* now.
If the implementation is hard to explain, it's a bad idea.
If the implementation is easy to explain, it may be a good idea.
Namespaces are one honking great idea -- let's do more of those!
-- Tim Peters, The Zen of Python http://www.python.org/dev/peps/pep-0020/

14. MONGOOSE V3
One way

15. MONGOOSE V3
One way
User.where(‘age’).$gt(17).select(‘name’).exec(cb)
User.where(‘age’).gt(17).select({‘name’: 1}).exec(cb)
User.where(‘age’).gt(17).select(‘name’, 1).run(cb)
User.find({ age: { $gt: 17 }}).select([‘name’]).exec(cb)
User.find({ age: { $gt: 17 }}, [‘name’]).run(cb)

16. MONGOOSE V3
One way
User.where(‘age’).$gt(17).select(‘name’).exec(cb)
User.where(‘age’).gt(17).select({‘name’: 1}).exec(cb)
User.where(‘age’).gt(17).select(‘name’, 1).run(cb)
User.find({ age: { $gt: 17 }}).select([‘name’]).exec(cb)
User.find({ age: { $gt: 17 }}, [‘name’]).run(cb)

17. MONGOOSE V3
One way
User.where(‘age’).$gt(17).select(‘name’).exec(cb)
User.where(‘age’).gt(17).select({‘name’: 1}).exec(cb)
User.where(‘age’).gt(17).select(‘name’, 1).run(cb)
User.find({ age: { $gt: 17 }}).select([‘name’]).exec(cb)
User.find({ age: { $gt: 17 }}, [‘name’]).run(cb)

18. MONGOOSE V3
One way
User.where(‘age’).$gt(17).select(‘name’).exec(cb)
User.where(‘age’).gt(17).select({‘name’: 1}).exec(cb)
User.where(‘age’).gt(17).select(‘name’, 1).run(cb)
User.find({ age: { $gt: 17 }}).select([‘name’]).exec(cb)
User.find({ age: { $gt: 17 }}, [‘name’]).run(cb)

19. MONGOOSE V3
One way
User.where(‘age’).$gt(17).select(‘name’).exec(cb)
User.where(‘age’).gt(17).select({‘name’: 1}).exec(cb)
User.where(‘age’).gt(17).select(‘name’, 1).run(cb)
User.find({ age: { $gt: 17 }}).select([‘name’]).exec(cb)
User.find({ age: { $gt: 17 }}, [‘name’]).run(cb)

20. MONGOOSE V3
http://www.motifake.com/image/demotivational-poster/1106/determination-determination-faceplant-demotivational-posters-1307398930.jpg

21. MONGOOSE V3
API pollution
Query methods
$or -> or $in -> in $near -> near
$nor -> nor $nin -> nin $within -> within
$gt -> gt $all -> all $box -> box
$gte -> gte $regex ->regex $center - > center
$lt -> lt $size -> size $centerSphere -> centerSphere
$lte -> lte $slice -> slice $maxDistance ->maxDistance

22. MONGOOSE V3
API pollution
Query methods
$ne -> ne only -> select({ path: 1 })
$mod -> mod exclude -> select({ path: 0 })
$exists -> exists run -> exec
$elemMatch -> elemMatch notEqualTo -> ne
asc -> sort({ path: 1 }) wherein -> within
desc -> sort({ path: 0}) fields -> select

23. MONGOOSE V3
API pollution
Connection methods
createConnection
createSetConnection
connect
connectSet

24. MONGOOSE V3
The Fix?
createConnection $nin -> nin $ne -> ne
createSetConnection $all -> all $mod -> mod
connect $regex -> regex $exists -> exists
connectSet $size -> size $elemMatch -> elemMatch
$or -> or $slice -> slice asc -> sort({ path: 1 })
$nor -> nor $near -> near desc -> sort({ path: 0})
$gt -> gt $within -> within only -> select({ path: 1 })
$gte -> gte $box -> box exclude -> select({ path: 0 })
$lt -> lt $center -> center run -> exec
$lte -> lte $centerSphere -> centerSphere notEqualTo -> ne
$in -> in $maxDistance -> maxDistance wherein -> within
fields -> select

25. MONGOOSE V3
The Fix
kill all the things
createConnection $nin -> nin $ne -> ne
createSetConnection $all -> all $mod -> mod
connect $regex -> regex $exists -> exists
connectSet $size -> size $elemMatch -> elemMatch
$or -> or $slice -> slice asc -> sort({ path: 1 })
$nor -> nor $near -> near desc -> sort({ path: 0})
$gt -> gt $within -> within only -> select({ path: 1 })
$gte -> gte $box -> box exclude -> select({ path: 0 })
$lt -> lt $center -> center run -> exec
$lte -> lte $centerSphere -> centerSphere notEqualTo -> ne
$in -> in $maxDistance -> maxDistance wherein -> within
fields -> select

26. MONGOOSE V3
The Fix
kill all the things
createConnection $nin -> nin $ne -> ne
createSetConnection $all -> all $mod -> mod
connect $regex -> regex $exists -> exists
connectSet $size -> size $elemMatch -> elemMatch
$or -> or $slice -> slice asc -> sort({ path: 1 })
$nor -> nor $near -> near desc -> sort({ path: 0})
$gt -> gt $within -> within only -> select({ path: 1 })
$gte -> gte $box -> box exclude -> select({ path: 0 })
$lt -> lt $center -> center run -> exec
$lte -> lte $centerSphere -> centerSphere notEqualTo -> ne
$in -> in $maxDistance -> maxDistance wherein -> within
fields -> select
http://soundbible.com/1575-High-Definition-Machine-Gun.html
http://openclipart.org/detail/20561/set-of-bullet-holes-by-rg1024

27. MONGOOSE V3
The Fix
remove query aliases
Coffee.where(‘flavor’).$in(array).run()

28. MONGOOSE V3
The Fix
remove query aliases
Coffee.where(‘flavor’).$in(array).run() Coffee.where(‘flavor’).in(array).exec()

29. MONGOOSE V3
The Fix
remove query aliases
Coffee.where(‘flavor’).$in(array).run() Coffee.where(‘flavor’).in(array).exec()

30. MONGOOSE V3
The Fix
remove query aliases
Coffee.find().asc(‘flavor’).run()

31. MONGOOSE V3
The Fix
remove query aliases
Coffee.find().asc(‘flavor’).run() Coffee.find().sort(‘flavor’).exec()

32. MONGOOSE V3
The Fix
remove query aliases
Coffee.find().asc(‘flavor’).run() Coffee.find().sort(‘flavor’).exec()

33. MONGOOSE V3
The Fix
Combine connection methods
goose.createSetConnection(connString)

34. MONGOOSE V3
The Fix
Combine connection methods
goose.createSetConnection(connString)
goose.createConnection(connString)

35. MONGOOSE V3
The Fix
Combine connection methods
mongoose.connectSet(connString)

36. MONGOOSE V3
The Fix
Combine connection methods
mongoose.connectSet(connString)
mongoose.connect(connString)

37. MONGOOSE V3
What’s Wrong?

38. MONGOOSE V3
What’s Wrong?
Query method arguments

39. MONGOOSE V3
What’s Wrong?
Query method arguments
query.select(array)
query.select(‘path’, 1, ‘path’, 1)
query.select({ key: 0 })
query.select(‘space delimited’)
query.hint(‘path’, 1, ‘path’, 1)
query.hint({ key: 1})

40. MONGOOSE V3
What’s Wrong?
Query method arguments
query.select(array)
query.select(‘path’, 1, ‘path’, 1)
query.select({ key: 0 })
query.select(‘space delimited’)
query.hint(‘path’, 1, ‘path’, 1)
query.hint({ key: 1})

41. MONGOOSE V3
The Fix
Query method arguments
query.select(‘include -exclude’)

42. MONGOOSE V3
The Fix
Query method arguments
query.select(‘include -exclude’)
query.select({ include: 1, exclude: 0 })

43. MONGOOSE V3
The Fix
Query method arguments
query.select({ include: 1, exclude: 0 })
query.select(‘include -exclude’)
query.sort({ include: 1, exclude: 0 })
query.sort(‘include -exclude’)

44. MONGOOSE V3
Missing MongoDB features

45. MONGOOSE V3
Missing MongoDB features

46. MONGOOSE V3
Missing MongoDB features

47. MONGOOSE V3
Missing MongoDB features
•Map Reduce

48. MONGOOSE V3
Missing MongoDB features
•Map Reduce
var o = { map: mapFn, reduce: rFn }
Talks.mapReduce(o, function (err, res) {
console.log(res)
})

49. MONGOOSE V3
Missing MongoDB features
•Map Reduce
var o = { map: mapFn, reduce: rFn }
o.out = { replace: ‘mapped_talks’ }
Talks.mapReduce(o, function (err, res) {
res.find().where().exec(function (err, docs) {
console.log(res)
})
})

50. MONGOOSE V3
Missing MongoDB features
•FindAndModify

51. MONGOOSE V3
Missing MongoDB features
•FindAndModify
// old way
var o = { _id: anObjectId }
Talks.findOne(o, function (err, doc) {
doc.name = ‘peanut butter’;
doc.save()
})

52. MONGOOSE V3
Missing MongoDB features
•FindAndModify
// new way
var o = { _id: anObjectId }
, up = { $set: { name: ‘peanut butter’}}
Talks.findOneAndUpdate(o, up, function (err, doc) {
console.log(doc)
})

53. MONGOOSE V3
Missing MongoDB features
•FindAndModify
var o = { name: ‘peanut butter’ }
Talks.findOneAndRemove(o, function (err, res) {
console.log(res)
})

54. MONGOOSE V3
Missing MongoDB features
•FindAndModify
Talks.findByIdAndUpdate(id, update, cb)
Talks.findByIdAndRemove(id, update, cb)

55. MONGOOSE V3
Missing MongoDB features
•Map Reduce
•FindAndModify
•Capped collections *
* soon!

56. MONGOOSE V3
Missing MongoDB features
•Map Reduce
•FindAndModify
•Capped collections *
•Aggregation *
* soon!

57. MONGOOSE V3
Missing MongoDB features
•Aggregation
Article.aggregate(
{ $project : { author : 1, tags : 1 }}
, { $unwind : "$tags" }
, { $group : {
_id : { tags : 1 }
, authors : { $addToSet : "$author" }
}
});
* soon!

58. MONGOOSE V3
Missing MongoDB features
•Aggregation
Article.aggregate(
{ $project : { author : 1, tags : 1 }}
, { $unwind : "$tags" }
, { $group : {
_id : { tags : 1 }
, authors : { $addToSet : "$author" }
}
});
* soon!

59. MONGOOSE V3
Missing MongoDB features
•Aggregation
Article.aggregate(
{ $project : { author : 1, tags : 1 }}
, { $unwind : "$tags" }
, { $group : {
_id : { tags : 1 }
, authors : { $addToSet : "$author" }
}
});
* soon!

60. MONGOOSE V3
Missing MongoDB features
•Aggregation
Article.aggregate(
{ $project : { author : 1, tags : 1 }}
, { $unwind : "$tags" }
, { $group : {
_id : { tags : 1 }
, authors : { $addToSet : "$author" }
}
});
* soon!

61. MONGOOSE V3
Missing MongoDB features
•Aggregation
Article.aggregate(
{ $project : { author : 1, tags : 1 }}
, { $unwind : "$tags" }
, { $group : {
_id : { tags : 1 }
, authors : { $addToSet : "$author" }
}
});
* soon!

62. MONGOOSE V3
Missing MongoDB features
•Aggregation
Article.aggregate(
{ $project : { author : 1, tags : 1 }}
, { $unwind : "$tags" }
, { $group : {
_id : { tags : 1 }
, authors : { $addToSet : "$author" }
}
});
* soon!

63. MONGOOSE V3
Missing MongoDB features
•Map Reduce
•FindAndModify
•Capped collections *
•Aggregation *
•Improved geo-spatial support *
* soon!

64. MONGOOSE V3
Performance

65. MONGOOSE V3
Performance
•lean queries

66. MONGOOSE V3
Performance
•lean queries
Talks
.findOne()
.exec(function (err, doc) {
// doc.save()
})

67. MONGOOSE V3
Performance
•lean queries
Talks
.findOne()
.setOptions({ lean: true })
.exec(function (err, doc) {
// doc.save
})

68. MONGOOSE V3
Performance
•lean queries
Talks
.findOne()
.setOptions({ lean: true })
.exec(function (err, doc) {
// doc.save -> undefined
})

69. MONGOOSE V3
Performance
•lean queries
•background indexes

70. MONGOOSE V3
Performance
•lean queries
•background indexes
•connection pool size?

71. MONGOOSE V3
Performance
•lean queries
•background indexes
•connection pool size?
•memory usage?

72. MONGOOSE V3
General Improvements

73. MONGOOSE V3
General Improvements
•Improved update command generation for arrays

74. MONGOOSE V3
General Improvements
•Improved update command generation for arrays
var schema = new Schema({ tags: [], name: String })

75. MONGOOSE V3
General Improvements
•Improved update command generation for arrays
var schema = new Schema({ tags: [], name: String })
var Talks = db.model(‘Talk’, schema)

76. MONGOOSE V3
General Improvements
•Improved update command generation for arrays
var schema = new Schema({ tags: [], name: String })
var Talks = db.model(‘Talk’, schema)
Talks.findById(id, function (err, talk) {
talk.name = ‘peanut butter’
talk.tags.push(‘nerdcore’)
talk.save(callback)
})

77. MONGOOSE V3
General Improvements
•Improved update command generation for arrays
var schema = new Schema({ tags: [], name: String })
var Talks = db.model(‘Talk’, schema)
Talks.findById(id, function (err, talk) {
talk.name = ‘peanut butter’
talk.tags.push(‘nerdcore’)
talk.save(callback) // magic!
})

78. MONGOOSE V3
General Improvements
•Improved update command generation for arrays
Object.defineProperty(talk, ‘name’, {
get: function () { return this.smth }
, set: function (v){
this.smth = v
}
})

79. MONGOOSE V3
General Improvements
•Improved update command generation for arrays
Object.defineProperty(talk, ‘name’, {
get: function () { return this.smth }
, set: function (v){
record(‘name’);
this.smth = v
}
})

80. MONGOOSE V3
General Improvements
•Improved update command generation for arrays
Object.defineProperty(talk, ‘name’, {
get: function () { return this.smth }
, set: function (v){
this._set = {}
this._set[‘name’] = v
this.smth = v
}
})

81. MONGOOSE V3
General Improvements
•Improved update command generation for arrays
talk.save() ->
var update = {};
update.$set = talk._set;
Talks.update({ _id: talk._id }, update, callback)

82. MONGOOSE V3
General Improvements
•Improved update command generation for arrays
talk.tags.push = function () {
record(‘push’, arguments)
}

83. MONGOOSE V3
General Improvements
•Improved update command generation for arrays
talk.tags.push = function () {
record(‘push’, arguments)
}
talk.save() ->
var update = {};
update.$pushAll = { tags: args }
Talk.update({_id:talk._id}, update, callback)

84. MONGOOSE V3
General Improvements
•Improved update command generation for arrays
talk.tags.push(‘nerdcore’)
talk.tags.remove(‘php’)
talk.save(callback) // fail!

85. MONGOOSE V3
General Improvements
•Improved update command generation for arrays
talk.tags.push(‘nerdcore’)
talk.tags.remove(‘php’)
talk.save(callback) // success!!

86. MONGOOSE V3
General Improvements
•Simplify schema declaration

87. MONGOOSE V3
General Improvements
•Simplify schema declaration
var personSchema = new Schema({
name: String
, val: Number
, buffer: Buffer
, array: Array
, etc: ...
})

88. MONGOOSE V3
General Improvements
•Simplify schema declaration
var personSchema = new Schema({
name: ‘string’
, val: ‘number’
, buffer: ‘buffer’
, array: ‘array’
, etc: ...
})

89. MONGOOSE V3
General Improvements
•Hardened schema ‘strict’ option
var personSchema = new Schema({
name: ‘string’
, val: ‘number’
, buffer: ‘buffer’
, array: ‘array’
, etc: ...
}, { strict: true })

90. MONGOOSE V3
General Improvements
•Hardened schema ‘strict’ option
var personSchema = new Schema({
name: ‘string’
, val: ‘number’
, buffer: ‘buffer’
, array: ‘array’
, etc: ...
}, { strict: ‘throw’ })

91. MONGOOSE V3
General Improvements
•Hardened schema ‘strict’ option
new Person({ notExists: ‘3vil’ })

92. MONGOOSE V3
General Improvements
•Hardened schema ‘strict’ option
new Person({ notExists: ‘3vil’ })
// throws “Field `notExists` is not in schema”

93. MONGOOSE V3
General Improvements
•Simplify schema declaration
•Hardened schema ‘strict’ option (throws)
•Removed MongooseNumber

94. MONGOOSE V3
General Improvements
•Simplify schema declaration
•Hardened schema ‘strict’ option (throws)
•Removed MongooseNumber
•Add multiple validators

95. MONGOOSE V3
General Improvements
•Simplify schema declaration
•Hardened schema ‘strict’ option (throws)
•Removed MongooseNumber
•Add multiple validators
•toObject,toJSON options

96. MONGOOSE V3
General Improvements
•Simplify schema declaration
•Hardened schema ‘strict’ option (throws)
•Removed MongooseNumber
•Add multiple validators
•toObject,toJSON options
•Specify a model in query.populate()

97. MONGOOSE V3
General Improvements
•Add document versioning
* soon!

98. MONGOOSE V3
General Improvements
•Add document versioning
•Recursive populate
* soon!

99. MONGOOSE V3
Documentation
•mongoosejs.com
•plugins.mongoosejs.com
•blog.mongoosejs.com

100. MONGOOSE V3
Support
•LearnBoost

101. MONGOOSE V3
Support
•LearnBoost
•10gen *

102. MONGOOSE V3
Support
•LearnBoost
•10gen * driver too

103. MONGOOSE V3
¿Preguntas?
@aaronheckmann aaronheckmann@gmail.com
@10gen https://github.com/aheckmann
@learnboost https://github.com/LearnBoost/mongoose
@mongodb

104. MONGOOSE V3
Thanks!
@aaronheckmann aaronheckmann@gmail.com
@10gen https://github.com/aheckmann
@learnboost https://github.com/LearnBoost/mongoose
@mongodb