Esta traducci贸n proporcionada por StrongLoop / IBM.

Este documento puede estar desfasado respecto a la documentaci贸n en ingl茅s. Para ver las 煤ltimas actualizaciones, consulte la documentaci贸n en ingl茅s.

Direccionamiento

Direccionamiento hace referencia a la definici贸n de puntos finales de aplicaci贸n (URI) y c贸mo responden a las solicitudes de cliente. Para ver una introducci贸n al direccionamiento, consulte Direccionamiento b谩sico.

El siguiente c贸digo es un ejemplo de una ruta muy b谩sica.


var express = require('express');
var app = express();

// respond with "hello world" when a GET request is made to the homepage
app.get('/', function(req, res) {
  res.send('hello world');
});

M茅todos de ruta

Un m茅todo de ruta se deriva de uno de los m茅todos HTTP y se adjunta a una instancia de la clase express.

El siguiente c贸digo es un ejemplo de las rutas que se definen para los m茅todos GET y POST a la ra铆z de la aplicaci贸n.


// GET method route
app.get('/', function (req, res) {
  res.send('GET request to the homepage');
});

// POST method route
app.post('/', function (req, res) {
  res.send('POST request to the homepage');
});

Express da soporte a los siguientes m茅todos de direccionamiento que se corresponden con los m茅todos HTTP: get, post, put, head, delete, options, trace, copy, lock, mkcol, move, purge, propfind, proppatch, unlock, report, mkactivity, checkout, merge, m-search, notify, subscribe, unsubscribe, patch, search y connect.

Para direccionar los m茅todos que se convierten en nombres de variable JavaScript no v谩lidos, utilice la notaci贸n entre corchetes. Por ejemplo, app['m-search']('/', function ...

Hay un m茅todo de direccionamiento especial, app.all(), que no se deriva de ning煤n m茅todo HTTP. Este m茅todo se utiliza para cargar funciones de middleware en una v铆a de acceso para todos los m茅todos de solicitud.

En el siguiente ejemplo, el manejador se ejecutar谩 para las solicitudes a 鈥/secret鈥, tanto si utiliza GET, POST, PUT, DELETE, como cualquier otro m茅todo de solicitud HTTP soportado en el m贸dulo http.


app.all('/secret', function (req, res, next) {
  console.log('Accessing the secret section ...');
  next(); // pass control to the next handler
});

V铆as de acceso de ruta

Las v铆as de acceso de ruta, en combinaci贸n con un m茅todo de solicitud, definen los puntos finales en los que pueden realizarse las solicitudes. Las v铆as de acceso de ruta pueden ser series, patrones de serie o expresiones regulares.

Express utiliza path-to-regexp para correlacionar las v铆as de acceso de ruta; consulte la documentaci贸n de path-to-regexp para ver todas las posibilidades para definir v铆as de acceso de ruta. Express Route Tester es una herramienta muy 煤til para probar rutas b谩sicas de Express, aunque no da soporte a la coincidencia de patrones.

Las series de consulta no forman parte de la v铆a de acceso de ruta.

Estos son algunos ejemplos de v铆as de acceso de ruta basadas en series.

Esta v铆a de acceso de ruta coincidir谩 con las solicitudes a la ruta ra铆z, /.


app.get('/', function (req, res) {
  res.send('root');
});

Esta v铆a de acceso de ruta coincidir谩 con las solicitudes a /about.


app.get('/about', function (req, res) {
  res.send('about');
});

Esta v铆a de acceso de ruta coincidir谩 con las solicitudes a /random.text.


app.get('/random.text', function (req, res) {
  res.send('random.text');
});

Estos son algunos ejemplos de v铆as de acceso de ruta basadas en patrones de serie.

Esta v铆a de acceso de ruta coincidir谩 con acd y abcd.


app.get('/ab?cd', function(req, res) {
  res.send('ab?cd');
});

Esta v铆a de acceso de ruta coincidir谩 con abcd, abbcd, abbbcd, etc.


app.get('/ab+cd', function(req, res) {
  res.send('ab+cd');
});

Esta v铆a de acceso de ruta coincidir谩 con abcd, abxcd, abRABDOMcd, ab123cd, etc.


app.get('/ab*cd', function(req, res) {
  res.send('ab*cd');
});

Esta v铆a de acceso de ruta coincidir谩 con /abe y /abcde.


app.get('/ab(cd)?e', function(req, res) {
 res.send('ab(cd)?e');
});

Los caracteres ?, +, * y () son subconjuntos de sus contrapartidas de expresiones regulares. El gui贸n (-) y el punto (.) se interpretan literalmente en las v铆as de acceso basadas en series.

Ejemplos de v铆as de acceso de ruta basadas en expresiones regulares:

Esta v铆a de acceso de ruta coincidir谩 con cualquier valor con una 鈥渁鈥 en el nombre de la ruta.


app.get(/a/, function(req, res) {
  res.send('/a/');
});

Esta v铆a de acceso de ruta coincidir谩 con butterfly y dragonfly, pero no con butterflyman, dragonfly man, etc.


app.get(/.*fly$/, function(req, res) {
  res.send('/.*fly$/');
});

Manejadores de rutas

Puede proporcionar varias funciones de devoluci贸n de llamada que se comportan como middleware para manejar una solicitud. La 煤nica excepci贸n es que estas devoluciones de llamada pueden invocar next('route') para omitir el resto de las devoluciones de llamada de ruta. Puede utilizar este mecanismo para imponer condiciones previas en una ruta y, a continuaci贸n, pasar el control a las rutas posteriores si no hay motivo para continuar con la ruta actual.

Los manejadores de rutas pueden tener la forma de una funci贸n, una matriz de funciones o combinaciones de ambas, como se muestra en los siguientes ejemplos.

Una funci贸n de devoluci贸n de llamada individual puede manejar una ruta. Por ejemplo:


app.get('/example/a', function (req, res) {
  res.send('Hello from A!');
});

M谩s de una funci贸n de devoluci贸n de llamada puede manejar una ruta (aseg煤rese de especificar el objeto next). Por ejemplo:


app.get('/example/b', function (req, res, next) {
  console.log('the response will be sent by the next function ...');
  next();
}, function (req, res) {
  res.send('Hello from B!');
});

Una matriz de funciones de devoluci贸n de llamada puede manejar una ruta. Por ejemplo:


var cb0 = function (req, res, next) {
  console.log('CB0');
  next();
}

var cb1 = function (req, res, next) {
  console.log('CB1');
  next();
}

var cb2 = function (req, res) {
  res.send('Hello from C!');
}

app.get('/example/c', [cb0, cb1, cb2]);

Una combinaci贸n de funciones independientes y matrices de funciones puede manejar una ruta. Por ejemplo:


var cb0 = function (req, res, next) {
  console.log('CB0');
  next();
}

var cb1 = function (req, res, next) {
  console.log('CB1');
  next();
}

app.get('/example/d', [cb0, cb1], function (req, res, next) {
  console.log('the response will be sent by the next function ...');
  next();
}, function (req, res) {
  res.send('Hello from D!');
});

M茅todos de respuesta

Los m茅todos en el objeto de respuesta (res) de la tabla siguiente pueden enviar una respuesta al cliente y terminar el ciclo de solicitud/respuestas. Si ninguno de estos m茅todos se invoca desde un manejador de rutas, la solicitud de cliente se dejar谩 colgada.

M茅todo Descripci贸n
res.download() Solicita un archivo para descargarlo.
res.end() Finaliza el proceso de respuesta.
res.json() Env铆a una respuesta JSON.
res.jsonp() Env铆a una respuesta JSON con soporte JSONP.
res.redirect() Redirecciona una solicitud.
res.render() Representa una plantilla de vista.
res.send() Env铆a una respuesta de varios tipos.
res.sendFile Env铆a un archivo como una secuencia de octetos.
res.sendStatus() Establece el c贸digo de estado de la respuesta y env铆a su representaci贸n de serie como el cuerpo de respuesta.

app.route()

Puede crear manejadores de rutas encadenables para una v铆a de acceso de ruta utilizando app.route(). Como la v铆a de acceso se especifica en una 煤nica ubicaci贸n, la creaci贸n de rutas modulares es muy 煤til, al igual que la reducci贸n de redundancia y errores tipogr谩ficos. Para obtener m谩s informaci贸n sobre las rutas, consulte: Documentaci贸n de Router().

A continuaci贸n, se muestra un ejemplo de manejadores de rutas encadenados que se definen utilizando app.route().


app.route('/book')
  .get(function(req, res) {
    res.send('Get a random book');
  })
  .post(function(req, res) {
    res.send('Add a book');
  })
  .put(function(req, res) {
    res.send('Update the book');
  });

express.Router

Utilice la clase express.Router para crear manejadores de rutas montables y modulares. Una instancia Router es un sistema de middleware y direccionamiento completo; por este motivo, a menudo se conoce como una 鈥渕iniaplicaci贸n鈥.

El siguiente ejemplo crea un direccionador como un m贸dulo, carga una funci贸n de middleware en 茅l, define algunas rutas y monta el m贸dulo de direccionador en una v铆a de acceso en la aplicaci贸n principal.

Cree un archivo de direccionador denominado birds.js en el directorio de la aplicaci贸n, con el siguiente contenido:


var express = require('express');
var router = express.Router();

// middleware that is specific to this router
router.use(function timeLog(req, res, next) {
  console.log('Time: ', Date.now());
  next();
});
// define the home page route
router.get('/', function(req, res) {
  res.send('Birds home page');
});
// define the about route
router.get('/about', function(req, res) {
  res.send('About birds');
});

module.exports = router;

A continuaci贸n, cargue el m贸dulo de direccionador en la aplicaci贸n:


var birds = require('./birds');
...
app.use('/birds', birds);

La aplicaci贸n ahora podr谩 manejar solicitudes a /birds y /birds/about, as铆 como invocar la funci贸n de middleware timeLog que es espec铆fica de la ruta.