最近的事情很多很不顺利，不过一切都会过去，并且重新走上 正规的。

前阵子在看《RESTful Web Services》，看得更加迷惑，毕竟是英文书，不太好理解。不过关于REST的理解还是整理了一下。

同时在写一个个人的项目，主要是在开发的过程中保持对编程的感觉（因为没有接到赚钱的项目），还有就是试用新的Rails2.0.2，以及对REST的重新理解。

这个个人的项目是http://4rails.cn，一个招聘信息发布和简历系统。由于目前是个人练习，所以功能上很主观，并未太考虑实用性。而且在正式美化界面前，它属于全人类。

开发4Rails有几个想法：

1、RESTful和ROA

2、Rails2.0.2下的RESTful

3、几个插件的使用

4、实现以前想过但是没做的想法

5、为另一个项目准备

随便写写：

1、RESTful和ROA

I hold that everything in the Resource-Oriented Architecture is also RESTful.

在这篇文章里面，比较详细的介绍了REST的概念，但是，普遍的来说，很多文章 对REST的描述都是千篇一律的。那么，《RESTful Web Services》中如何来介绍REST的呢？

第四章《The Resource-Oriented Architecture》 中讲到：REST不是一个结构，而是一个标准[criteria]，但是这里并不是在说“REST 结构”。而ROA(Resource-Oriented Architecture)才是一个结构，一个RESTful的结构。

在这里，“Oriented”再次出现在眼里，而它出现最多地方的便是“Object Oriented Programming”，计算机教科书里的翻译为“面向对象的程序设计”。那么根据同样的原则，来对ROA理解，可以叫做“面向资源的结构”。

那么Rails2.0.2里面，是如何来实现ROA的呢？

2、Rails2.0.2下的RESTful

在Rails1.2.x里面就在坚持着RESTful的风格，现在Rails2.0.2更加强调了ROA的结构，特别是在scaffold的生成和routes的设计上。不过，Rails并不是完全的REST，“RESTful”比较合适。而在目前的开发中，更多的是在遵循ROA，来设计“资源”。

在4Rails的这个系统中，资源包括：用户，招聘信息，用户关注的信息，简历，头像。

刚开始对REST感兴趣的时候，经常会想到的问题：“是不是网站的设计都要RESTful”，不。

REST讲究的是ROA的设计，是对网站资源的操作，而很多业务操作，如用户登陆，购买流程，统计结算等等，还是需要传统的设计。RESTful的优点是方便资源的利用。所以，再重新设计一个销售项目的时候，Rails做的是对网站资源和用户资源重新设计，这主要的改进是，对资源的表述更加准确。

比如以前喜欢把用户中心地址设计成"/u/1"，用户的销售商品列表就是"/goods"。
而现在统一的都是"/users/1"，和"/users/1/goods"，当然，这里面避免了的麻烦还很多。

里克：当然，id的使用并不是REST所提倡的，因为它不够直接，而且当id变化的时候（很容易造成变化，比如新老系统的数据整合的时候），就会造成一些问题。我倒是希望Rails能够用slug来代替id，就像wp的Post Slug，或者给出两个方案，默认用id，slug可选。这会成真吗？

有时候，xxx_id 并不一定代表model关系中的外键关联，它可能是一个判断标准。尤其在REST的view页面的时候。对于需要对其判断权限的访问者，这个id比其他的更重要。

3、插件

4Rails用到了4个插件：

will_paginate：分页插件，很好用。

resource_feeder和simply_helpful：用来实现RSS订阅。不过被大砍了很多代码，因为是针对1.2.x版本的，在2.0.2上会覆盖掉默认的form_form 方法，所以需要改一下。

acts_as_attachment：头像的上传

acts_as_attachment和attachment_fu两个插件会在下一篇博客里好好整理一下，早就知道这两个插件的大名，而且向人吹嘘说是插件排行榜前三位。不过说实话我还没用过呢。嘿嘿。

参考文章：
Ajax 和 REST，第 1 部分
Ajax 和 REST，第 2 部分

注：这是opensocial在google code上的视频，经常看可以锻炼下英语

什么是OpenSocial

OpenSocial是一套API，具体说是由两种类型的API组成。第一种，REST 形式的API是向Social Network或其他遵循 该协议的应用，发送个人资料，好友，活动和persistence components[?]。第二种，Javascript API是以表单的形式实现第一种的REST应用。

Rails上的OpenSocial

本段译自Google's OpenSocial with Ruby on Rails
根据OpenSocial documentation上的显示，目前OpenSocial开放了2中类型资源：people，一个用户的好友，和activities，这些好友的活动/行为。这种结构正好符合rails对集中资源的理解，在一个user Controller中，我们可以狠容易的得到用户的好友和他们的活动。
OpenSocial的API是按照REST结构设计，但是它并不完全符合Rails的观点，首先，通过URL访问资源的形式并不是Rails的标准形式。其次，它不包含format extension，这意味着你不能直接使用respond_to块。
但是上面两个问题可以通过在routes文件增加一组路由描述和增加一个自定义的mimetype来解决。
下面的路由规则是在描述如何在我们的user_controller中对应OpenSocial 中的people资源的。

 
# config/environment.rb
Mime::Type.register "application/x-opensocial", :opensocial
 
# config/routes.rb
map.opensocial_person '/feeds/people/:id', :controller => 'users', \
                            :action => 'show', :format => 'opensocial',\
                            :conditions => {:method => :get}
 
map.opensocial_person '/feeds/people/:id', :controller => 'users',\
                            :action => 'update', :format => 'opensocial', \
                            :conditions => {:method => :put}
 
map.opensocial_person '/feeds/people/:id', :controller => 'users', \
                             :action => 'destroy', :format => 'opensocial', \
                             :conditions => {:method => :delete}
 
# app/controllers/users_controller.rb
 
respond_to do |format|
  ...
  format.opensocial
end

如果上面的比较麻烦，可以下载作者发的插件。这样你的route文件可以这样写：

 
# config/routes.rb
map.resources :users do |user|
  user.resources :activities
  user.resources :relationships
end
 
map.opensocial_people :users do |user|
  user.opensocial_friends :relationships
  user.opensocial_activities :activities
end

里克：google上看到的是两种资源，一种持久性方案，下面这个单元就介绍了OpenSocial Container

OpenSocial Container

本段整理自OpenSocial? What's that?
OpenSocial Application
OpenSocial Application使用XML文档来最终render[一个狠程序化的词，我感觉应该不翻译为好]给用户。这个xml包含了metadata，html，和javascript。下面是Last.fm上的OpenSocial应用。
http://www.last.fm/opensocial/myfavouritemusic.xml

 
< ?xml version="1.0" encoding="UTF-8"?>
<module>
  <moduleprefs title="My Favorite Music">
    <require feature="opensocial-0.5" />
    <require feature='setprefs' />
    <require feature='dynamic-height' />
  </moduleprefs>
  <content type="html">
 
  < ![CDATA[
<div id="overlord">
<div id="loading">Loading...</div>
<div id="updating" style="display:none;">Updating...</div>
<div id="area"></div>
<div id="lastfmAccount" class="lastfmAccount">
<div id="hadALastfmAccount" style="display:none;" class="strongLinks">
 
<a id="haveAccountLink" href="javascript:;" onclick="$('setUsername').toggle();_IG_AdjustIFrameHeight();new Effect.ScrollTo('setUsername');return false;">Have a Last.fm account? Click here.</a>
</div>
<form id="setUsername" style="display:none;">
<input type="text" id="username" />
<input type="submit" value="That's me!" />
          <span id="cancelChangeUsername">| <a href="javascript:;" class="cancel" id="">cancel</a></span>
        </form>
</div>
<div id="placeholder"></div>
<style>
    @import url(http://cdn.last.fm/opensocial/main.5.css);
    @import url(http://cdn.last.fm/opensocial/canvas.1.css);
  </style>
 
  <script type="text/javascript" src="http://cdn.last.fm/javascript/lib/prototype.js"></script>
  <script type="text/javascript" src="http://cdn.last.fm/javascript/lib/scriptaculous.js"></script>
  <script type="text/javascript" src="http://cdn.last.fm/javascript/source/flashplayer_inline.js"></script>
  <script type="text/javascript" src="http://cdn.last.fm/javascript/11/flashpreview.js"></script>
 
  <script src="http://cdn.last.fm/opensocial/lfm.2.js"></script>
 
  ]]>
  </content>
 
</module>
 

OpenSocial Container
OpenSocial Container的设计，是用来给网站提供用户的选择，配置，加强网站的用户应用，尤其在用户属性页面。OpenSocial Container需要能够理解XMl文件格式，并实现OpenSocial Javascript API。

OpenSocial Container如何工作
里克：下面的话还在捉摸
The OpenSocial Container boils down quite simply to an IFRAME with the text of the element from the application's XML dumped in to the body. One difficulty for building a container is dealing with the security risks of exposing cookies set by the "Host Network" to the Application's content, since the Host is doing the embedding. To ensure privacy and a certain degree of security the Container needs to originate from a different domain name than the Host. By doing this the Host/Container (they are the same entity) trick the browser into protecting the Host cookies from the Container's (and thus the Application's) Javascript.

The Container also makes extensive use of AJAX to request data from the Host/Container. This is how the Application gets access to the profile, friendship, activities, and persistence information.
为什么这么做？我们要注意什么？
OpenSocial standardizes social networking APIs. That alone is not particularly novel. But this is Google we're talking about here. With that kind of backing and buzz this may stick. As a developer this means that you only need to learn one API to be able to build social applications. One particularly interesting aspect of the OpenSocial API is the persistence layer. Using this portion of the API a developer can, quite easily, create a full featured interactive application which is entirely self contained in a single static XML file. All of the persistence and communication is handled by the Container and the Host. Now that is cool.

If this takes off like is appears to be poised to do, then we could be in for some excitement akin to the growth and fragmentation of the early social networks; except this will be happing above the social network layer. One interesting possible side effect will be a growth in the popularity of niche social networks. OpenSocial appears to lower the castle walls of the established networks. I expect the crossover in data and user-base between networks will skyrocket as once "proprietary" profile data becomes easily moved and shared.

下载OpenSocial Container 0.2.0

ruby script/plugin install

http://opensocial.rubyforge.org/svn/plugin/tags/0_2_0/opensocial_container

下载OpenSocial Container 0.3.0

ruby script/plugin install

http://opensocial.rubyforge.org/svn/plugin/tags/0_3_0/opensocial_container

注：
本文将继续整理相关内容，有想法的朋友请留言，万分感谢。
本文有很多东西第一次接触，有不妥的地方，如果您愿意指出帮助我提高，劳烦留言。我会认真查找您的提示。
目前正在看OpenSocial Container 0.2/3.0的源码
林肯公园的歌简直成了我的精神支柱了。

参考资料：
OpenSocial Container
0.2.0
OpenSocial Container 0.3.0
OpenSocial? What's that?
Google's OpenSocial with Ruby on Rails
OpenSocial
其他：
Installing and Configuring Nginx and Mongrel for Rails
Database Optimization for Rails Apps