用newLisp开发网站四 REST API

URL中的$resource和lisp文件名对应

本节主要学习如何使用第二种路由方法来实现REST API。仍然阅读http://dragonfly.neocortex.io/dragonfly_routes
不过要看这一节：

RESTful routing with Route.Resource

首先是URL请求格式有讲究， http://mysite.com/$resource[/action][/id][.format][?get params..]
$resource
$resource是个变量必须和放在resources目录下的lsp文件名相同，比如有一个wings.lsp文件，这里的url路径就应该从wings开始
比如 http://mysite.com/wings
如果找不到对应的文件，则会显示404错误，文档太老了，还在说500错误。

用FOOP处理REST请求

从Resource context继承

以wings.lsp为例，它必须从Resource继承出自己的，而且有书写格式要求，比如：
(DF:activate-plugin "artfulcode/json")
(new Resource 'Resource.Wings)
(context 'Resource.Wings)
第一行是必须的，照抄即可。第二行注意命名，Wings要写成首字母大写，无下划线，并且用Resource. 作为前缀
第三行切换到Resource.Wings context.
这里涉及到context和FOOP的概念，参考我的另外几篇文章。
所有这里$resource不仅映射到文件（wings.lsp)，也映射到文件内部的FOOP对象。

action

action映射到该FOOP对象的某个函数。如果URL请求中没有指定action，则会调用默认构造函数。注意，action是大小写敏感的，下面是例子：
(define (Resource.Mailer:send)
(println "action: "))
对应的urlg调用路径是： http://localhost:8089/mailer/send
下面创建一个class的构造函数（也就是context的默认函数）用来处理没有action的REST 请求，REST 请求发过来后会调用它。
(define (Resource.Wings:Resource.Wings id response-format)
; defaults to calling show
(show id response-format)
)


id和format
这个函数接受两个参数，对应了URL中的id和format参数。当然可以不处理这两个参数，因此他们是可选的。
运行一下例子，可以看到，当发出HTTP请求如下：http://localhost:8080/wings/1.json会得到结果如下：
["wings-condition", ["good", "excellent"]]
一个重要的提示，dragonfly没有设计成区分HTTP METHOD，设计者认为这不是个好主意，会带来很多的问题。所以不管什么HTTP方法的请求，都会调用到wings.lsp的中的默认构造函数。
下面用newlisp发起调用
get请求
> (get-url "http://localhost:8080/wings/1.json")
"[\"wings-condition\", [\"good\", \"excellent\"]]"
post请求
> (post-url "http://localhost:8080/wings/1.json" "a=1" "application/x-www-form-urlencoded")
"[\"wings-condition\", [\"good\", \"excellent\"]]"因此，如果觉得数据传递需要保密，或者很长，可以用post请求，一般get请求即可。
dragonfly推荐使用action来表达请求的意图，如下，的确是个很好的设计。



resouce是photos
action的可选值是： 无，new, create, show, edit, update, destroy
这里是举例，不是固定的。比如在我的一个一个应用中，action的值是: 无，save(create or update), show, build, destroy
id是可选的, 一般用于定位到复数中的某个对象
format没有
参数自己随意吧

返回结果
如何返回数据给调用者？直接用print函数

如何获得参数
用($POST key)或者($GET key)，比如：
(print ($POST "a"))
参考文档：http://dragonfly.neocortex.io/dragonfly_getpost