Creating a RESTful API should be the easiest part of your development. You should not have to be a rocket scientist to successfully create a RESTful API. With Sails, you can create a full featured RESTful API in just a few minutes without writing any code. You get create, destroy, update, find, paginate, sort, and filtering out of the box. If you need to add your business logic to any of the methods or create your own methods, you can do that by writing simple JavaScript functions. When you are ready to implement your security layer, Sails has you covered. Sails provides basic security and role-based access in the form of policies that can be applied any REST action. Policies are interchangeable with Express/Connect middleware which means you can plugin in popular NPM modules such as Passport. You can also easily implement your own email/password, social login or Windows authentication with a bit of JavaScript. For data storage, Sails bundles the power ORM, Waterline, which provides a simple data access layer that just works, no matter what database you are using. Out of the box MongoDB, MySQL, PostgreSQL, and Redis are support. However, there are more than 30 data storage providers adapter that the community has created such as Microsoft SQL Server, Couchbase, Salesforce, and Firebase. You can easily switch between any data storage provider or mix and match data storage providers on a model by model basis. This talk will be code heavy as we walk through getting started with Sails and demonstrate how to implement the features of Sails through the creation of an API. As well, I will share the tips and tricks that I have learned using Sails at a Fortune 100 company. You will walk away understanding how and why you should use Sails on your next project. Github Repo: https://github.com/digitaldrummerj/angular-mix

1. Rapid API Development with Sails
10/11/2017, 1:15-1:35pm
Justin James
DevOps Evangelist and Microsoft MVP
@digitaldrummerj

2. © AngularMIX All rights reserved.
https://www.angularmix.com
Deliver Value to Users
as Quickly as Possible!

3. © AngularMIX All rights reserved.
https://www.angularmix.com
Not Paid to Write
Infrastructure Code!

4. © AngularMIX All rights reserved.
https://www.angularmix.com
Create JavaScript Services

5. © AngularMIX All rights reserved.
https://www.angularmix.com
Auto-generated REST APIs

6. © AngularMIX All rights reserved.
https://www.angularmix.com
Any Database

7. © AngularMIX All rights reserved.
https://www.angularmix.com
Flexible and Configurable

8. © AngularMIX All rights reserved.
https://www.angularmix.com
Security Policies

9. © AngularMIX All rights reserved.
https://www.angularmix.com
Built-On Top of

10. © AngularMIX All rights reserved.
https://www.angularmix.com
Ridiculously Fast

11. © AngularMIX All rights reserved.
https://www.angularmix.com
Just Works

12. © AngularMIX All rights reserved.
https://www.angularmix.com
Does NOT hide the magic

13. © AngularMIX All rights reserved.
https://www.angularmix.com

14. © AngularMIX All rights reserved.
https://www.angularmix.com
Ultimately,
writing tiny amounts of code
gets you a ton!

15. © AngularMIX All rights reserved.
https://www.angularmix.com
Getting Started

16. © AngularMIX All rights reserved.
https://www.angularmix.com
Install

17. © AngularMIX All rights reserved.
https://www.angularmix.com
Install Sails
npm install –g sails

18. © AngularMIX All rights reserved.
https://www.angularmix.com
Create Project
sails new [Project Name] --no-linker --no-frontend

19. © AngularMIX All rights reserved.
https://www.angularmix.com
Generate API
sails generate api [Api Name]

20. © AngularMIX All rights reserved.
https://www.angularmix.com
Start Sails Dev Server
sails lift

21. © AngularMIX All rights reserved.
https://www.angularmix.com
Start Sails in Production
node app.js

22. © AngularMIX All rights reserved.
https://www.angularmix.com
Debug Sails Way #1
node --inspect app.js

23. © AngularMIX All rights reserved.
https://www.angularmix.com
Debug Sails Way #2
Use Visual Studio Code Built-In Debugger

24. © AngularMIX All rights reserved.
https://www.angularmix.com
function timeForSomeCode () {
……
}

25. © AngularMIX All rights reserved.
https://www.angularmix.com
Controller - apicontrollers<Api Name>Controller.js
module.exports = {
};

26. © AngularMIX All rights reserved.
https://www.angularmix.com
Model - apimodels<Api Name>.js
module.exports = {
attributes: {
}
};

27. © AngularMIX All rights reserved.
https://www.angularmix.com
Using Api
 POST http://localhost:1337/<Api Name>
 GET http://localhost:1337/<Api Name>
 PUT http://localhost:1337/<Api Name>/:id
 DELETE http://localhost:1337/<Api Name>/:id

28. © AngularMIX All rights reserved.
https://www.angularmix.com
POST – http://localhost:1337/user
{
"email": "foo2@foo.com",
"lastName": "James",
"firstName": "Justin",
}

29. © AngularMIX All rights reserved.
https://www.angularmix.com
POST Response - http://localhost:1337/user
{
"email": "foo2@foo.com",
"lastName": "James",
"firstName": "Justin",
"createdAt": "2017-10-11T20:15:24.151Z",
"updatedAt": "2017-10-11T20:15:24.151Z",
"id": 1
}

30. © AngularMIX All rights reserved.
https://www.angularmix.com
GET Response – http://localhost:1337/user
[{
"email": "foo2@foo.com",
"lastName": "James",
"firstName": "Justin",
"createdAt": "2017-10-11T20:15:24.151Z",
"updatedAt": "2017-10-11T20:15:24.151Z",
"id": 1
}]

31. © AngularMIX All rights reserved.
https://www.angularmix.com
Build Out Model – apimodelsUser.js
module.exports = {
attributes: {
email: { required: true, unique: true, type: 'string' },
lastName: { required: true, type: 'string' },
firstName: { required: true, type: 'string' },
todoItems: {
collection: 'todo',
via: 'user',
},
},
}

32. © AngularMIX All rights reserved.
https://www.angularmix.com
Build Out Model – apimodelsUser.js
module.exports = {
attributes: {
email: {required: true, unique: true, type: 'string' },
lastName: { required: true, type: 'string' },
firstName: { required: true, type: 'string' },
todoItems: {
collection: 'todo',
via: 'user',
},
},
}

33. © AngularMIX All rights reserved.
https://www.angularmix.com
Build Out Model – apimodelsUser.js
module.exports = {
attributes: {
email: {required: true, unique: true, type: 'string' },
lastName: { required: true, type: 'string' },
firstName: { required: true, type: 'string' },
todoItems: {
collection: 'todo',
via: 'user',
},
},
}

34. © AngularMIX All rights reserved.
https://www.angularmix.com
Build Out Model – apimodelsUser.js
module.exports = {
attributes: {
email: {required: true, unique: true, type: 'string' },
lastName: { required: true, type: 'string' },
firstName: { required: true, type: 'string' },
todoItems: {
collection: 'todo',
via: 'user',
},
},
}

35. © AngularMIX All rights reserved.
https://www.angularmix.com
One to Many – apimodelsTodo.js
module.exports = {
attributes: {
.....
user: {
model: 'User',
}
}
};

36. © AngularMIX All rights reserved.
https://www.angularmix.com
Override Built-In REST verbs
module.exports = {
find: function findFn(req, res) {}, // GET
findOne: function findOneFn(req, res) {}, // GET/id
create: function createFn(req, res) {}, // POST
update: function updateFn(req, res) {}, // PUT
delete: function deleteFn(req, res) {}, // DELETE
}

37. © AngularMIX All rights reserved.
https://www.angularmix.com
Get User – http://localhost:1337/user/:id
findOne: function findOneFn(req, res) {
User.findOne({ id: req.param('id') })
.populate('todoItems')
.exec(function (err, user) {
if (err) return res.serverError(err);
if (!user) return res.notFound();
return res.ok(user);
});
},

38. © AngularMIX All rights reserved.
https://www.angularmix.com
Get User – http://localhost:1337/user/:id
findOne: function findOneFn(req, res) {
User.findOne({ id: req.param('id') })
.populate('todoItems')
.exec(function (err, user) {
if (err) return res.serverError(err);
if (!user) return res.notFound();
return res.ok(user);
});
},

39. © AngularMIX All rights reserved.
https://www.angularmix.com
Get User – http://localhost:1337/user/:id
findOne: function findOneFn(req, res) {
User.findOne({ id: req.param('id') })
.populate('todoItems')
.exec(function (err, user) {
if (err) return res.serverError(err);
if (!user) return res.notFound();
return res.ok(user);
});
},

40. © AngularMIX All rights reserved.
https://www.angularmix.com
Get User – http://localhost:1337/user/:id
findOne: function findOneFn(req, res) {
User.findOne({ id: req.param('id') })
.populate('todoItems')
.exec(function (err, user) {
if (err) return res.serverError(err);
if (!user) return res.notFound();
return res.ok(user);
});
},

41. © AngularMIX All rights reserved.
https://www.angularmix.com
Get User – http://localhost:1337/user/:id
findOne: function findOneFn(req, res) {
User.findOne({ id: req.param('id') })
.populate('todoItems')
.exec(function (err, user) {
if (err) return res.serverError(err);
if (!user) return res.notFound();
return res.ok(user);
});
},

42. © AngularMIX All rights reserved.
https://www.angularmix.com
Get User – http://localhost:1337/user/:id
findOne: function findOneFn(req, res) {
User.findOne({ id: req.param('id') })
.populate('todoItems')
.exec(function (err, user) {
if (err) return res.serverError(err);
if (!user) return res.notFound();
return res.ok(user);
});
},

43. © AngularMIX All rights reserved.
https://www.angularmix.com
Get User – http://localhost:1337/user/:id
findOne: function findOneFn(req, res) {
User.findOne({ id: req.param('id') })
.populate('todoItems')
.exec(function (err, user) {
if (err) return res.serverError(err);
if (!user) return res.notFound();
return res.ok(user);
});
},

44. © AngularMIX All rights reserved.
https://www.angularmix.com
Get User – http://localhost:1337/user/:id
findOne: function findOneFn(req, res) {
User.findOne({ id: req.param('id') })
.populate('todoItems')
.exec(function (err, user) {
if (err) return res.serverError(err);
if (!user) return res.notFound();
return res.ok(user);
});
},

45. © AngularMIX All rights reserved.
https://www.angularmix.com
Get User Response – http://localhost:1337/user/:id
{
"todoItems": [],
"email": "foo2@foo.com",
"lastName": "James",
"firstName": "Justin",
"createdAt": "2017-10-10T15:39:06.838Z",
"updatedAt": "2017-10-10T15:39:06.838Z",
"id": 1
}

46. © AngularMIX All rights reserved.
https://www.angularmix.com
Security – apipoliciesisLoggedIn.js
module.exports = function(req, res, next) {
if (req.session.user) return next();
return res.forbidden('Please Login First.');
};

47. © AngularMIX All rights reserved.
https://www.angularmix.com
Security – apipoliciesisLoggedIn.js
module.exports = function(req, res, next) {
if (req.session.user) return next();
return res.forbidden('Please Login First.');
};

48. © AngularMIX All rights reserved.
https://www.angularmix.com
Security – apipoliciesisLoggedIn.js
module.exports = function(req, res, next) {
if (req.session.user) return next();
return res.forbidden('Please Login First.');
};

49. © AngularMIX All rights reserved.
https://www.angularmix.com
Security – apipoliciesisLoggedIn.js
module.exports = function(req, res, next) {
if (req.session.user) return next();
return res.forbidden('Please Login First.');
};

50. © AngularMIX All rights reserved.
https://www.angularmix.com
Implement Policy– configpolicies.js
module.exports.policies = {
UserController: {
create: ['isLoggedOut'],
login: ['isLoggedOut'],
'*': ['isLoggedIn'],
},
TodoController: {
'*': ['isLoggedIn']
}
}

51. © AngularMIX All rights reserved.
https://www.angularmix.com
Implement Policy– configpolicies.js
module.exports.policies = {
UserController: {
create: ['isLoggedOut'],
login: ['isLoggedOut'],
'*': ['isLoggedIn'],
},
TodoController: {
'*': ['isLoggedIn']
}
}

52. © AngularMIX All rights reserved.
https://www.angularmix.com
Implement Policy– configpolicies.js
module.exports.policies = {
UserController: {
create: ['isLoggedOut'],
login: ['isLoggedOut'],
'*': ['isLoggedIn'],
},
TodoController: {
'*': ['isLoggedIn']
}
}

53. © AngularMIX All rights reserved.
https://www.angularmix.com
Implement Policy– configpolicies.js
module.exports.policies = {
UserController: {
create: ['isLoggedOut'],
login: ['isLoggedOut'],
'*': ['isLoggedIn'],
},
TodoController: {
'*': ['isLoggedIn']
}
}

54. © AngularMIX All rights reserved.
https://www.angularmix.com
Implement Policy– configpolicies.js
module.exports.policies = {
UserController: {
create: ['isLoggedOut'],
login: ['isLoggedOut'],
'*': ['isLoggedIn'],
},
TodoController: {
'*': ['isLoggedIn']
}
}

55. © AngularMIX All rights reserved.
https://www.angularmix.com
Implement Policy– configpolicies.js
module.exports.policies = {
UserController: {
create: ['isLoggedOut'],
login: ['isLoggedOut'],
'*': ['isLoggedIn'],
},
TodoController: {
'*': ['isLoggedIn']
}
}

56. © AngularMIX All rights reserved.
https://www.angularmix.com
Implement Policy– configpolicies.js
module.exports.policies = {
UserController: {
create: ['isLoggedOut'],
login: ['isLoggedOut'],
'*': ['isLoggedIn'],
},
TodoController: {
'*': ['isLoggedIn']
}
}

57. © AngularMIX All rights reserved.
https://www.angularmix.com
Custom Function – apiControllersUserController.js
userIdentity: function (req, res) {
....
},

58. © AngularMIX All rights reserved.
https://www.angularmix.com
Custom Function – apiControllersUserController.js
userIdentity: function (req, res) {
....
},
URL: http://localhost:1337/user/userIdentity

59. © AngularMIX All rights reserved.
https://www.angularmix.com
Routes – config/routes.js
module.exports.routes = {
'GET /user/identity': 'UserController.userIdentity',
};

60. © AngularMIX All rights reserved.
https://www.angularmix.com
References
 Documentation:
 http://sailsjs.com/
 Slides:
 https://slideshare.net/digitaldrummerj
 Demo Code:
 https://github.com/digitaldrummerj/angular-mix
 Tutorial:
 http://digitaldrummerj.me/sails-tutorial

61. © AngularMIX All rights reserved.
https://www.angularmix.com
digitaldrummerj.me
digitaldrummerj

62. © AngularMIX All rights reserved.
https://www.angularmix.com
Please use EventsXD to fill out a session evaluation.
Thank you!

63. © AngularMIX All rights reserved.
https://www.angularmix.com
Please use EventsXD to fill out a session evaluation.
Thank you!

64. © AngularMIX All rights reserved.
https://www.angularmix.com
Sails
Solves These