Методы

Примечание: логика работы Catalyst с движками, изменилась, начиная с версии 5.9. В данном случае по большей части рассматривается версия 5.8. Начиная с версии Catalyst 5.9 прекратилась поддержка множества движков, в том числе был удален модуль Catalyst::Engine::HTTP .

$self->finalize_body($c)

Получает подготовленный $c->response->body и пишет данные в буфер, на вывод.

$self->finalize_cookies($c)

Создает объект CGI::Simple::Cookie на основе $c->res->cookies, и добавляет cookies в заголовки ответа.

$self->finalize_error($c)

Метод формирует html-страницу для вывода сообщения об ошибке, передает ее объекту Response - $c->res->{body}.

Выведет ошибку, если Catalyst находится в режиме отладки (установлен $c->debug), или сообщение 'please come back later' в другом случае.

Вызывается в модуле Catalyst.pm :

$self->finalize_headers($c)

Абстрактный метод, переопределяется в конкретных движках. Позволяет движкам записать отправить в ответе заголовки.

$self->finalize_uploads($c)

Удаление временных файлов после выполненных загрузок.

$self->prepare_body($c)

Устанавливает Catalyst::Request с использованием HTTP::Body.

$self->prepare_body_chunk($c)

Считывает блок входящих данных и добавляет его в тело запроса.

prepare_connection($c)

Абстрактный метод, реализуется в конкретном движке.

$self->prepare_path($c)

Абстрактный метод, реализуется в конкретном движке.

$self->prepare_request($c)

$self->prepare_query_parameters($c)

Обрабатывает строку запроса и извлекает из нее параметры. Добавляет параметры в $c->request().

$self->prepare_read($c)

Подготовка к чтению входящих данных из сокета.

$self->prepare_request(@arguments)

Заполняет context-объект данными из объекта запроса.

$self->prepare_uploads($c)

Подготавливает загружаемые данные для дальнейшей работы.

$self->write($c, $buffer)

Абстрактный метод, реализуется в движке. Делает запись в буфер клиента.

$self->read($c, [$maxlength])

Читает данные из входящего потока с помощью вызова "$self->read_chunk".

$self->read_chunk($c, \$buffer, $length)

Метод read_chunk реализуется в конкретном движке. Метод должен выполнять чтение блока данных из входящего потока.

$self->run($app, $server)

Метод должен быть переопределен в конкретном движке. Запускает движок. Создает сокеты, организует процесс приема запросов, их обработки и отправки ответов клиентам.

В Catalyst версии 5.9 работа этого метода уже организована по-другому.

$self->unescape_uri($uri)

Возвращает непреобразованный URI.

$self->env

Хэш содержащий информацию о переменных окружения, включая многие специальные переменные, добавленные сервером, такие как SERVER_*, REMOTE_*, HTTP_* и т.д.

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

Попытка разобраться в логике запуска стандартного сервера Catalyst-приложения.

Ниже приведено очень много кода из модулей Catalyst-фреймворка и простого Catalyst-приложения. Весь код приведен с большими сокращениями.

Читать далее →

Модуль отвечает за загрузку и запуск скриптов в пространстве имен приложения (например, MyApp::Script::Server), или в пространстве имен Catalyst (например, Catalyst::Script::Server).

Читать далее →

Catalyst::Stats - класс Catalyst, работа со статистикой, измерение времени выполнения отдельных экшенов.

Модуль Catalyst::Stats используется по-умолчанию, для вывода информации в логе Сatalyst-приложения. Если вы хотите заменить стандартный модуль чем-то своим, понадобится внести изменения в конфиг MyApp.pm:

Читать далее →