O documento discute o sistema de módulos no Node.js, explicando como criar e exportar módulos e como utilizá-los através da função require. É explicado que módulos podem exportar funções, objetos ou classes e serem localizados em pastas locais ou na pasta node_modules através do algoritmo de busca da função require.

1. Rodrigo Branas – @rodrigobranas - http://www.agilecode.com.br
Sistema de Módulos

2. No Node.js, existe uma relação direta
entre um arquivo e um módulo

3. Criando um novo módulo
serialGenerator.js
1. var
max
=
10000;
2.
3. var
generate
=
function()
{
4.
return
Math.floor(Math.random()
*
max);
5. };

4. Como fazer para utilizar um módulo
por meio de outro?

6. http://wiki.commonjs.org/wiki/Modules/1.1

7. A função require é responsável por retornar
o que foi exportado de um outro módulo

8. Criando um novo módulo
serialGenerator.js
1. var
max
=
10000;
2.
3. var
generate
=
function()
{
4.
return
Math.floor(Math.random()
*
max);
5. };

9. Utilizando o módulo serialGenerator
index.js
1. var
serialGenerator
=
require('./serialGenerator.js');
2. console.log(serialGenerator);

11. Por que o módulo está vazio?

12. Tudo que é definido dentro do
módulo é privado

13. Exportando a função generate
serialGenerator.js
1. var
max
=
10000;
2.
3. module.exports.generate
=
function()
{
4.
return
Math.floor(Math.random()
*
max);
5. };

14. Utilizando o módulo serialGenerator
index.js
1. var
serialGenerator
=
require('./serialGenerator.js');
2. console.log(serialGenerator);

16. Invocando a função generate
index.js
1. var
serialGenerator
=
require('./serialGenerator.js');
2. console.log(serialGenerator.generate());

18. Também é possível exportar o módulo
utilizando exports ou this

19. Exportando a função generate
serialGenerator.js
1. var
max
=
10000;
2.
3. exports.generate
=
function()
{
4.
return
Math.floor(Math.random()
*
max);
5. };

20. Exportando a função generate
serialGenerator.js
1. var
max
=
10000;
2.
3. this.generate
=
function()
{
4.
return
Math.floor(Math.random()
*
max);
5. };

21. Qual é a diferença entre
module.exports, exports e this?

22. Todos eles apontam para a
mesma referência
1. console.log(module.exports
===
exports);
//
true
2. console.log(module.exports
===
this);
//
true
3. console.log(exports
===
this);
//
true

23. Cuidado, apenas module.exports
é retornado da função require

24. https://github.com/nodejs/node-v0.x-archive/blob/master/src/node.js

27. Exibindo argumentos de um módulo
1. console.log(arguments);

29. Como um módulo é localizado?

30. Primeiro, o algoritmo de busca tenta
localizar um módulo core. Existem vários
como: net, http, url, fs, zlib, crypto,
events, stream, os, vm, util, entre outros.

32. Localizando um módulo core
1. require('http');

33. Se o nome do módulo iniciar com '/', '../'
ou './', o algoritmo de busca irá localizar o
módulo por meio do caminho absoluto no
sistema de arquivos.

35. Localizando um módulo na mesma pasta
1. require('./serialGenerator.js');

36. Localizando um módulo por meio do
caminho absoluto
1. require('/Users/rodrigobranas/Development/workspace/youtube/
NodeJS_2_Sistema_de_Modulos/serialGenerator.js');

37. Localizando um módulo por meio do
caminho relativo
1. require('../serialGenerator.js');

38. Terminar o nome com '.js' é opcional, o
algoritmo de busca irá tentar colocar o
'.js' no final caso não encontre o módulo.

40. Localizando um módulo na mesma pasta
1. require('./serialGenerator');

41. Localizando um módulo por meio do
caminho absoluto
1. require('/Users/rodrigobranas/Development/workspace/youtube/
NodeJS_2_Sistema_de_Modulos/serialGenerator');

42. Localizando um módulo por meio do
caminho relativo
1. require('../serialGenerator');

43. Se o módulo não começar com '/', '../' ou './' o
algoritmo de busca da função require vai procurar
dentro da pasta node_modules.

45. Localizando um módulo em
node_modules/serialGenerator.js
1. require('serialGenerator');

46. Localizando um módulo em
node_modules/serialGenerator/index.js
1. require('serialGenerator');

49. Ao utilizar o NPM, os módulos instalados
são armazenados na pasta node_modules

50. A função require utiliza um
mecanismo de cache

51. https://github.com/nodejs/node-v0.x-archive/blob/master/src/node.js

53. O módulo serialGenerator ficou
armazenado em cache
1. var
serialGeneratorA
=
require('./serialGenerator.js');
2. var
serialGeneratorB
=
require('./serialGenerator.js');
3. console.log(serialGeneratorA
===
serialGeneratorB);
//
true

55. Existem muitas formas de criar um
módulo e exportá-lo

56. Criando um módulo gerador de serial
serialGenerator.js
1. var
max
=
10000;
2.
3. var
generate
=
function
()
{
4.
return
Math.floor(Math.random()
*
max);
5. };

57. Exportando por meio de um objeto

58. Exportando por meio de um objeto
serialGenerator.js
1. var
max
=
10000;
2.
3. module.exports.generate
=
function
()
{
4.
return
Math.floor(Math.random()
*
max);
5. };

59. Exportando por meio de um objeto
serialGenerator.js
1. var
max
=
10000;
2.
3. exports.generate
=
function
()
{
4.
return
Math.floor(Math.random()
*
max);
5. };

60. Exportando por meio de um objeto
serialGenerator.js
1. var
max
=
10000;
2.
3. this.generate
=
function
()
{
4.
return
Math.floor(Math.random()
*
max);
5. };

61. Exportando por meio de um objeto
serialGenerator.js
1. var
max
=
10000;
2.
3. var
generate
=
function
()
{
4.
return
Math.floor(Math.random()
*
max);
5. };
6.
7. module.exports
=
{
8.
generate:
generate
9. };

62. Não funciona!
1. var
max
=
10000;
2.
3. var
generate
=
function
()
{
4.
return
Math.floor(Math.random()
*
max);
5. };
6.
7. exports
=
{
8.
generate:
generate
9. };

63. Não funciona!
1. var
max
=
10000;
2.
3. var
generate
=
function
()
{
4.
return
Math.floor(Math.random()
*
max);
5. };
6.
7. this
=
{
8.
generate:
generate
9. };

64. Cuidado, apenas module.exports
é retornado da função require

65. Exportando por meio de um objeto
serialGenerator.js
1. var
createSerialGenerator
=
function
()
{
2.
var
max
=
10000;
3.
4.
var
generate
=
function
()
{
5.
return
Math.floor(Math.random()
*
max);
6.
};
7.
8.
return
{
9.
generate:
generate
10.
};
11. }
12.
13. module.exports
=
createSerialGenerator();

66. Exportando por meio de um objeto
serialGenerator.js
1. var
SerialGenerator
=
function
()
{
2.
var
max
=
10000;
3.
4.
this.generate
=
function
()
{
5.
return
Math.floor(Math.random()
*
max);
6.
};
7. };
8.
9. module.exports
=
new
SerialGenerator();

67. Por conta do mecanismo de cache, o
objeto retornado é o mesmo
1. var
serialGeneratorA
=
require('./serialGenerator');
2. var
serialGeneratorB
=
require('./serialGenerator');
3. console.log(serialGeneratorA
===
serialGeneratorB);
//
true

68. Exportando por meio de uma função

69. Exportando por meio de uma função
serialGenerator.js
1. var
createSerialGenerator
=
function
()
{
2.
var
max
=
10000;
3.
4.
var
generate
=
function
()
{
5.
return
Math.floor(Math.random()
*
max);
6.
};
7.
8.
return
{
9.
generate:
generate
10.
};
11. }
12.
13. module.exports
=
createSerialGenerator;

70. Ao invocar a função, temos objetos
diferentes como resultado
1. var
createSerialGenerator
=
require('./serialGenerator');
2. var
serialGeneratorA
=
createSerialGenerator();
3. var
serialGeneratorB
=
createSerialGenerator();
4. console.log(serialGeneratorA
===
serialGeneratorB);
//
false

71. Exportando por meio de um objeto
serialGenerator.js
1. var
SerialGenerator
=
function
()
{
2.
var
max
=
10000;
3.
4.
this.generate
=
function
()
{
5.
return
Math.floor(Math.random()
*
max);
6.
};
7. };
8.
9. module.exports
=
SerialGenerator;

72. Ao invocar a função, temos objetos
diferentes como resultado
1. var
SerialGenerator
=
require('./serialGenerator');
2. var
serialGeneratorA
=
new
SerialGenerator();
3. var
serialGeneratorB
=
new
SerialGenerator();
4. console.log(serialGeneratorA
===
serialGeneratorB);
//
false

73. Rodrigo Branas
Agile Code: http://www.agilecode.com.br
Twitter: @rodrigobranas
SlideShare: http://www.slideshare.com/rodrigobranas
YouTube: http://www.youtube.com/rodrigobranas
LinkedIn: http://br.linkedin.com/in/rodrigobranas
+Plus: https://plus.google.com/+RodrigoBranas
GitHub: http://www.github.com/rodrigobranas