En este post voy a mostrar cómo crear la estructura inicial de una app de Node que utiliza el framework Express, usando el generador llamado express-generator.
Lo que veremos será:
- Cómo instalar express-generator
- Instalar las dependencias
- Analizar la anatomía de la app, es decir, el proyecto, las vistas, etcétera
Nota: este ejemplo podría ser una “mejora” a la plantilla que vimos anteriormente.
Requisitos previos
Simplemente instala Node y NPM.
Instalar express-generator globalmente
Para tener el generador disponible en la PATH, hay que instalarlo globalmente con:
npm install -g express-generator
Un vistazo a express-generator
Ahora podemos ejecutar express --help para ver la ayuda.
Para crear un proyecto la sintaxis es:
express [opciones] ruta_del_proyecto
La carpeta que indica la ruta será creada al ejecutar el comando, no te preocupes.
Tenemos algunas opciones interesantes. Por ejemplo, la opción de --ejs, --pug o --hbs agrega soporte para esos motores de plantillas.
Podemos especificar el motor que usarán las plantillas con --view motor.
Otra opción muy buena es el motor de CSS, que puede ser less, stylus, compass, sass o, por defecto, simple CSS.
La opción --force es para que el proyecto sea creado en un directorio incluso si el mismo no está vacío.
Generar proyecto con express
Entonces para generar un proyecto que utilice EJS usamos:
express --view ejs crud-mysql
En este caso estoy creando un crud con MySQL que publicaré más tarde. En lugar de crud-mysql puedes especificar el nombre del directorio.
- Cuando se haya creado debes ingresar a esa carpeta con
cd crud-mysql - Después instalar las dependencias con
npm install - Opcionalmente cambiar el puerto
- Ejecutar la app con
SET DEBUG=crud-mysql:* & npm start - Visitar localhost:3000 (o el número de puerto que hayas especificado)
En el navegador se mostrará la página de bienvenida de Express, renderizada, por cierto, con EJS.
Anatomía del proyecto
Bueno bueno, ya generamos nuestra app pero no he explicado el código y su funcionamiento.
Las rutas van en la carpeta routes, por cada módulo debe ir un archivo. En este caso estoy mostrando unas rutas de productos en productos.js.
Para cargar esas rutas hay que requerirlas e indicarle a la app que responda a las mismas con app.use.
Dentro de la carpeta views están las vistas, para ver un ejemplo de su renderizado podemos abrir routes/index.js que va a renderizar la vista llamada index.ejs:
Como segundo argumento a res.render() se pasa un objeto con las variables que serán renderizadas.
Por cierto, dentro de la vista se puede acceder a los recursos públicos almacenados en public. En este caso se está cargando el estilo CSS:
Conclusión
A partir de aquí, podemos empezar a crear aplicaciones robustas, pues ya tenemos una estructura definida y usada por miles de desarrolladores alrededor del mundo.
Muy pronto traeré un ejemplo de esta app con MySQL.
