Mercurial > pub > Impl

diff Lib/IMPL/Web/Application/Action.pm @ 180:d1676be8afcc

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Перекодировка в utf-8
author sourcer
date Fri, 30 Dec 2011 23:40:00 +0300
parents aaab45153411
children 4d0e1962161c
line wrap: on
line diff
--- a/Lib/IMPL/Web/Application/Action.pm	Tue Dec 20 23:00:30 2011 +0300
+++ b/Lib/IMPL/Web/Application/Action.pm	Fri Dec 30 23:40:00 2011 +0300
@@ -120,17 +120,17 @@
 
 =head1 NAME
 
-C<IMPL::Web::Application::Action> -   C<CGI> .
+C<IMPL::Web::Application::Action> - Обертка вокруг C<CGI> запроса.
 
 =head1 DESCRIPTION
 
 C<[Infrastructure]>
 
-   .    
- ,      .
-   ,   .
+Определяет порядок выполнения запроса. Запрос выполняется последовательным вызовом
+цепочки обработчиков, при этом обработчики сами вызывают следующие.
+Обработчики выполняются в порядке, обратном их добавлению.
 
-    ,   
+Типичная цепочка может быть такой, в порядке добавления
 
 =begin code
 
@@ -140,7 +140,7 @@
 
 =end code
 
-    
+что приведет к следующей последовательности
 
 =begin code
 
@@ -207,7 +207,7 @@
 
 =end code
 
-     
+или как альтернатива может быть еще
 
 =begin code
 
@@ -219,9 +219,9 @@
 
 =end code
 
-      ,     
-     JSON .    
-     ,     .
+В данной цепочке также происходит вызов метода, но его результат потом преобразуется
+в простые структуры и передается JSON преобразователю. Таким образом модулю логики
+не требуется знать о выходном формате, всю работу проделают дополнительные фильтры.
 
 =head1 MEMBERS
 
@@ -231,23 +231,23 @@
 
 =item C< [get] application>
 
-    
+Экземпляр приложения создавшего текущий объект
 
 =item C< [get] query >
 
- C<CGI> 
+Экземпляр C<CGI> запроса
 
 =item C< [get] response >
 
-  C<CGI>  C<IMPL::Web::Application::Response>
+Ответ на C<CGI> заспрос C<IMPL::Web::Application::Response>
 
 =item C< [get] responseFactory >
 
-   ,     
-     C<IMPL::Web::Application::Action>,
-    C<ReinitResponse>   .
+Фабрика ответов на запрос, используется для создания нового ответа
+либо при конструировании текущего объекта C<IMPL::Web::Application::Action>,
+либо при вызове метода C<ReinitResponse> у текущего объекта.
 
-    C<IMPL::Web::Application::Response>
+По умолчанию имеет значение C<IMPL::Web::Application::Response>
 
 =back
 
@@ -257,17 +257,17 @@
 
 =item C< ReinitResponse() >
 
-   C<response>     .
+Отмена старого ответа C<response> и создание вместо него нового.
 
-      , 
-    .  ,
-    ,     
- .    C<IMPL::InvalidOperationException>.
+Данная операция обычно проводится при обработке ошибок, когда
+уже сформированный ответ требуется отменить. Следует заметить,
+что эта операция не возможна, если ответ частично или полностью
+отправлен клиенту. Тогда возникает исключение C<IMPL::InvalidOperationException>.
 
 =item C< ChainHandler($handler) >
 
-    .     ,
-     . 
+Добавляет новый обработчик в цепочку. Выполнение цепочки начинается с конца,
+тоесть последний добавленный будет выполнен первым. 
 
 =back
 
@@ -279,22 +279,22 @@
 
 =item CODE ref
 
-     ,      
- :   action ,     .
+Ссылка на процедуру может являться обработчиком, при этом функция будет вызвана с
+двумя параметрами: ссылкой на action объект, и точкой входа следующего обработчика.
 
 =item Method Name
 
- ,    .    action   
- ,           
-:   action ,     .
+Имя метода, передается в виде строки. У текущего объекта action ищется метод с
+указанным именем, после чего используется ссылка на этот метод для вызова с двумя
+параметрами: ссылкой на action объект, и точкой входа следующего обработчика.
 
-    C<< $action->MethodName($nextHandler) >>; 
+Получается вызов идентичный следующему C<< $action->MethodName($nextHandler) >>; 
 
 =back 
 
 =head2 C< IMPL::Web::QueryHandler >
 
-    C< IMPL::Web::QueryHandler >  
-    
+Любой объект наследованный от C< IMPL::Web::QueryHandler > может быть
+использован в качестве обработчика запроса
 
-=cut
\ No newline at end of file
+=cut