/{db}/_design/{ddoc}/_rewrite/{path}

Использование функции в виде строки для rewrites

function(req2) {
  var path = req2.path.slice(4),
    isWrite = /^(put|post|delete)$/i.test(req2.method),
    isFinance = req2.userCtx.roles.indexOf("finance") > -1;
  if (path[0] == "finance" && isWrite && !isFinance) {
    // Deny writes to  DB "finance" for users
    // having no "finance" role
    return {
      code: 403,
      body: JSON.stringify({
        error: "forbidden".
        reason: "You are not allowed to modify docs in this DB"
      })
    };
  }
  // Pass through all other requests
  return { path: "../../../" + path.join("/") };
}

function(req2) {
  var path = req2.path.slice(4),
    h = headers,
    wantsJson = (h.Accept || "").indexOf("application/json") > -1,
    reply = {};
  if (!wantsJson) {
    // Here we should prepare reply object
    // for plain HTML pages
  } else {
    // Pass through JSON requests
    reply.path = "../../../"+path.join("/");
  }
  return reply;
}

Использование массива правил для rewrites

Если поле rewrites содержит массив объектов правил, сервер перезаписывает запрос согласно первому подходящему правилу в массиве.

Каждое правило в массиве — это объект со следующими полями:

• method (строка): HTTP-метод запроса, которому должен соответствовать метод запроса для применения правила. Если поле не указано, используется "*", который соответствует всем методам.

• from (строка): шаблон для сравнения с URL и определения динамических переменных.

• to (строка): путь, на который следует перезаписать URL. Он может содержать переменные, определённые при сопоставлении с шаблоном, а также аргументы запроса (аргументы URL и аргументы из элемента query).

• query (объект): аргументы запроса, передаваемые в перезаписанный URL. Они могут содержать динамические переменные.

Пути to и from могут содержать строковые шаблоны с символами : или * в начале для определения динамических переменных при сопоставлении.

Для определения перезаписи используется первое правило в массиве rewrites, соответствующее входящему запросу. Чтобы правило соответствовало входящему запросу, его значение method должно совпадать с HTTP-методом запроса, а значение from — с путём запроса согласно следующей логике сопоставления шаблонов.

• Сначала шаблон from и URL разделяются по / на список токенов. Например, если поле from имеет значение /somepath/:var/*, а URL — /somepath/a/b/c, то токены шаблона from — это somepath, :var и *, а токены URL — somepath, a, b и c.

• Каждый токен шаблона, начинающийся с :, сопоставляется с соответствующим токеном URL и задаёт новую динамическую переменную: её имя — оставшаяся после : строка, а значение — токен из URL. В этом примере токен :var сопоставится с b и задаст var = a.

• Токен-звёздочка * в шаблоне сопоставляется с любым количеством токенов URL и должен быть последним токеном в шаблоне. Он задаёт динамическую переменную, содержащую оставшиеся токены. В этом примере токен * сопоставится с токенами b и c и задаст * = b/c.

• Чтобы шаблон считался соответствующим, остальные токены должны совпадать в точности. В этом примере somepath в шаблоне совпадает с somepath в URL, и все токены URL сопоставлены, поэтому это правило считается подходящим.

После обнаружения правила URL запроса перезаписывается с использованием полей to и query. Динамические переменные подставляются в переменные : и * в этих полях для формирования итогового URL.

Если подходящее правило не найдено, возвращается ответ 404 Not Found.

Примеры:

Правило	URL	Перезаписать на	Токены
{“from”: “/a”, “to”: “/some”}	/a	/some
{“from”: “/a/*”, “to”: “/some/*}	/a/b/c	/some/b/c
{“from”: “/a/b”, “to”: “/some”}	/a/b?k=v	/some?k=v	k=v
{“from”: “/a/b”, “to”: “/some/:var”}	/a/b	/some/b?var=b	var=b
{“from”: “/a/:foo/”, “to”: “/some/:foo/”}	/a/b/c	/some/b/c?foo=b	foo=b
{“from”: “/a/:foo”, “to”: “/some”, “query”: { “k”: “:foo” }}	/a/b	/some/?k=b&foo=b	foo=b
{“from”: “/a”, “to”: “/some/:foo”}	/a?foo=b	/some/?b&foo=b	foo=b

Метод запроса, заголовки, параметры запроса, данные запроса и тело ответа зависят от конечной точки, на которую будет перенаправлен URL.

param db:

Имя базы данных

param ddoc:

Имя дизайн-документа

param path:

Путь URL для перезаписи