目标:
1.创建用于保存货品信息的数据库表;
2.配置应用程序,使之指向我们的数据库
3.让rails帮我们生成"货品维护"应用的最初版本
1.创建应用程序:
rails depot
2.创建数据库
1).我们默认的是sqlite3,然后对应的database.yml文件信息:
development:
adapter: sqlite3 #当前使用数据库
database: db/development.sqlite3 #参数指定数据库的名称
pool: 5 #应用程序最多拥有的并发数据库连接
timeout: 5000 #在需要获得独占锁时最长等待时间
2).如果选择其他的数据库,开始创建应用的时候:
rails new --database=mysql depot
这样就会生成对应的数据库文件,database.yml
3)创建:rake db:create RAILS_ENV='development'
4)rake db:migrate 数据迁移,将新执行的操作,迁移到你在database.yml里面对应的数据库里;
5)rails g scaffold product title:string description:text image_url:string 新建 product表所对应的数据模型,包括model,控制器,数据表等
执行rake db:migrate之前,数据库里面是没有product表的,执行之后表才会生成;
[root@localhost db]# rake db:migrate
(in /root/ror/pro/depot)
== CreateProducts: migrating =================================================
-- create_table(:products)
-> 0.0171s
== CreateProducts: migrated (0.0172s) ======================================
3.向表中添加新的字段:
rails g migration product price:decimal
invoke active_record
create db/migrate/20131220071457_add_price_to_product.rb
然后:
rake db:migrate 数据迁移到数据库:
[root@localhost controllers]# rake db:migrate
(in /root/ror/pro/depot)
== AddPriceToProduct: migrating ==============================================
-- add_column(:products, :price, :decimal)
-> 0.0182s
== AddPriceToProduct: migrated (0.0183s) =====================================
要是数据插入不到table里面:查看控制器里面price参数字段是否加入其中:
params.require(:product).permit(:title, :description, :image_url,:price) ==>这个问题找了三天....估计是migration操作的时候没有更改控制器的参数!
4.表单验证函数:
class Product < ActiveRecord::Base
#validate the form blank and not null at the same time;The following two ways,either is OK.
下面两种方法是验证表单是否为空,具体使用参照:http://api.rubyonrails.org/classes/ActiveRecord/Validations/ClassMethods.html
# validates :title,:description,:image_url, presence: true
validates_presence_of :title,:description,:image_url
#validate the value of attributes is a right value
验证表单是否合法,第一步验证表单是否为数字,第二部调用方法:price_must_be_at_least_one_cent 验证范围!
validates_numericality_of :price #is a number or not!
validate :price_must_be_at_least_one_cent #valite the range of the value;
#validate the column is the Primary Key,Only have one is the table
validates_uniqueness_of :title
#validate the format of URL,验证url是否合法
validates_format_of :image_url,
# :with => %r{/.(gif|jpg|png)$}i, 这个正则表达式我验证是有问题的
:with => %r{([^\s]+(\.(?i)(jpg|png|gif|bmp))$)}i,
:message=> 'The url must be GIF,JPG or PNG image!'
说明:
这个方法的第二个参数有3点要说:
1). %r{String} 用于创建一个正则表达式字面值,用法如下:
%r{/usr/bin/} <==> ///usr//bin///
2). 这个正则表达式中$是指明该表达式的末尾,后面的i使正则表达式对大小写不敏感。
3). =>表示哈希表中的键值对,:with被称为符号对象,可看做是一个字符串常量。
protected #only call from inner class,the way of public must be indenfity before protected
def price_must_be_at_least_one_cent
errors.add(:price,'The price should be > 0!') if price.nil? || price<0
end
end
5.列表美观
在继续前进之前,最好有一组可靠的测试数据供我们使用。当然,我们可以用脚手架生成的界面从测览器输入数据。但如果我们这样做,以后别的开发者要修改这段代码就得做同样的事情。而且,如果我们在一支开发团队中工作,那么团队的每个成员都得自己输入一份数据。所以,最好还是用一种更可控的方式来填充数据。当然我们有办法,那就是迁移任务!
我们来创建一个纯数据的迁移任务,在def change 方法中先清空products 表,然后添加三条有代表性的数据;
rails g migration add_test_data
rake db:migrate
现在,来美化一下货品列表页面吧。这项工作分为两部分,最终我们会得到一个HTML 页面,其中使用CSS 来定义显示风格。不过,首先我们需要告诉浏览器到哪里去找样式表文件。
所有用脚手架生成的应用程序都会默认使用/app/assets/stylesheets 目录下的scaffold.css 样式表。我们不打算修改这个文件,而是为这个
应用程序新建了一份样式表depot.css,并将其放在同一个目录下。
http://media.pragprog.com/titles/rails3/code/depot_c/db/migrate/20080601000003_add_test_data.rb
http://media.pragprog.com/titles/rails3/code/depot_c/public/images
http://media.pragprog.com/titles/rails3/code/depot_c/public/stylesheets/depot.css
最后,我们需要把这些样式表链入HTML 页面。看看.html.erb文件,你不会发现任何对样式表的引用,甚至连通常放这些引用的<head> 标记都找不到。Rails 把这些信息保存在一个单独的文件中,它为所有的products 页提供一个标准的页面环境。这个叫做products.html.erb的文件是一个布局模板,就放在layouts目录下。
<%= stylesheet_link_tag 'scaffold', 'depot' %>
现在样式表已经到位了。我们要编辑app/views/products 目录下的index.html.erb 文件,只需要用一个简单的表格状模板替换掉脚手架生成的视图。
<div id="product-list">
<h1>Listing products</h1>
<table>
<% for product in @products %>
<tr class="<%= cycle('list-line-odd', 'list-line-even') %>">
<td>
<%= image_tag product.image_url, :class => 'list-image' %>
</td>
<td class="list-description">
<dl>
<dt><%=h product.title %></dt>
<dd><%= truncate(product.description.gsub(/<.*? >/,''),:length => 80)%></dd>
</dl>
</td>
<td class="list-actions">
<%= link_to 'Show', product %><br/>
<%= link_to 'Edit', edit_product_path(product) %><br/>
<%= link_to 'Destroy', product, :confirm => 'Are you sure? ', :method => :delete %>
</td>
</tr>
<% end %>
</table>
</div>
即便是这么简单的一个模板,也用到了Rails 内建的好几项特性:
l 列表中的每一行交替使用不同的背景颜色。为了实现这一效果,我们需要交替地将每一行的CSS 类型设置为list-line-even 和list-line-odd。cycle()这个辅助方法专门用于这一功能:将列表中的各行交替地设置为两种不同的样式。
l truncate() 辅助方法让描述信息只显示出前80 个字符,在使用truncate() 方法前我们先用gsub() 方法去除描述信息中的HTML 标记41 。
l 我们还用h() 方法来保证货品名称和描述中的HTML 标记被当作普通文本。
l 看看link_to 'Destroy'这行代码,后面有:confirm=>"Are you sure? " 这么一个参数。如果点击这个链接, Rails 就会让你的浏览器弹出一个对话框,问你是否确定要删除货品。
表单验证引申:
validates_presence_of :login, :message => "用户名不能为空!"
validates_length_of :login, :maximum => 20, :message => "用户名长度不得长于20位字母或数字!"
validates_uniqueness_of :login,:case_sensitive => false, :message => "该用户名已存在!"
validates_presence_of :password, :message =>"密码不能为空!"
validates_length_of :password, :minimum => 6, :message=>"密码长度不得短于6位字母或数字! "
validates_presence_of :password_confirmation, :message =>"请再输入一次密码!", :allow_blank => true
validates_confirmation_of :password, :message => "两次密码不一致!"
validates_format_of :email, :message => "邮箱格式不正确!", :with => /\A([^@\s]+)@((?:[-a-z0-9]+\.)+[a-z]{2,})\Z/i
说明:
1.":allow_blank=true",在其它的验证出错时,该字段为空的时候不空触发。即,
validates_presence_of :password, :message =>"密码不能为空!"
validates_length_of :password, :minimum => 6, :message=>"密码长度不得短于6位字母或数字! "
validates_presence_of :password_confirmation, :message =>"请再输入一次密码!", :allow_blank => true
如果用户输入password为空,只提示"密码不能为空!" 和 "密码长度不得短于6位字母或数字! ",不显示"请再输入一次密码!"错误信息。
2.ruby4.0.0还可以使用下面这种格式:
validates :abstract, length: { maximum: 140 }
下面将分别对这五种验证方法进行详细的介绍:
1、validates_presence_of —— 确认属性值不为nil也不为空。
用法: validates_length_of attr..., [ 选项... ]
选项:
:message => 缺省是 "is can't be blank."
:on =>:save, :create, 或 :update
2、validates_length_of —— 确认属性值的长度。遵循一些约束: 至少要给出一个长度(如固定长度:is,最小长度:minimum,最大长度:maximum,或一个区间:in or :within,但是这四者只能选其一,长度不能负数),而不能只有单个:message选项,这个确认器允许为不同的确认失败分离消息,只要:message还可以使用。
用法: validates_length_of attr..., [ 选项... ]
例子:
validates_length_of :name, :maximum => 50 #这个时候可以自定义:message
validates_length_of :password, :in => 6..20 #这个时候采用默认的:message,忽略自定义内容
validates_length_of :address, :minimum => 10, :message => "seems too short"
选项:
:in (或 :within) =>值的长度必须在一个范围内。
:is => integer, 值必须是整数的字符长度。
:minimum =>是一个integer, 值不能小于此整数。
:maximum=> 是一个integer ,值不能大于此整数。
:message =>是一个 text ,消息可以包含一个将被maximun,minimum,或确定长度代替的%d序列。
:on=> :save, :create, 或 :update
:too_long => 是一个text ,使用:maximum时的:message同义词。
:too_short =>是一个 text,使用:minimum时的:message同义词。
:wrong_length =>是一个 text,使用:is 时的:message同义词。
3、validates_uniqueness_of —— 确认属性是唯一的。对于每个属性,确认数据库内的其它行当前没有与给定列同样的值。
用法: validates_uniqueness_of attr... [ 选项... ]
选项:
:message => 缺省是 "has already been taken."
:on =>:save, :create, 或 :update
:scope => attr Limits the check to rows having the same value in the column as the row being checked.
4、validates_confirmation_of —— 确认字段和它的值有同样内容。很多表单要求用户输入同一信息两次(如确认密码)如果你使用命名约定,即第二字段的名字附有_confirmation,你可以使用validates_confirmation_of ()来检查两个字段是否有同样的值。
用法:validates_confirmation_of attr... [ 选项... ]
选项:
:message => 缺省是"doesn't match confirmation."
:on =>:save, :create, 或 :update
5、validates_format_of —— 在一个模式上确认属性。通过与正则表达式匹配它的值来确认每个字段。
用法:validates_format_of attr..., :with => regexp [ 选项... ]
选项:
:message => 缺省是"is invalid."
:on =>:save, :create, 或 :update
除了以上五种常用的验证方法之外,还有一些验证如下:
6、validates_acceptance_of —— 确认checkbox是否被标记。许多表单有checkbox,用户必须选择以便接受一些条款或条件。这个确认简单地检验这个box已经确认被标记,这个属性值是个字符串。属性本身并不被保存在数据库内(如果你希望明确地记录确认的话,没有什么东西会阻止你这样做)。
用法: validates_acceptance_of attr... [ 选项... ]
例子:
validates_acceptance_of :terms, :message => "Please accept the terms to proceed"
选项:
:message => 缺省是"must be accepted."
:on =>:save, :create, 或 :update
7、validates_associated —— 在关联的对象上完成确认。在给定的属性上完成确认,它被假设为是"活动记录模型"。对每个与属性关联的确认失败的话,一个单独的消息将被添加到那个属性的错误列表中(也就是说,个别的细节原因而出现的失败,将不会写到"模型"的错误列表中)。小心不要包含一个validates_associated()调用在彼此引用的"模型"中:第一个将会试图确认第二个,它依次将确认第一个等等,直接你堆栈溢出。
用法: validates_associated name... [ 选项... ]
例子:
class Order < ActiveRecord::Base
has_many :line_items
belongs_to :user
validates_associated :line_items, :message => "are messed up"
validates_associated :user
end
选项:
:message => 缺省是"is invalid."
:on =>:save, :create, 或 :update
8、validates_each —— 使用一个块来确认一或多个属性。为每个属性调用块(如果:allow_nil为true,则跳过是nil的属性)。传递属性的名字,属性的值到被确认的"模型"内。如下面例子显示的,如果一个确认失败,块应该被添加给"模型"的错误列表
用法: validates_each attr... [ 选项... ] { |model, attr, value| ... }
例子:
class User < ActiveRecord::Base
validates_each :name, :email do |model, attr, value|
if value =~ /groucho|harpo|chico/i
model.errors.add(attr, "You can't be serious, #{value}")
end
end
end
选项:
:allow_nil => boolean值, 如果 :allow_nil 为 true,带有值nil的属性将不被传递给块而是被跳过。
:on =>:save, :create, 或 :update
9、validates_exclusion_of —— 确认属性不在一组值中。确认属性没有出现在枚举中(任何对象都支持include()断言)。
用法:validates_exclusion_of attr..., :in => enum [ 选项... ]
例子:
class User < ActiveRecord::Base
validates_exclusion_of :genre,:in => %w{ polka twostep foxtrot },
:message => "no wild music allowed"
validates_exclusion_of :age, :in => 13..19, :message => "cannot be a teenager"
end
选项:
:allow_nil => 如果属性为nil,并且:allow_nil选项为true。则枚举不被检查。
:in (或 :within) => 一个可枚举对象。
:message => 缺省是"is invalid."
:on =>:save, :create, 或 :update
10、validates_inclusion_of —— 确认属性是否属于一个值集。确认每个属性的值是否出现在枚举中(任何对象都支持include?()断言)。
用法:validates_inclusion_of attr..., :in => enum [ 选项... ]
例子:
class User < ActiveRecord::Base
validates_inclusion_of :gender,:in => %w{ male female },
:message => "should be 'male' or 'female'"
validates_inclusion_of :age,:in => 0..130, :message => "should be between 0 and 130"
end
选项:
:allow_nil => 如果属性为nil,并且:allow_nil选项为true。则枚举不被检查。
:in (或 :within) => 一个可枚举对象。
:message => 缺省是 "is not included in the list."
:on =>:save, :create, 或 :update
11、validates_numericality_of —— 确认那个属性是有效的数字。确认每个属性是个有效数字。在:only_integer选项中,属性必须由可选的符号后跟随一个或多个数字。在选项中(或者如果选项不是true),可由Ruby Float()方法允许的任何浮点数都被接受。
用法:validates_numericality_of attr... [ 选项... ]
例子:
class User < ActiveRecord::Base
validates_numericality_of :height_in_meters
validates_numericality_of :age, :only_integer => true
end
选项:
:message => 缺省是 "is not a number."
:on=> :save, :create, 或 :update
:only_integer =>如果为 true,则属性必须是包含一个可选的符号后跟随数字的字符串。