Mercurial > pub > Impl
annotate Lib/IMPL/Web/RestContract.pm @ 245:7c517134c42f
Added Unsupported media type Web exception
corrected resourceLocation setting in the resource
Implemented localizable resources for text messages
fixed TT view scopings, INIT block in controls now sets globals correctly.
| author | sergey |
|---|---|
| date | Mon, 29 Oct 2012 03:15:22 +0400 |
| parents | 77a9934a44af |
| children |
| rev | line source |
|---|---|
| 198 | 1 package IMPL::Web::RestContract; |
| 2 use strict; | |
| 3 | |
| 213 | 4 use IMPL::lang qw(:declare); |
| 198 | 5 use IMPL::declare { |
| 6 require => { | |
| 7 Exception => 'IMPL::Exception', | |
| 8 InvalidOpException => '-IMPL::InvalidOperationException', | |
| 9 ForbiddenException => 'IMPL::Web::ForbiddenException', | |
| 10 TRestResource => 'IMPL::Web::Application::RestResource', | |
| 212 | 11 RestBaseResource => 'IMPL::Web::Application::RestBaseResource', |
| 198 | 12 }, |
| 13 base => { | |
| 14 'IMPL::Transform' => sub { my %args = @_; $args{resources} }, | |
| 15 'IMPL::Object::Serializable' => undef | |
| 16 } | |
| 17 }; | |
| 18 | |
| 19 sub CTOR { | |
| 20 my ($this) = @_; | |
| 21 | |
| 22 $this->templates->{-plain} = sub { die ForbiddenException->new(); }; | |
| 23 $this->templates->{-default} = sub { die ForbiddenException->new(); }; | |
| 212 | 24 $this->templates->{&RestBaseResource} = sub { $_[1] }; |
| 198 | 25 } |
| 26 | |
| 27 sub ProcessTemplate { | |
|
199
e743a8481327
Added REST support for forms (with only get and post methods)
sergey
parents:
198
diff
changeset
|
28 my ($this,$t,$obj,$props) = @_; |
|
e743a8481327
Added REST support for forms (with only get and post methods)
sergey
parents:
198
diff
changeset
|
29 |
|
e743a8481327
Added REST support for forms (with only get and post methods)
sergey
parents:
198
diff
changeset
|
30 $props ||= {}; |
| 198 | 31 |
| 32 if (ref $t eq 'HASH') { | |
| 33 my $factory = $t->{factory} || TRestResource; | |
| 200 | 34 return $factory->new(%$t, target => $obj, contract => $this, %$props); |
| 198 | 35 } elsif (ref $t eq 'CODE') { |
|
199
e743a8481327
Added REST support for forms (with only get and post methods)
sergey
parents:
198
diff
changeset
|
36 return $this->$t($obj,$props); |
| 198 | 37 } else { |
| 38 die InvalidOpException->new(); | |
| 39 } | |
| 40 } | |
| 41 | |
| 42 1; | |
| 43 | |
| 44 __END__ | |
| 45 | |
| 46 =pod | |
| 47 | |
| 48 =head1 NAME | |
| 49 | |
| 50 C<IMPL::Web::RestContract> Описывает правила публикации ресурсов. | |
| 51 | |
| 52 =head1 SYNOPSIS | |
| 53 | |
| 212 | 54 |
| 55 | |
| 198 | 56 =begin code |
| 57 | |
| 58 =end code | |
| 59 | |
| 213 | 60 =head1 DESCRIPTION |
| 61 | |
| 62 Контракт представляет собой отображение модели предметной области на модель | |
| 63 ресурсов. Контракт описывает дерево ресурсов начиная с корневого ресурса, | |
| 64 и далее. | |
| 65 | |
| 215 | 66 Ресурсы состоят из нескольких описаний: C<ResourceContract>, C<OperationContract> |
| 67 которые описываю отображение самих ресурсов и операций над ресурсами в предметную | |
| 68 область. | |
| 69 | |
| 70 C<ResourceContract> представляет собой описание того, какой ресурс и с какими | |
| 71 параметрами должен быть создан. Например, может быть создан ресурс публикующий | |
| 72 методы родительского ресурса, или же ресурс может слжить контроллером для | |
| 73 работы с объектами предметной области. | |
| 74 | |
| 75 C<OperationContract> описывает связь между методом объекта предметной области и | |
| 76 операцией возможной над ресурсом. Операция сводится к преобразованию запроса в | |
| 77 аргументы метода, затем вызову метода и преобразованию результата в ответ на запрос. | |
| 78 | |
| 79 Ответ на запрос может быть как сформирован полностью в виде C<HTTP> ответа, так и | |
| 80 в виде объекта, который будет в дальнейшем обработан нижележащими обработчиками | |
| 81 приложения. | |
| 82 | |
| 83 | |
| 84 | |
| 198 | 85 =cut |