Jifty::Manual::TutorialRest(3pm)			User Contributed Perl Documentation			  Jifty::Manual::TutorialRest(3pm)

NAME

       Jifty::Manual::TutorialRest - Web Services

DESCRIPTION

       This builds on Jifty::Manual::Tutorial, so make sure you have a running jifty that roughly resembles the step-by-step from there.

SETUP

       You must add this to your site_config.yml

	 framework:
	   Plugins:
	     - REST: {}

       See Jifty::Plugin::REST.

       The commands assume that you have LWP installed with the GET alias.  If not, you'll need to use the longhand lwp-request -m GET, or curl,
       or your browser.

help
       Make sure it is working:

	 $ GET http://localhost:8888/=/help

	 Accessing resources:
	 ...

       You should see some text describing the services, not html (that's longhand for 404.)  Check the config and restart the server.

GET

       Just list the models.

	 $ GET http://localhost:8888/=/model.yml
	 ---
	 - MyWeblog.Model.Post

       List the Post schema.

	 $ GET http://localhost:8888/=/model/Post.yml
	 ---
	 body:
	   label: Content
	   name: body
	   readable: 1
	   sort_order: 1
	   type: text
	   writable: 1
	 id:
	   mandatory: 1
	   name: id
	   readable: 1
	   type: serial
	   writable: 0
	 title:
	   default: Untitled post
	   label: Title
	   name: title
	   readable: 1
	   sort_order: 0
	   type: text
	   writable: 1

       You did make some posts, right?

	 $ GET http://localhost:8888/=/model/Post/id.yml
	 ---
	 - 1
	 - 2

       Dump the data:

	 $ GET http://localhost:8888/=/model/Post/id/1.yml
	 ---
	 body: 'This is my post, the content of which is this, which is mine.'
	 id: 1
	 title: my first post

	 $ GET http://localhost:8888/=/model/Post/id/2.yml
	 ---
	 body: "Content of another post.  Got to go, the cat's on fire."
	 id: 2
	 title: post deux

POST

       TODO not working

       Actually, it looks like it is not supposed to work this way.  Why not?

	 $ echo '---
	 body: "A post via web services"
	 id: 3
	 title: "posting from the command-line"
	 ' | lwp-request -m POST http://localhost:8888/=/model/Post.yml
	 POST http://localhost:8888/=/model/Post/id/3.yml --> 404 Not Found

PUT

       TODO not working

	 $ echo '---
	 title: "posting from the cli"
	 ' | lwp-request -m PUT http://localhost:8888/=/model/Post/3.yml
	 500 Can't read entity body: Connection reset by peer

DELETE

	 $  lwp-request -m DELETE http://localhost:8888/=/model/Post/id/3.yml
	 ---
	 content: {}
	 error: ~
	 field_errors: {}
	 field_warnings: {}
	 message: Deleted
	 success: 1

perl v5.14.2							    2010-09-25					  Jifty::Manual::TutorialRest(3pm)