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

Перекодировка в 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/Response.pm	Tue Dec 20 23:00:30 2011 +0300
+++ b/Lib/IMPL/Web/Application/Response.pm	Fri Dec 30 23:40:00 2011 +0300
@@ -14,7 +14,7 @@
 #todo: add binary method to set a binary encoding, set it automatic when type isn't a text 
 
 BEGIN {
-	#      
+	# автозаполнение буде происходить в порядке объявления
 	public property query => prop_get | owner_set; # cgi query
 	public property status => prop_all, { validator => \&_checkHeaderPrinted };
 	public property contentType => prop_all, { validator => \&_checkHeaderPrinted }; # String
@@ -192,84 +192,84 @@
 
 =head1 NAME
 
-C<IMPL::Web::Application::Response> -     .
+C<IMPL::Web::Application::Response> - Ответ веб сервера непосредственно клиенту.
 
 =head1 DESCRIPTION
 
 C<[Infrastructure]>
 
-       .
+Позволяет сформировать основные свойства заголовка и тело ответа.
 
-  C<IMPL::Web::Application::Action>    .
+Создается объектом C<IMPL::Web::Application::Action> в процессе обработки запроса.
 
-   C<IMPL::Web::QueryHandler>    .
+Может использоваться обработчиками C<IMPL::Web::QueryHandler> в процессе выполнения запроса.
 
-      ,     
-   .  C< isHeaderPrinted >     
-  . 
+Объект позволяет буфферизировать вывод в тело ответа, что позволяет отменить или изменить
+ответ в последний момент. Свойство C< isHeaderPrinted >  используется для определения факта
+отправлки данных клиенту. 
 
 =head1 PROPERTIES
 
 =head2 HTTP Header
 
-    HTTP .         
-   .      C< IMPL::InvalidOperationException >.
+Свойства отвечающие за заголовок HTTP ответа. Эти своства могут быть изменены до тех пор пока
+не будет отправлен заголовок. В противном случае выдается исключение C< IMPL::InvalidOperationException >.
 
 =over
 
 =item C< [get] query >
 
-CGI ,     ,   .  .
+CGI запрос, который используется для вывода данных, заголовка и пр. Существует всегда.
 
 =item C< [get,set] status >
 
-  HTTP. , '200 OK'.    ,      '200 '.
+Код ошибки HTTP. Например, '200 OK'. По умолчанию не установлен, при отправке клиенту бедт отправлен '200 ОК'.
 
 =item C< [get,set] contentType >
 
- MIME.    ,  'text/html'.
+Тип MIME. По умолчанию не установлен, подразумивается 'text/html'.
 
 =item C< [get,set] charset >
 
-,   query->charset.
+Кодировка, синоним свойства query->charset.
 
 =item C< [get,set] expires >
 
-   ,  '+10m'.       .
+Определяет время жизни контента, например '+10m'. По умолчанию не задано и не передается.
 
 =item C< [get,set] cookies >
 
-   cookies,  C< { cart => ['foo','bar'], display => 'list' } >.
+Хеш массив с cookies, например C< { cart => ['foo','bar'], display => 'list' } >.
 
 =back
 
 =head2 Response behaviour
 
-    .
+Свойства отвечающие за поведение ответа.
 
 =over
 
 =item C< [get,set] buffered >
 
-C< True > -             C< Complete >,
-       C< Complete >. 
+C< True > - то тело ответа пишется в буффер и будет отправлено при вызове метода C< Complete >,
+заголовок также будет отправлен после вызова метода C< Complete >. 
 
-C< False > -        ,   
-       C< streamBody >
+C< False > - тело ответа пишется непосредственно в поток к клиенту, при этом заголовок
+будет отправлен при первом обращении к свойству C< streamBody >
 
-             .
+Это свойство можно менять до первого обращения к потоку для записи в тело ответа.
 
 =item C< [get] streamOut >
 
-  CGI .
+Стандартный вывод CGI приложения.
 
 =item C< [get] streamBody >
 
-     .
+Поток для записи в тело ответа.
 
 =item C< [get] isHeaderPrinted >
 
- ,      .
+Признак того, что заголовок уже был отправлен клиенту.
 
 =back
 
@@ -279,18 +279,18 @@
 
 =item C< Complete >
 
-  .
+Завершает отправку ответа.
 
 =item C< Discard >
 
-  ,      (, )
-  ,    STDERR.
+Отменяет отправку ответа, при этом если часть данных (например, заголовок)
+уже была отправлена, выдает предупреждение в STDERR.
 
 =back
 
 =head1 REMARKS
 
-   , ..      
-  .
+Данный объект является автозаполняемым, т.е. все его свойства можно задать через
+именованные параметры конструктора.
 
-=cut
\ No newline at end of file
+=cut