CGI::Application. Основные методы приложений CGI::ApplicationPerl, Python — блог программиста

Частичный перевод CGI::Application / Essential Application Methods .
Это только одна из четырех частей перевода. Остальные будут опубликованы позднее.
Как всегда — все примеры кода — авторские.

P.S. Если кто-нибудь подскажет, как корректно перевести на русский «Essential Application Methods» — буду очень признательна.

Поскольку, я — поклонница Template Toolkit, и не вижу особого смысла использовать иные системы шаблонов, если TT доступен, в данном документе опущено описание методов load_tmpl() и tmpl_path().

param()
query()
run_modes()
start_mode()

param()

$self->param('step', 'on_get_result'); # устанавливаем значение параметру
my $step = $self->param('step'); # получаем значение параметра

1 2	$self->param('step', 'on_get_result'); # устанавливаем значение параметру my $step = $self->param('step'); # получаем значение параметра

Метод param() может использоваться для получения значений параметров, или для установки нужных значений определенным параметрам. Если установить значения параметров из метода setup — эти значения станут доступны из любой части кода приложения, так же, как и самые обычные значения параметров.

Если вызвать param() в контексте списка, метод вернет полный список всех существующих в данный момент параметров.

my @params = $self->param();

1	my @params = $self->param();

Не стоит путать этот метод с методом param() модуля CGI.

query()

my $q = $self->query();
my $day = $q->param('day');

1 2	my $q = $self->query(); my $day = $q->param('day');

Метод query() возвращает ссылку на объект query модуля CGI.pm . Сам объект создается при вызове метода new() CGI::Application.

Используется метод query(), как и обычно, для доступа к данным, которые передает клиент.

run_modes()

$self->run_modes(
	on_get_result	=> \&on_get_result, # указываем ссылку на метод
	on_start	=> 'on_start', # указываем имя метода
	AUTOLOAD	=> sub { return 'Запрошенной страницы не существует' }
);

$self->run_modes(

on_get_result => \&on_get_result, # указываем ссылку на метод

on_start => 'on_start', # указываем имя метода

AUTOLOAD => sub { return 'Запрошенной страницы не существует' }

);

Метод определяет таблицу соответствия возможных режимов (статусов) работы приложения и подпрограмм, которые выполняются, при запуске приложения в определенном режиме.

run_modes() можно вызывать неограниченное число раз. Указанные режимы и подпрограммы будут добавлены к уже существующему списку. Если одному и тому же режиму назначаются в соответствие поочередно 2 и более разных подпрограмм — в итоге будет вызываться последний назначенный вариант.

Подготовленная методом run_modes() таблица используется методом run() для запуска требуемых функций и передачи им параметров запроса.

От назначенных методом run_modes() подпрограмм ожидается, что они вернут текстовый блок информации (например, готовый код html-страницы), который без дополнительных преобразований будет отправлен клиенту.

start_mode()

$self->start_mode('on_start');

1	$self->start_mode('on_start');

Метод start_mode() назначает режим (один из определенных в списке run_modes() ), который будет вызываться по-умолчанию, когда клиент не указал нужный режим в списке передаваемых параметров.

Если режим не назначен с помощью start_mode(), CGI::Application в подобных случаях будет по-умолчанию вызывать режим «start».