annotate Lib/IMPL/Web/View/TTDocument.pm @ 290:7b0dad6117d5

*TTView: fixed memory leak
author sergey
date Wed, 20 Feb 2013 17:24:57 +0400
parents 85572f512abc
children 5d14baa35790
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
1 package IMPL::Web::View::TTDocument;
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
2 use strict;
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
3
236
2904da230022 DOM refactoring
sergey
parents: 234
diff changeset
4 use Scalar::Util qw(weaken);
2904da230022 DOM refactoring
sergey
parents: 234
diff changeset
5 use IMPL::Const qw(:prop);
288
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
6 use IMPL::lang qw(:hash is);
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
7 use Carp qw(carp);
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
8 use mro;
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
9
236
2904da230022 DOM refactoring
sergey
parents: 234
diff changeset
10 use IMPL::declare {
2904da230022 DOM refactoring
sergey
parents: 234
diff changeset
11 require => {
2904da230022 DOM refactoring
sergey
parents: 234
diff changeset
12 TTFactory => 'IMPL::Web::View::TTFactory',
2904da230022 DOM refactoring
sergey
parents: 234
diff changeset
13 TTControl => 'IMPL::Web::View::TTControl',
2904da230022 DOM refactoring
sergey
parents: 234
diff changeset
14 Loader => 'IMPL::Code::Loader'
2904da230022 DOM refactoring
sergey
parents: 234
diff changeset
15 },
2904da230022 DOM refactoring
sergey
parents: 234
diff changeset
16 base => [
2904da230022 DOM refactoring
sergey
parents: 234
diff changeset
17 'IMPL::Web::View::TTControl' => sub {
287
2d253e6e4a88 *TTView refactoring
cin
parents: 286
diff changeset
18 my ($template,$ctx) = @_;
288
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
19 $ctx ||= Template::Context->new();
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
20 return 'document', $template, $ctx; # context
236
2904da230022 DOM refactoring
sergey
parents: 234
diff changeset
21 }
2904da230022 DOM refactoring
sergey
parents: 234
diff changeset
22 ],
2904da230022 DOM refactoring
sergey
parents: 234
diff changeset
23 props => [
2904da230022 DOM refactoring
sergey
parents: 234
diff changeset
24 layout => PROP_RW,
2904da230022 DOM refactoring
sergey
parents: 234
diff changeset
25 loader => PROP_RW,
2904da230022 DOM refactoring
sergey
parents: 234
diff changeset
26 ]
2904da230022 DOM refactoring
sergey
parents: 234
diff changeset
27 };
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
28
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
29 sub CTOR {
287
2d253e6e4a88 *TTView refactoring
cin
parents: 286
diff changeset
30 my ($this,$template,$ctx,$loader,$vars) = @_;
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
31
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
32 $this->controls({});
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
33 $this->loader($loader) if $loader;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
34
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
35 $this->layout( $template->layout ) unless $this->layout;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
36
288
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
37 $this->context->stash->update($vars)
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
38 if ref $vars eq 'HASH';
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
39
288
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
40 $this->InitInstance();
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
41 }
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
42
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
43 sub Render {
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
44 my ($this,$args) = @_;
288
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
45
241
f48a1a9f4fa2 +Added ViewResult to allow implementation of the view environment.
sergey
parents: 238
diff changeset
46 $args ||= {};
288
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
47
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
48 my %controls;
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
49 my $require;
289
85572f512abc *TTView refactoring
cin
parents: 288
diff changeset
50 my $documentContext;
290
7b0dad6117d5 *TTView: fixed memory leak
sergey
parents: 289
diff changeset
51
7b0dad6117d5 *TTView: fixed memory leak
sergey
parents: 289
diff changeset
52 my $self = $this;
7b0dad6117d5 *TTView: fixed memory leak
sergey
parents: 289
diff changeset
53
288
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
54 $require = sub {
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
55 my $control = shift;
290
7b0dad6117d5 *TTView: fixed memory leak
sergey
parents: 289
diff changeset
56
7b0dad6117d5 *TTView: fixed memory leak
sergey
parents: 289
diff changeset
57 carp("Cant load control $control outside the rendering procedure") unless $self;
7b0dad6117d5 *TTView: fixed memory leak
sergey
parents: 289
diff changeset
58
288
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
59 if (my $factory = $controls{$control}) {
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
60 return $factory;
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
61 } else {
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
62 my $path = $control;
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
63
290
7b0dad6117d5 *TTView: fixed memory leak
sergey
parents: 289
diff changeset
64 if ( my $template = $self->loader->template($path) ) {
288
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
65
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
66 $factory = new IMPL::Web::View::TTFactory(
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
67 $template->class || TTControl,
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
68 $template,
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
69 $documentContext,
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
70 join( '/', splice( @{[split(/\//,$path)]}, 0, -1 ) ),
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
71 $require
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
72 );
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
73
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
74 if ($template->class) {
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
75 Loader->safe->Require($template->class);
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
76 }
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
77
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
78 $controls{$control} = $factory;
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
79
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
80 return $factory;
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
81
288
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
82 } else {
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
83 die new IMPL::KeyNotFoundException($control);
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
84 }
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
85 }
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
86 };
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
87
289
85572f512abc *TTView refactoring
cin
parents: 288
diff changeset
88 $this->context->localise();
85572f512abc *TTView refactoring
cin
parents: 288
diff changeset
89 $documentContext = _clone_context( $this->context );
290
7b0dad6117d5 *TTView: fixed memory leak
sergey
parents: 289
diff changeset
90
288
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
91 $this->context->stash->set(require => $require);
290
7b0dad6117d5 *TTView: fixed memory leak
sergey
parents: 289
diff changeset
92 $this->context->stash->set(document => sub { $self });
289
85572f512abc *TTView refactoring
cin
parents: 288
diff changeset
93
288
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
94
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
95 my $text = eval {
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
96
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
97 if ($this->layout) {
287
2d253e6e4a88 *TTView refactoring
cin
parents: 286
diff changeset
98 my $tlayout = $this->loader->layout($this->layout);
2d253e6e4a88 *TTView refactoring
cin
parents: 286
diff changeset
99 if(my $init = $tlayout->blocks->{INIT}) {
2d253e6e4a88 *TTView refactoring
cin
parents: 286
diff changeset
100 $this->context->process(
2d253e6e4a88 *TTView refactoring
cin
parents: 286
diff changeset
101 $init,
2d253e6e4a88 *TTView refactoring
cin
parents: 286
diff changeset
102 hashMerge(
288
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
103 $args,
287
2d253e6e4a88 *TTView refactoring
cin
parents: 286
diff changeset
104 {
288
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
105 template => $this->template
287
2d253e6e4a88 *TTView refactoring
cin
parents: 286
diff changeset
106 }
2d253e6e4a88 *TTView refactoring
cin
parents: 286
diff changeset
107 )
2d253e6e4a88 *TTView refactoring
cin
parents: 286
diff changeset
108 );
2d253e6e4a88 *TTView refactoring
cin
parents: 286
diff changeset
109 }
288
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
110 my $content = $this->next::method($args);
287
2d253e6e4a88 *TTView refactoring
cin
parents: 286
diff changeset
111 return $this->context->include(
2d253e6e4a88 *TTView refactoring
cin
parents: 286
diff changeset
112 $tlayout,
2d253e6e4a88 *TTView refactoring
cin
parents: 286
diff changeset
113 {
288
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
114 %{$args},
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
115 content => $content,
287
2d253e6e4a88 *TTView refactoring
cin
parents: 286
diff changeset
116 this => $this,
2d253e6e4a88 *TTView refactoring
cin
parents: 286
diff changeset
117 template => $this->template
2d253e6e4a88 *TTView refactoring
cin
parents: 286
diff changeset
118 }
286
d357b5d85d25 *TTView refactoring
sergey
parents: 285
diff changeset
119 );
288
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
120 } else {
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
121 return $this->next::method($args);
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
122 }
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
123 };
289
85572f512abc *TTView refactoring
cin
parents: 288
diff changeset
124
85572f512abc *TTView refactoring
cin
parents: 288
diff changeset
125 undef $require;
85572f512abc *TTView refactoring
cin
parents: 288
diff changeset
126 undef $documentContext;
85572f512abc *TTView refactoring
cin
parents: 288
diff changeset
127 undef %controls;
290
7b0dad6117d5 *TTView: fixed memory leak
sergey
parents: 289
diff changeset
128 undef $self;
289
85572f512abc *TTView refactoring
cin
parents: 288
diff changeset
129 $this->context->delocalise();
288
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
130
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
131
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
132 my $e = $@;
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
133 if ($e) {
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
134 die $e;
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
135 } else {
288
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
136 return $text;
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
137 }
288
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
138
3a9cfea098dd *TTView refactoring: removed RequireControl method, etc.
sergey
parents: 287
diff changeset
139
190
cd1ff7029a63 IMLP::Web::View refactored, added new method 'require' which is available inside templates. Changed document rendering.
cin
parents: 189
diff changeset
140 }
cd1ff7029a63 IMLP::Web::View refactored, added new method 'require' which is available inside templates. Changed document rendering.
cin
parents: 189
diff changeset
141
289
85572f512abc *TTView refactoring
cin
parents: 288
diff changeset
142 sub _clone_context {
85572f512abc *TTView refactoring
cin
parents: 288
diff changeset
143 my $args = { %{shift || {}} };
85572f512abc *TTView refactoring
cin
parents: 288
diff changeset
144 delete $args->{CONFIG};
85572f512abc *TTView refactoring
cin
parents: 288
diff changeset
145
85572f512abc *TTView refactoring
cin
parents: 288
diff changeset
146 return Template::Context->new($args);
85572f512abc *TTView refactoring
cin
parents: 288
diff changeset
147 }
85572f512abc *TTView refactoring
cin
parents: 288
diff changeset
148
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
149 1;
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
150
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
151 __END__
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
152
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
153 =pod
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
154
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
155 =head1 NAME
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
156
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
157 C<IMPL::Web::View::TTDocument> - документ для построения HTML страницы на основе шаблонов TT.
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
158
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
159 =head1 SYNOPSIS
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
160
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
161 =begin code
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
162
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
163 use IMPL::Web::View::TTDocument();
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
164
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
165 my $doc = new IMPL::Wbe::View::TTDocument($template,$ttOptions);
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
166
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
167 return $doc->Render();
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
168
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
169 =end code
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
170
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
171 Однако, более предпочтительный способ использовать C<IMPL::Web::View::TTLoader>.
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
172
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
173 =head1 DESCRIPTION
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
174
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
175 Документ для представления данных. Документы представляют собой иерархически организованные данные,
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
176 элементами данного документа являются данные для отображения, такие как
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
177
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
178 =over
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
179
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
180 =item * Объекты из БД
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
182 =item * Навигационные цепочки
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
183
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
184 =item * Меню и т.п.
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
185
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
186 =back
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
187
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
188 Скприт шаблона формирует структуру документа, затем сформированная структура форматируется в готовый документ.
192
a9faf883cdce IMPL::Web::View refactoring
cin
parents: 191
diff changeset
189 Процесс форматирования объектной модели в готовый документ может быть выполнена как вручную, так и при помощи
189
08015e2803f1 IMPL::Vew::Web - fixed memory leaks, more tests
cin
parents: 188
diff changeset
190 вспомогательного шаблона - обертки. Если у шаблона документа указан C<layout> в метаданных, то он будет
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
191 использован как шаблон для форматирования объектной модели, вывод самого шаблона будет проигнорирован. Если
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
192 обертка не задана, то результатом будет вывод самого скрипта шаблона.
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
193
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
194 Использование объектной модели документа позволяет решить задачи по созданию контейнеров,
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
195 у которых может быть сложное содежимое. Примером таких элементов могут быть формы,
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
196 внутри форм элементы управления также могут группироваться.
192
a9faf883cdce IMPL::Web::View refactoring
cin
parents: 191
diff changeset
197
193
sergey
parents: 192
diff changeset
198 =head2 Элементы управления (компоненты)
sergey
parents: 192
diff changeset
199
sergey
parents: 192
diff changeset
200 Документ состоит из узлов, часть которых наследуется от C<IMPL::Web::View::TTControl>, такие узлы называются
sergey
parents: 192
diff changeset
201 элементами управления. Каждый элемент управления имеет собственный контекст, который наследуется от контекста
sergey
parents: 192
diff changeset
202 документа.
sergey
parents: 192
diff changeset
203
sergey
parents: 192
diff changeset
204 =head2 Фабрика элементов управления
sergey
parents: 192
diff changeset
205
sergey
parents: 192
diff changeset
206 Для создания элементов управления используются фабрики. Каждый элемен управления имеет свой шаблон для
sergey
parents: 192
diff changeset
207 форматиорвания содержимого, фабрика связывает шаблон и класс элемента управления, для чего при загрузке
sergey
parents: 192
diff changeset
208 шаблона используется свойство C<type> из метаданных. Фабрика загружается в документ при том только один
sergey
parents: 192
diff changeset
209 раз, повторные загрузки фабрики возвращают уже загруженную. Для загрузки фабрики используется метод
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
210 C<require()> с указанием элемента управления.
190
cd1ff7029a63 IMLP::Web::View refactored, added new method 'require' which is available inside templates. Changed document rendering.
cin
parents: 189
diff changeset
211
185
ae8072f2f2a3 IMPL::Web::View::TTDocument tests, fixes
cin
parents: 181
diff changeset
212 =head2 Порядок обработки документа
ae8072f2f2a3 IMPL::Web::View::TTDocument tests, fixes
cin
parents: 181
diff changeset
213
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
214 Построение представления данных состоит из двух этапов
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
215
185
ae8072f2f2a3 IMPL::Web::View::TTDocument tests, fixes
cin
parents: 181
diff changeset
216 =over
ae8072f2f2a3 IMPL::Web::View::TTDocument tests, fixes
cin
parents: 181
diff changeset
217
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
218 =item 1 Создание объектной модели документа. На данном этапе создаются все элементы управления.
185
ae8072f2f2a3 IMPL::Web::View::TTDocument tests, fixes
cin
parents: 181
diff changeset
219
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
220 =item 1 Преобразование объектной модели в конечнное представление. На данном этапе происходит
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
221 форматирование документа.
185
ae8072f2f2a3 IMPL::Web::View::TTDocument tests, fixes
cin
parents: 181
diff changeset
222
ae8072f2f2a3 IMPL::Web::View::TTDocument tests, fixes
cin
parents: 181
diff changeset
223 =back
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
224
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
225
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
226 =head2 Загрузка элемента управления
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
227
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
228 =over
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
229
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
230 =item 1 C<TInput = require('my/org/input')>
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
231
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
232 =item 1 Загружается шаблон C<my/org/input.tt>
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
233
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
234 =item 1 Создается фабрика элементов управления с собственным контекстом, унаследованным от контекст документа.
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
235
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
236 =item 1 При первом создании элемента управления фабрика инициализируется выполнением блока C<INIT>.
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
237
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
238 =back
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
239
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
240 =head2 Создание элемента управления
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
241
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
242 =over
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
243
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
244 =item 1 C<< TInput.new('login') >>
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
245
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
246 =item 1 Создается новый дочерний контекст к контексту фабрики
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
247
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
248 =item 1 Создается экземпляр элемента управления
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
249
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
250 =item 1 Выполняется блок конструктора C<CTOR> в контексте элемента управления, параметр C<this> имеет значение
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
251 нового экземпляра элемента управления
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
252
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
253 =back
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
254
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
255 =head1 MEMBERS
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
256
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
257 =over
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
258
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
259 =item C<CTOR($template, $contextOpts, $loader[, $vars])>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
260
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
261 Создает экземпляр документа с указанным шаблоном и параметрами.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
262
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
263 =over
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
264
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
265 =item C<$template>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
266
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
267 C<Template::Document> шаблон документа.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
268
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
269 =item C<$contextOpts>
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
270
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
271 C<HASH> Параметры контекста C<Template::Context> для документа. Эти параметры будут сохранены
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
272 в свойстве C<opts>, а также на их основе будет создан контекст текщего документа. Как правило
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
273 эти параметы задаются загрузчиком документа C<IMPL::Web::View::TTLoader>, таким образом, что
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
274 C<Template::Stash> создаваемого контекста наследует переменные из контекста загрузчика.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
275
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
276 =item C<$loader>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
277
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
278 C<IMPL::Web::View::TTLoader> загрузчик, который будет использоваться для загрузки элементов управления,
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
279 а также для получения обертки, заданной в свойстве документа C<layout>.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
280
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
281 =item C<$vars>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
282
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
283 C<HASH> Необязательный параметр. переменные которые будут переданы в блок конструктора C<INIT>.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
284 Как правило они используются для передачи данных для построения документа
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
285
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
286 =back
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
287
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
288 =back
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
289
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
290 =over
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
291
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
292 =item C<templateVars($name[,$newValue])>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
293
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
294 Получает или задает переменную для шаблона документа. Имя переменнной может быть составным,
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
295 например C<'my.var.name'>, см. C<Template::Stash::set()>.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
296
236
2904da230022 DOM refactoring
sergey
parents: 234
diff changeset
297 =item C<RequireControl($controlName)>
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
298
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
299 Загружает фабрику элемента управления, если она уже была загружена, возвращает на нее ссылку.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
300 При загрузки фабрики для нее создается собственный контекст на основе параметров из свойства
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
301 C<opts> и ее пространство имен наследуется от пространства имен документа из свойства C<stash>.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
302
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
303 =item C<Render($vars)>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
304
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
305 Выполняет блок C<renderBlock> документа для получения конечного представления, C<$vars>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
306 содержит переменные для блока.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
307
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
308 =item C<RenderContent($vars)>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
309
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
310 Выполняет шаблон документа для получения представления содержимого, в отличии от
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
311 метода C<Render> не использует обертку указанную в свойстве C<layout>, если обертка
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
312 не указана, то эти методы идентичны.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
313
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
314 =item C<[get,set]layout>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
315
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
316 Обертка, которая будет использована для построения представления документа. В обертке
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
317 будет доступна специальная переменная C<content>, при обращении к которой будет B<выполнен>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
318 метод C<RenderContent()> и возвращен результат его работы. Для получения шаблона обертки
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
319 используется загрузчик из свойства C<loader>.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
320
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
321 =item C<[get]opts>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
322
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
323 Параметры контекста, используются для создания контекстов фабрик элементов управления.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
324
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
325 =item C<[get]loader>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
326
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
327 Загрузчик, используется для загрузки шаблонов фабрик элементов управления и обертки.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
328
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
329 =item C<[get]controls>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
330
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
331 C<HASH> Коллекция загруженных фабрик элементов управления, ключем является
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
332 квалифицированное имя элемента управления.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
333
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
334 =item C<[get]stash>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
335
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
336 C<Template::Stash> Пространство имен документа, оно используется как родительское
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
337 для пространств имен загружаемых фабрик элементов управления.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
338
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
339 =back
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
340
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
341 =head1 TEMPLATES
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
342
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
343 =begin text
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
344
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
345 [%META layout='default'%]
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
346 [% BLOCK CTOR;
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
347 section('top','TOP');
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
348 section('bottom','BOTTOM');
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
349 section('client','CLIENT');
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
350 END %]
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
351 [% BLOCK TOP;
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
352 TMenu = require('my/org/Menu');
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
353 append(TMenu.new());
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
354 END %]
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
355
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
356 =end
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
357
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
358 =cut