Цепочка обязанностей на Lua

Паттерны проектирования / Поведенческие паттерны

-- ConcreteHandlers: a handler answers its own
-- request and returns nothing for the others
local function firefighter(code)
  if code == 1 then
    return "call firefighters"
  end
end

local function police(code)
  if code == 2 then
    return "call the police"
  end
end

local function ambulance(code)
  if code == 3 then
    return "call an ambulance"
  end
end

-- The chain is an array: the handlers
-- are asked in this order
local rescuers = {firefighter, police, ambulance}

-- HandleRequest(): the first answer ends the walk
local function help(code)
  for _, rescuer in ipairs(rescuers) do
    local answer = rescuer(code)
    if answer then
      return answer
    end
  end
  return "nobody handles code " .. code
end

-- Client
local answer1 = help(1)
-- answer1 = call firefighters
local answer2 = help(2)
-- answer2 = call the police
local answer3 = help(3)
-- answer3 = call an ambulance
local answer9 = help(9)
-- answer9 = nobody handles code 9

print("answer1 = " .. answer1)
print("answer2 = " .. answer2)
print("answer3 = " .. answer3)
print("answer9 = " .. answer9)

Можно избежать жесткой зависимости отправителя запроса от его получателя, при этом запросом начинает обрабатываться один из нескольких объектов. Объекты-получатели связываются в цепочку, и запрос передается по цепочке, пока какой-то объект его не обработает.

Задача. В службу поддержки приходят запросы разного масштаба. Мелкий идёт к помощнику, покрупнее - к менеджеру, совсем крупный - к директору. Если бы код, который отправляет запрос, сам выбирал получателя, ему пришлось бы знать каждого получателя и каждое правило. Каждый новый получатель требовал бы правки в отправителе.

Идея. Получатели, их называют обработчиками, выстроены в заданном порядке: это и есть цепочка. Отправитель отдаёт запрос только первому обработчику. Каждый обработчик проверяет, его ли это запрос. Если его, обработчик делает работу, и дальше запрос не идёт. Если нет, обработчик передаёт запрос следующему. Отправитель не знает, какой обработчик ответит и ответит ли кто-нибудь вообще.

Как читать пример. Несколько обработчиков соединены в цепочку. Каждый по своему правилу решает, его ли это запрос. Клиентский код отправляет несколько запросов, всегда в начало цепочки. Каждый запрос движется по цепочке, пока какой-нибудь обработчик его не примет. В большинстве языков каждый обработчик хранит ссылку на следующий; в некоторых цепочка - простой список, который проверяют по порядку. Некоторые примеры отправляют ещё и запрос, который не принимает ни один обработчик, и вывод об этом сообщает.

Когда применять. Цепочка нужна, когда запрос могут обработать несколько объектов, а их набор или порядок может меняться. Если получатель всегда один и тот же, она ни к чему: прямой вызов проще и понятнее.

Частая ошибка. Забыть о конце цепочки. Тогда запрос, который не принял ни один обработчик, пропадает без единого сообщения. Нужно решить, что происходит в конце: ошибка, обработчик по умолчанию или внятное сообщение.