|
110
|
1 package IMPL::Web::Application::ControllerUnit;
|
|
112
|
2 use strict;
|
|
110
|
3 use base qw(IMPL::Object);
|
|
|
4
|
|
|
5 use IMPL::Class::Property;
|
|
112
|
6 use IMPL::DOM::Transform::PostToDOM;
|
|
|
7 use IMPL::DOM::Schema;
|
|
113
|
8 use Class::Inspector;
|
|
|
9 use File::Spec;
|
|
112
|
10
|
|
|
11 use constant {
|
|
|
12 CONTROLLER_METHODS => 'controller_methods',
|
|
|
13 STATE_CORRECT => 'correct',
|
|
|
14 STATE_NEW => 'new',
|
|
|
15 STATE_INVALID => 'invalid'
|
|
|
16 };
|
|
110
|
17
|
|
|
18 BEGIN {
|
|
|
19 public property action => prop_get | owner_set;
|
|
|
20 public property application => prop_get | owner_set;
|
|
|
21 public property query => prop_get | owner_set;
|
|
111
|
22 public property formData => prop_get | owner_set;
|
|
|
23 public property formSchema => prop_get | owner_set;
|
|
|
24 public property formErrors => prop_get | owner_set;
|
|
110
|
25 }
|
|
|
26
|
|
113
|
27 __PACKAGE__->class_data(CONTROLLER_METHODS,{});
|
|
|
28
|
|
110
|
29 sub CTOR {
|
|
112
|
30 my ($this,$action,$args) = @_;
|
|
110
|
31
|
|
|
32 $this->action($action);
|
|
|
33 $this->application($action->application);
|
|
|
34 $this->query($action->query);
|
|
112
|
35
|
|
|
36 $this->$_($args->{$_}) foreach qw(formData formSchema formErrors);
|
|
|
37 }
|
|
|
38
|
|
|
39 sub forms {
|
|
|
40 my ($self,%forms) = @_;
|
|
|
41
|
|
|
42 while ( my ($method,$info) = each %forms ) {
|
|
|
43 die new IMPL::Exception("A method doesn't exists in the controller",$self,$method) unless $self->can($method);
|
|
|
44 if ( not ref $info ) {
|
|
|
45 $self->class_data(CONTROLLER_METHODS)->{$method} = {
|
|
|
46 wrapper => 'FormWrapper',
|
|
|
47 schema => $info
|
|
|
48 };
|
|
|
49 } elsif (ref $info eq 'HASH') {
|
|
|
50 die new IMPL::Exception("A schema must be specified",$self,$method) unless $info->{schema};
|
|
|
51
|
|
|
52 $self->class_data(CONTROLLER_METHODS)->{$method} = {
|
|
|
53 wrapper => 'FormWrapper',
|
|
|
54 schema => $info->{schema}
|
|
|
55 };
|
|
|
56 } else {
|
|
|
57 die new IMPL::Exception("Unsupported method information",$self,$method);
|
|
|
58 }
|
|
|
59 }
|
|
|
60 }
|
|
|
61
|
|
|
62 sub transactions {
|
|
113
|
63 my ($self,@names) = @_;
|
|
112
|
64
|
|
113
|
65 $self->class_data(CONTROLLER_METHODS)->{$_} = {} foreach @names;
|
|
110
|
66 }
|
|
|
67
|
|
|
68 sub InvokeAction {
|
|
|
69 my ($self,$method,$action) = @_;
|
|
|
70
|
|
112
|
71 if (my $methodInfo = $self->class_data(CONTROLLER_METHODS)->{$method}) {
|
|
|
72 if (my $wrapper = $methodInfo->{wrapper}) {
|
|
|
73 return $self->$wrapper($method,$action,$methodInfo);
|
|
|
74 } else {
|
|
|
75 return $self->TransactionWrapper($method,$action,$methodInfo);
|
|
|
76 }
|
|
110
|
77 } else {
|
|
|
78 die new IMPL::InvalidOperationException("Invalid method call",$self,$method);
|
|
|
79 }
|
|
111
|
80 }
|
|
|
81
|
|
112
|
82 sub TransactionWrapper {
|
|
|
83 my ($self,$method,$action,$methodInfo) = @_;
|
|
|
84
|
|
|
85 my $unit = $self->new($action);
|
|
|
86 return $unit->$method();
|
|
|
87 }
|
|
|
88
|
|
|
89 sub FormWrapper {
|
|
113
|
90 my ($self,$method,$action,$methodInfo) = @_;
|
|
|
91
|
|
|
92 my $schema = $self->loadSchema($methodInfo->{schema});
|
|
|
93
|
|
|
94 my $process = $action->query->param('process') || 0;
|
|
|
95 my $form = $methodInfo->{form}
|
|
|
96 || $action->query->param('form')
|
|
|
97 || $schema->selectSingleNode('ComplexNode')->name
|
|
|
98 or die new IMPL::Exception('No situable form name could be determined',$self,$method);
|
|
112
|
99
|
|
113
|
100 my %result;
|
|
112
|
101
|
|
113
|
102 my $transform = IMPL::DOM::Transform::PostToDOM->new(
|
|
|
103 undef,
|
|
|
104 $schema,
|
|
|
105 $form
|
|
|
106 );
|
|
|
107
|
|
|
108 $result{formSchema} = $schema;
|
|
126
|
109 $result{formData} = $transform->Transform($action->query);
|
|
|
110
|
|
112
|
111
|
|
113
|
112 if ($process) {
|
|
|
113 $result{formErrors} = $transform->Errors->as_list;
|
|
|
114 if ($transform->Errors->Count) {
|
|
|
115 $result{state} = STATE_INVALID;
|
|
|
116 } else {
|
|
|
117 $result{state} = STATE_CORRECT;
|
|
|
118 my $unit = $self->new($action,\%result);
|
|
|
119 $result{result} = $unit->method();
|
|
|
120 }
|
|
|
121 } else {
|
|
|
122 $result{state} = STATE_NEW;
|
|
|
123 }
|
|
112
|
124
|
|
113
|
125 return \%result;
|
|
|
126 }
|
|
|
127
|
|
|
128 sub loadSchema {
|
|
|
129 my ($self,$name) = @_;
|
|
|
130
|
|
126
|
131 if (-f $name) {
|
|
|
132 return IMPL::DOM::Schema->LoadSchema($name);
|
|
|
133 } else {
|
|
|
134 my ($vol,$dir,$file) = File::Spec->splitpath( Class::Inspector->resolved_filename(ref $self || $self) );
|
|
|
135
|
|
|
136 return IMPL::DOM::Schema->LoadSchema(File::Spec->catfile($vol,$dir,$name));
|
|
|
137 }
|
|
112
|
138 }
|
|
|
139
|
|
111
|
140 1;
|
|
|
141
|
|
|
142 __END__
|
|
|
143
|
|
|
144 =pod
|
|
|
145
|
|
|
146 =head1 NAME
|
|
|
147
|
|
|
148 C<IMPL::Web::Application::ControllerUnit> - базовый класс для обработчика транзакций в модели контроллера.
|
|
|
149
|
|
|
150 =head1 DESCRIPTION
|
|
|
151
|
|
113
|
152 Классы, наследуемые от данного класса называется пакетом транзакций. Часть методов в таком классе
|
|
|
153 объявляются как транзакции при помощи методов C<transaction>, C<form>.
|
|
111
|
154
|
|
|
155 Перед выполнением транзакции создается экземпляр объекта, в рамках которого будет выполнена транзакция.
|
|
|
156 Для этого вызывается метод C<InvokeAction($method,$action)>, который создает/восстанавливает контекст
|
|
|
157 транзакции.
|
|
|
158
|
|
|
159 Транзакции на данный момент делятся на простые и формы.
|
|
|
160
|
|
|
161 =head2 Простые транзакции
|
|
|
162
|
|
|
163 Простые транзакции получаю только запрос, без предварительной обработки, и возвращенный результат напрямую
|
|
|
164 передается пользователю.
|
|
|
165
|
|
|
166 =head2 Формы
|
|
|
167
|
|
|
168 При использовании форм запрос предварительно обрабатывается, для получения DOM документа с данными формы.
|
|
|
169 Для постороенния DOM документа используется схема. При этом становятся доступны дополнительные свойства
|
|
|
170 C<formData>, C<formSchema>, C<formErrors>.
|
|
|
171
|
|
|
172 Результат выполнения транзакции не возвращается напрямую пользователю, а включается в общий ответ, который
|
|
|
173 выглядит следующим образом
|
|
|
174
|
|
|
175 =begin code
|
|
|
176
|
|
|
177 {
|
|
|
178 state => '{ new | correct | invalid }',
|
|
|
179 result => $transactionResult,
|
|
|
180 formData => $formDOM,
|
|
|
181 formSchema => $formSchema,
|
|
|
182 formErrors => @errors
|
|
|
183 }
|
|
|
184
|
|
|
185 =end code
|
|
|
186
|
|
|
187 =over
|
|
|
188
|
|
|
189 =item C<state>
|
|
|
190
|
|
|
191 Состояние верификации формы.
|
|
|
192
|
|
|
193 =over
|
|
|
194
|
|
|
195 =item C<new>
|
|
|
196
|
|
|
197 Первоначальное содержимое формы, оно может быть некорректным, но это нормально.
|
|
|
198 В данном состоянии транзакция обычно не выполняется.
|
|
|
199
|
|
|
200 =item C<correct>
|
|
|
201
|
|
|
202 Данные формы корректны, транзакция выполнена, и ее результат доступен через поле C<result>
|
|
|
203
|
|
|
204 =item C<invalid>
|
|
|
205
|
|
|
206 Содержимое формы не прошло верификацию, ошибки доступны через поле C<formErrors>. Транзакция
|
|
|
207 не выполнялась.
|
|
|
208
|
|
|
209 =back
|
|
|
210
|
|
|
211 =item C<result>
|
|
|
212
|
|
|
213 Результат выполнения транзакции, если конечно таковая выполнялась.
|
|
|
214
|
|
|
215 =item C<formData>
|
|
|
216
|
|
|
217 ДОМ документ с данными формами. Документ существует всегда, не зависимо от его корректности,
|
|
|
218 может быть использован для построения формы, уже заполненную параметрами.
|
|
|
219
|
|
|
220 =item C<formSchema>
|
|
|
221
|
|
|
222 Схема данных формы, может использоваться для построения динамических форм.
|
|
|
223
|
|
|
224 =item C<formErrors>
|
|
|
225
|
|
|
226 Ошибки верификации данных, если таковые были
|
|
|
227
|
|
|
228 =back
|
|
|
229
|
|
|
230 =head1 MEMBERS
|
|
|
231
|
|
|
232 =over
|
|
|
233
|
|
|
234 =item C<[get] application>
|
|
|
235
|
|
|
236 =item C<[get] query>
|
|
|
237
|
|
|
238 =item C<[get] response>
|
|
|
239
|
|
|
240 =item C<[get] formData>
|
|
|
241
|
|
|
242 =item C<[get] formSchema>
|
|
|
243
|
|
|
244 =item C<[get] formErrors>
|
|
|
245
|
|
|
246 =item C<InvokeAction($method,$action)>
|
|
|
247
|
|
|
248 Конструирует контекст выполнения транзакции, может быть переопределен для конструирования контекста по
|
|
112
|
249 своим правилам.
|
|
|
250
|
|
|
251 =item C<TransactionWrapper($method,$action,$methodInfo)>
|
|
|
252
|
|
|
253 Обертка для конструирования простых транзакций, может быть переопределен для конструирования контекста по
|
|
|
254 своим правилам.
|
|
|
255
|
|
|
256 =item C<FormWrapper($method,$action,$methodInfo)>
|
|
|
257
|
|
|
258 Обертка для конструирования форм, может быть переопределен для конструирования контекста по
|
|
|
259 своим правилам.
|
|
111
|
260
|
|
|
261 =back
|
|
|
262
|
|
|
263 =head1 EXAMPLE
|
|
|
264
|
|
|
265 =begin code
|
|
|
266
|
|
|
267 package MyBooksUnit;
|
|
|
268 use strict;
|
|
|
269 use base qw(IMPL::Web::Application::ControllerUnit);
|
|
|
270
|
|
|
271 __PACKAGE__->PassThroughArgs;
|
|
|
272
|
|
|
273 __PACKAGE__->transactions(qw(
|
|
|
274 find
|
|
|
275 info
|
|
|
276 ));
|
|
|
277 __PACKAGE__->forms(
|
|
|
278 create => 'books.create.xml'
|
|
|
279 );
|
|
|
280
|
|
|
281 sub find {
|
|
|
282 my ($this) = @_;
|
|
|
283
|
|
|
284 return $this->application->dataSource->resultset('Books')->find({author => $this->query->param('author')});
|
|
|
285 }
|
|
|
286
|
|
|
287 sub info {
|
|
|
288 my ($this) = @_;
|
|
|
289
|
|
|
290 return $this->application->dataSource->resultset('Books')->find({id => $this->query->param('id')});
|
|
|
291 }
|
|
|
292
|
|
|
293 sub create {
|
|
|
294 my ($this) = @_;
|
|
|
295
|
|
|
296 my %book = map {
|
|
|
297 $_ => $this->formData->selectSingleNode($_)->nodeValue
|
|
|
298 } qw(author_id title year ISBN);
|
|
|
299
|
|
|
300 return $this->application->datasource->resultset('Books')->create(\%book);
|
|
|
301 }
|
|
|
302
|
|
|
303 =end code
|
|
|
304
|
|
|
305 =cut |
