Mercurial > pub > Impl
annotate Lib/IMPL/Web/RestContract.pm @ 226:b6cde007a175
Added resource contract
| author | sergey |
|---|---|
| date | Wed, 05 Sep 2012 15:10:26 +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 |