diff Lib/IMPL/Web/RestContract.pm @ 215:77a9934a44af

sync, migrating to XML::Compile
author cin
date Sun, 19 Aug 2012 22:27:43 +0400
parents d6e2ea24af08
children
line wrap: on
line diff
--- a/Lib/IMPL/Web/RestContract.pm	Mon Aug 06 17:27:47 2012 +0400
+++ b/Lib/IMPL/Web/RestContract.pm	Sun Aug 19 22:27:43 2012 +0400
@@ -63,4 +63,23 @@
 ресурсов. Контракт описывает дерево ресурсов начиная с корневого ресурса,
 и далее.
 
+Ресурсы состоят из нескольких описаний: C<ResourceContract>, C<OperationContract>
+которые описываю отображение самих ресурсов и операций над ресурсами в предметную
+область.
+
+C<ResourceContract> представляет собой описание того, какой ресурс и с какими
+параметрами должен быть создан. Например, может быть создан ресурс публикующий
+методы родительского ресурса, или же ресурс может слжить контроллером для
+работы с объектами предметной области.
+
+C<OperationContract> описывает связь между методом объекта предметной области и
+операцией возможной над ресурсом. Операция сводится к преобразованию запроса в
+аргументы метода, затем вызову метода и преобразованию результата в ответ на запрос.
+
+Ответ на запрос может быть как сформирован полностью в виде C<HTTP> ответа, так и
+в виде объекта, который будет в дальнейшем обработан нижележащими обработчиками
+приложения. 
+ 
+
+
 =cut
\ No newline at end of file