annotate Lib/IMPL/Web/QueryHandler/PageFormat.pm @ 106:83e356614c1e

DOM Builder now is a navigator like SimpleBuilder PostToDOM transformation
author wizard
date Wed, 12 May 2010 17:52:12 +0400
parents 964587c5183c
children 0e72ad99eef7
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->() );
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
40 {
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
41 local $@;
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
42 $doc->AddVar( user => eval { IMPL::Security::Context->current->principal; } );
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
43 $doc->AddVar( session => eval { IMPL::Security::Context->current; } );
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
44 warn $@ if $@;
964587c5183c Added SecureCall to Web QueryHandlers stack
wizard
parents: 77
diff changeset
45 }
63
76b878ad6596 Added serialization support for the IMPL::Object::List
wizard
parents: 62
diff changeset
46
76b878ad6596 Added serialization support for the IMPL::Object::List
wizard
parents: 62
diff changeset
47 $action->response->contentType('text/html');
76b878ad6596 Added serialization support for the IMPL::Object::List
wizard
parents: 62
diff changeset
48 my $hOut = $action->response->streamBody;
76b878ad6596 Added serialization support for the IMPL::Object::List
wizard
parents: 62
diff changeset
49 print $hOut $doc->Render();
76b878ad6596 Added serialization support for the IMPL::Object::List
wizard
parents: 62
diff changeset
50 } finally {
76b878ad6596 Added serialization support for the IMPL::Object::List
wizard
parents: 62
diff changeset
51 $doc->Dispose;
76b878ad6596 Added serialization support for the IMPL::Object::List
wizard
parents: 62
diff changeset
52 };
62
c64bd1bf727d Web application
wizard
parents:
diff changeset
53 }
c64bd1bf727d Web application
wizard
parents:
diff changeset
54
65
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
55 1;
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
56
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
57 __END__
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
58
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
59 =pod
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
60
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
61 =head1 NAME
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
62
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
63 C<IMPL::Web::QueryHandler::PageFormat> - Выдача результатов в виде HTML страницы, построенной из шаблона.
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
64
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
65 =head1 SYNOPSIS
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
66
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 =begin code xml
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
70
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
71 <handlersQuery type="IMPL::Object::List">
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
72 <item type="IMPL::Web::QueryHandler::PageFormat">
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
73 <charsetTemplates>utf-8</charsetTemplates>
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
74 </item>
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
75 </handlersQuery>
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
76
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
77 =end code xml
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
78
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 =begin code
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
82
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
83 my $app = new IMPL::Web::Application();
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
84 $app->handlersQuery->Add(
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
85 new IMPL::Web::QueryHandler::PageFormat( charsetTemplates=> 'utf-8' );
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
86 );
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
87
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
88 =end
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
89
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
90 =head1 DESCRIPTION
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
91
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
92 Обработчик запроса для веб приложения. Загружает шаблон, путь к котрому берется
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
93 из C<ENV{PATH_INFO}> относительно пути из свойства C<templatesBase>.
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
94
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
95 Наследуется от C<IMPL::Web::QueryHandler> для реализации функционала
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
96 обработчика запроса и переопределяет метод C<Process>.
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
97
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
98 C<Serializable>
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
99
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
100 =head1 MEMBERS
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
101
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
102 =over
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
103
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
104 =item C<CTOR(%props)>
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
105
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 =item C<[get,set] templatesCharset>
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
109
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
110 Кодировка шаблонов. По умолчанию utf-8.
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
111
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
112 =item C<[get,set] templatesBase>
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
113
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 =item C<[override] Process($action,$nextHandler)>
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
117
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
118 Метод, переопределяющий C<IMPL::Web::QueryHandler->Process> и которому передается управление
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
119 для выполнения действий.
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
120
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
121 =back
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
122
2840c4c85db8 Application configuration improvements
wizard
parents: 64
diff changeset
123 =cut