Agile Web Development with Rails 4E 学习笔记1
?
Agile Web Development with Rails 4E 2011.03 ??
========zqhxuyuan@gmail.com 2011.10========
?
===========================================
Chapter6. Task A: Creating the Application
1.1 创建Rails项目depot:
> rails new depot?
1.2 切换到depot目录下:
> cd depot?
使用Rails3默认的数据库SQLite3
1.3 创建项目的脚手架:
> rails generate scaffold Product?
title:string description:text image_url:string price:decimal
生成数据库脚本: db/migrate/create_products.rb 如果想查看表结构:db/schema.rb
Model: app/models/product.rb
View: app/views/products/*.html.erb
Controller: app/controllers/products_controller.rb
test: test/unit/product_test.rb ?test/functional/products_controller_test.rb
(注意:Model是单数,以及Model的单元测试test/unit/product_test.rb
复数的有:View:products/?
Controller:products_controller.rb 以及Controller的Fucntional测试:products_controller_test.rb) ?
1.4 修改Product对应的表的某个字段的长度和精度,修改后需要和原先的数据库进行migrate:
-> db/migrate/create_products.rb
class CreateProducts < ActiveRecord::Migration
t.decimal :price, :precision => 8, :scale => 2
end
> rake db:migrate ?
1.5 启动Rails内置服务器WEBrick,访问以上URL,查看Products列表:
> rails server
@ http://localhost:3000/products
点击列表页面的New Product进入http://localhost:3000/products/new
在新增页面输入数据,提交,并返回 http://localhost:3000/products 则可以看到新增的记录
分析CRUD的流程1--页面跳转:
http://localhost:3000/products/ 满足app/controllers/products_controller.rb ProductsController?
的URL命名约定: GET /products 对应的方法是: index?
在index方法里取得所有的products: @products = Product.all
页面指向respond_to -> format.html # index.html.erb 即app/views/products/index.html.erb
(# index.html.erb是注释,因为该方法名为index,所以format.html的值为:index.html.erb)
在index.html.erb中@products.each do |product|取出所有的products循环输出每个Product的信息
数据的获取是通过Json方式,Controller中在指向index.html.erb时获取到了Json数据: format.json { render json: @products }
新增Product,路径为:link_to new_product_path 根据Rails的命名约定满足?
GET /products/new 的URL(link_to: Get; new_product_path: /products/new ). 会调用Controller的new方法并指向new.html.erb
new.html.erb 只有一行代码: <%= render 'form' %> 指向_form.html.erb
_form.html.erb 有两部分组成,一是错误信息的显示,比如提交时数据验证失败显示错误信息;第二部分即是表单的数据了
在新增页面提交表单 最终会调用到Controller的create方法,保存数据...
1.7 测试以上所写的代码是否正确:
> rake test
This is for the unit, functional, and integration tests that?
Rails generates along with the scaffolding. 注意当修改了Controller,Model中的代码时,
运行rake test可能会报错,这时候需要对test/中相应的测试文件进行修改.
1.8 在服务器启动时,进行初始化数据的导入.下面这种方式更加对象化,而不是用insert SQL语句:
-> db/seeds.rb
Product.create(:title=>'sth',:description=>'sth',:image_url=>'spath',:price=>11.22)
> rake db:seed ?
@ http://localhost:3000/products
?
1.9 关于全局Layout:
app/views/layouts/application.html.erb?
所有的views/*/*.html.erb都将继承application.html.erb的布局.可以在这里写每个页面固定的开头和结尾.
Rails keeps a separate file that is used to create a standard page environment for the entire application
?
application.html.erb, be the layout used for all views for all controllers that don’t otherwise provide a layout.
除非Controller有自己的Layout会覆盖掉全局的Layout.否则Application Layout会应用到所有的视图里.
?
We loaded some test data into the database(1.8), we rewrote the index.html.erb file
that displays the listing of products, we added a depot.css stylesheet, and that
stylesheet was loaded into our page by the layout file application.html.erb(1.9).?
?
===========================================
Chapter 7. Task B: Validation and Unit Testing
2.1 给Product Model添加字段验证:
-> app/models/product.rb
class Product < ActiveRecord::Base
validates :title, :description, :image_url, :presence => true
validates :price, :numericality => {:greater_than_or_equal_to => 0.01}
validates :title, :uniqueness => true
validates :image_url, :format => {
:with => %r{\.(gif|jpg|png)$}i,
:message => 'must be a URL for GIF, JPG or PNG image.'
}
end
访问http://localhost:3000/products/new 提交时会对输入域进行验证 如果验证失败则会在页面顶部显示错误信息.
2.2 给Model添加验证后的单元测试:
> rake test
运行测试脚本,会发现报错test/functional/products_controller_test.rb:
test_should_create_product test_should_update_product?
很显然当我们增加了Model的验证代码,测试部分也需要更改:
在测试脚本文件中ProductsControllerTest 的setup方法里初始化一个Product对象@update
并在2个报错的方法里把product: @product.attributes 改为 :product => @update指向初始化的product对象
setup方法第一行: @product = products(:one) 获取test/fixtures/products.yml中的数据
这是测试文件初始化加载的数据,正如seeds.rb是项目启动时初始化加载的数据
2.3test类型有2种:
unit针对Model测试 test/unit/product_test.rb?
class ProductsControllerTest < ActionController::TestCase
可以运行:> rake test:units
functional针对Controller测试 test/functional/products_controller_test.rb?
class ProductTest < ActiveSupport::TestCase?
可以运行命令:>rake test:functionals
rake test 会测试整个项目是否有错误
===========================================
Chapter 8. Task C: Catalog Display
3.1 创建前台Product展示的控制器和页面:
> rails generate controller store index
创建StroeController和对应的Controller的index方法
和rails generate scaffold不同的是创建脚手架会创建Model,Controller,View,数据库脚本,测试文件等
而generate controller则只创建Controller:
app/controllers/store_controller.rb
app/views/store/index.html.erb
test/functional/store_controller_test.rb
还有一点区别是用generate scaffold创建的View和Controller是复数形式,Model是单数;
而generate controller则是单数.
3.2 上面的命令创建了StoreContoller以及index方法,通过URL:?
http://localhost:3000/store/index则会调用对应的方法.进入views/store/index.html.erb
-> config/routes.rb?
root :to => 'store#index', :as => 'store'
3.3删除原先根目录下对应的文件:
> rm public/index.html?
当访问 http://localhost:3000 等价于上面的http://localhost:3000/store/index
进入的页面是: views/store/index.html.erb
3.4 访问规则测试:
http://localhost:3000/products 进入后台ProductList的显示页面views/products/index.html.erb
http://localhost:3000/products/index 则会报错:
ActiveRecord::RecordNotFound in ProductsController#show Couldn't find Product with id=index
http://localhost:3000/store 报错:Routing Error No route matches [GET] "/store"
由此可见通过generate scaffold,URL:/products代表访问的是ProductsController的index方法.
但是不能这样子访问:/products/index.
而通过generate controller,contoller中定义了哪些方法,
要访问该方法对应的页面则在controller后加上/方法名即可对应.
===========================================
Chapter 9. Task D: Cart Creation
4.1 创建购物车对象脚手架.但是没有给Cart指定字段:
> rails generate scaffold cart
> rake db:migrate
-> app/controllers/application_controller.rb
class ApplicationController < ActionController::Base
protect_from_forgery
private
def current_cart
Cart.find(session[:cart_id])
rescue ActiveRecord::RecordNotFound
cart = Cart.create
session[:cart_id] = cart.id
cart
end
?
4.2 创建购物项的脚手架:
> rails generate scaffold line_item product_id:integer cart_id:integer
> rake db:migrate
4.3 目前为止的数据库脚本(schema.rb):
create_table "carts"
end
?
create_table "line_items"
t.integer ?"product_id"
t.integer ?"cart_id"
end
?
create_table "products"
t.string ? "title"
t.text ? ? "description"
t.string ? "image_url"
t.decimal ?"price", ? ? ? :precision => 8, :scale => 2
end
由此可见line_items可以当做carts和products的中间表.
?
4.3 Connecting Products to Carts: 将Product和Cart互相关联
-> app/models/cart.rb
Cart?
has_many :line_items
-> app/models/line_item.rb
LineItem?
belongs_to :product?
belongs_to :cart
-> app/models/product.rb
Product?
has_many :line_items
Cart 1---->N LineItem N<----1 Product ...Order
一个Cart可能有多个LineItem,一个Product也可能有多个LineItem(多个LineItem可能对应一个Product)
?
4.4 line_items涉及到的级联删除:
?
4.5 给前台的每个Product添加一个购买按钮:
-> app/views/store/index.html.erb
<%= button_to 'Add to Cart', line_items_path(:product_id => product) %>
button_to line_items_path(:product_id => product) 是如何调用到LineItemsController的create方法?
button_to : POST ;line_items_path : /line_items
LineItemsController中满足POST /line_items的只有create方法
如果是link_to line_items_path. link_to : GET line_items_path 则对应的方法为index
-> app/controllers/line_items_controller.rb
def create
@cart = current_cart
product = Product.find(params[:product_id])
@line_item = @cart.line_items.build(:product => product)
#...
end
为什么是LineItemsController.create而不是CartsController.create.
而且ApplicationController中Cart.create是在哪里定义的?(这个稍后解释)
把Product加入购物车中,即创建了一个购物项.所以使用的是LineItemsController.create.
find the shopping cart for the current session(@cart = current_cart),?
add the selected product to that cart(@cart.line_items.build), and display the cart contents.
pass that product we found into @cart.line_items.build.?
This causes a new line item relationship to be built between the @cart object and the product.
4.6添加一个购物项后指向Cart页面,而不是购物项本身:
在LineItemsController.create方法中,
if @line_item.save #保存后
format.html { redirect_to @line_item.cart }
Since the line item object knows how to find the cart object,?
all we need to do is add .cart to the method call
那么调用的是CartsController的哪个方法index? show? 换句话说进入的是哪个页面?
@line_item.cart 通过LineItem得到Cart对象,所以实际上是传递了cart_id这个参数.
所以URL的形式应该是/carts/cart_id 类型为GET.满足的方法是show
可以这么理解:将一个购物项加入购物车中,而且这个购物车是Session中唯一的.
如果是/casts即所有的购物车List.显然在我们的应用中是说不通的.
所以app/views/carts/show.html.erb 通过Cart取出当前购物车中所有的购物项
<% @cart.line_items.each do |item| %>
<li><%= item.product.title %></li>
<% end %>
4.7 添加购物项的Functional测试:
因为LineItemsController修改的是create方法.接收参数:product_id
所以test/functional/line_items_controller_test.rb修改的也是对应的create方法并传递需要的参数:
post :create, :product_id => products(:ruby).id?
products(:ruby)是test/fixtures/products.yml中的ruby:对应的记录.
测试重定向: assert_redirected_to cart_path(assigns(:line_item).cart)
cart_path:/carts/ assigns(:line_item).cart把购物项对应的购物车对象的id取出来并设置值,即cart_id
运行测试命令: rake test:functionals
有点不明白这里的Functional测试,在前台Product展示页面添加一个购物项到购物车中,
这里能调用到测试的代码吗??
4.8 测试Session:
在Window上跑Ruby有点慢.有时候启动服务器,刷页面,但是没有反应.
还有更奇怪的问题是,有时候点击Add To Cart,浏览器的地址不是:http://localhost:3000/carts/3
而是http://localhost:3000/line_items?product_id=1 页面会报错说没有line_items这个方法.
这时候可以对服务器Ctrl+C终止下. 然后他就会报一堆的错,但页面却恢复正常了. 这里估计没有完全中止服务器.
测试Session,可以这样子做.关掉浏览器.Session中保留的cart_id消失.
重新访问http://localhost:3000. 点击某个Product购买,URL变为: http://localhost:3000/carts/4?
这里的4是新生成的Session中的cart_id.因为如果Session中找不到cart_id?
则会重新创建一个新的Cart对象,并把cart_id放入Session中.
同时购物车中的数据只会显示当前添加的Product.
关掉浏览器之前的那次会话的数据(sessionId=3)是不会存在在当前的这个Session中(sessionId=4).
4.9 查看别的数据:
如果想看LineItems,即所有Cart对应哪些Product. 访问:http://localhost:3000/line_items
似乎有点难以理解. 因为一般来说一个浏览器在当前只会有一个Cart,即一个Session中只能有一个Cart.
不过这个结果可以理解为另一种概念: 浏览器的访问历史记录.
如果访问http://localhost:3000/carts 则是看不到数据的.
但是会有多个Show Edit Destroy链接.不过这样的URL没有什么意义了.
?
