annotate Lib/IMPL/Web/QueryHandler/PageFormat.pm @ 111:6c25ea91c985

ControllerUnit concept
author wizard
date Tue, 18 May 2010 01:33:37 +0400
parents 0e72ad99eef7
children 1722ca51537c
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
62
c64bd1bf727d Web application
wizard
parents:
diff changeset
1 package IMPL::Web::QueryHandler::PageFormat;
64
259cd3df6e53 Doc generation
wizard
parents: 63
diff changeset
2 use base qw(IMPL::Web::QueryHandler IMPL::Object::Autofill);
62
c64bd1bf727d Web application
wizard
parents:
diff changeset
3
c64bd1bf727d Web application
wizard
parents:
diff changeset
4 __PACKAGE__->PassThroughArgs;
c64bd1bf727d Web application
wizard
parents:
diff changeset
5
c64bd1bf727d Web application
wizard
parents:
diff changeset
6 use IMPL::Class::Property;
77
9d24db321029 Refactoring Web::TT
wizard
parents: 65
diff changeset
7 use IMPL::Web::TT::Document;
97
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
8 use IMPL::Security::Context;
65
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
9 use File::Spec;
63
76b878ad6596 Added serialization support for the IMPL::Object::List
wizard
parents: 62
diff changeset
10 use Error qw(:try);
62
c64bd1bf727d Web application
wizard
parents:
diff changeset
11
64
259cd3df6e53 Doc generation
wizard
parents: 63
diff changeset
12 BEGIN {
65
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
13 public property templatesCharset => prop_all;
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
14 public property templatesBase => prop_all;
97
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
15 public property defaultTarget => prop_all;
64
259cd3df6e53 Doc generation
wizard
parents: 63
diff changeset
16 }
259cd3df6e53 Doc generation
wizard
parents: 63
diff changeset
17
259cd3df6e53 Doc generation
wizard
parents: 63
diff changeset
18 sub CTOR {
259cd3df6e53 Doc generation
wizard
parents: 63
diff changeset
19 my ($this) = @_;
259cd3df6e53 Doc generation
wizard
parents: 63
diff changeset
20
65
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
21 $this->templatesCharset('utf-8') unless $this->templatesCharset;
64
259cd3df6e53 Doc generation
wizard
parents: 63
diff changeset
22 }
259cd3df6e53 Doc generation
wizard
parents: 63
diff changeset
23
62
c64bd1bf727d Web application
wizard
parents:
diff changeset
24 sub Process {
c64bd1bf727d Web application
wizard
parents:
diff changeset
25 my ($this,$action,$nextHandler) = @_;
c64bd1bf727d Web application
wizard
parents:
diff changeset
26
77
9d24db321029 Refactoring Web::TT
wizard
parents: 65
diff changeset
27 my $doc = new IMPL::Web::TT::Document();
62
c64bd1bf727d Web application
wizard
parents:
diff changeset
28
63
76b878ad6596 Added serialization support for the IMPL::Object::List
wizard
parents: 62
diff changeset
29 try {
97
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
30
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
31 $this->templatesBase($ENV{DOCUMENT_ROOT}) unless $this->templatesBase;
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
32
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
33 my $pathInfo = $ENV{PATH_INFO};
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
34 local $ENV{PATH_INFO} = $pathInfo || $this->defaultTarget;
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
35
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
36 my @path = split /\//, ($ENV{PATH_INFO} || '') or die new IMPL::Exception("PATH_INFO is empty and no defaultTarget specified" );
65
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
37
77
9d24db321029 Refactoring Web::TT
wizard
parents: 65
diff changeset
38 $doc->LoadFile ( File::Spec->catfile($this->templatesBase,@path), $this->templatesCharset );
97
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
39 $doc->AddVar( result => $nextHandler->() );
107
0e72ad99eef7 Updated Web::TT
wizard
parents: 97
diff changeset
40 $doc->AddVar( absoluteUrl => sub { "/$_[0]" } );
97
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
41 {
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
42 local $@;
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
43 $doc->AddVar( user => eval { IMPL::Security::Context->current->principal; } );
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
44 $doc->AddVar( session => eval { IMPL::Security::Context->current; } );
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
45 warn $@ if $@;
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
46 }
63
76b878ad6596 Added serialization support for the IMPL::Object::List
wizard
parents: 62
diff changeset
47
76b878ad6596 Added serialization support for the IMPL::Object::List
wizard
parents: 62
diff changeset
48 $action->response->contentType('text/html');
76b878ad6596 Added serialization support for the IMPL::Object::List
wizard
parents: 62
diff changeset
49 my $hOut = $action->response->streamBody;
76b878ad6596 Added serialization support for the IMPL::Object::List
wizard
parents: 62
diff changeset
50 print $hOut $doc->Render();
76b878ad6596 Added serialization support for the IMPL::Object::List
wizard
parents: 62
diff changeset
51 } finally {
76b878ad6596 Added serialization support for the IMPL::Object::List
wizard
parents: 62
diff changeset
52 $doc->Dispose;
76b878ad6596 Added serialization support for the IMPL::Object::List
wizard
parents: 62
diff changeset
53 };
62
c64bd1bf727d Web application
wizard
parents:
diff changeset
54 }
c64bd1bf727d Web application
wizard
parents:
diff changeset
55
65
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
56 1;
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
57
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
58 __END__
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
59
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
60 =pod
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
61
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
62 =head1 NAME
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
63
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
64 C<IMPL::Web::QueryHandler::PageFormat> - Выдача результатов в виде HTML страницы, построенной из шаблона.
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
65
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
66 =head1 SYNOPSIS
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
67
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
68 В файле конфигурации приложения
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
69
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
70 =begin code xml
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
71
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
72 <handlersQuery type="IMPL::Object::List">
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
73 <item type="IMPL::Web::QueryHandler::PageFormat">
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
74 <charsetTemplates>utf-8</charsetTemplates>
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
75 </item>
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
76 </handlersQuery>
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
77
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
78 =end code xml
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
79
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
80 Программно
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
81
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
82 =begin code
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
83
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
84 my $app = new IMPL::Web::Application();
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
85 $app->handlersQuery->Add(
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
86 new IMPL::Web::QueryHandler::PageFormat( charsetTemplates=> 'utf-8' );
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
87 );
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
88
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
89 =end
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
90
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
91 =head1 DESCRIPTION
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
92
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
93 Обработчик запроса для веб приложения. Загружает шаблон, путь к котрому берется
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
94 из C<ENV{PATH_INFO}> относительно пути из свойства C<templatesBase>.
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
95
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
96 Наследуется от C<IMPL::Web::QueryHandler> для реализации функционала
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
97 обработчика запроса и переопределяет метод C<Process>.
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
98
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
99 C<Serializable>
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
100
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
101 =head1 MEMBERS
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
102
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
103 =over
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
104
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
105 =item C<CTOR(%props)>
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
106
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
107 Создает новый экземпляр и заполняет свойства.
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
108
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
109 =item C<[get,set] templatesCharset>
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
110
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
111 Кодировка шаблонов. По умолчанию utf-8.
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
112
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
113 =item C<[get,set] templatesBase>
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
114
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
115 Каталог относительно которого ищется шаблон.
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
116
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
117 =item C<[override] Process($action,$nextHandler)>
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
118
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
119 Метод, переопределяющий C<IMPL::Web::QueryHandler->Process> и которому передается управление
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
120 для выполнения действий.
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
121
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
122 =back
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
123
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
124 =cut