Rails之道PDF电子书下载

第1章　Rails环境与配置 1

1.1 启动 1

1.1.1　默认环境设置 1

1.1.2 引导 2

1.1.3　RubyGems 3

1.1.4　初始化 4

1.1.5　默认加载路径 4

1.1.6　Rails模组及代码自动加载 5

1.1.7 内置的Rails信息 5

1.1.8　配置 6

1.1.9 附加配置 8

1.2　开发模式 8

1.2.1 类文件自动化重新加载 9

1.2.2　Rails类加载器 9

1.3 测试模式 10

1.4　生产模式 11

1.5 日志器 11

1.5.1　Rails日志文件 12

1.5.2 日志分析 13

1.5.3 Syslog 15

1.6　总结 15

第2章　运用控制器 16

2.1　调度器：从这里开始 16

2.1.1　接收请求 17

2.1.2　和调度器亲密接触 17

2.2　渲染视图 18

2.2.1　何时开始渲染 19

2.2.2　指定渲染 19

2.2.3　渲染其他动作的模板 19

2.2.4 渲染一个完全不同的模板 20

2.2.5　渲染局部模板 20

2.2.6　渲染内联模板代码 21

2.2.7　渲染文本 21

2.2.8 渲染其他类型的数据结构 21

2.2.9　什么都不渲染 21

2.2.10　渲染的属性 22

2.3 重定向 23

2.4　控制器和视图之间的通信 25

2.5 过滤器 25

2.5.1　过滤器继承 26

2.5.2　过滤器的类型 27

2.5.3　过滤器的队列的顺序 28

2.5.4 Around过滤器 28

2.5.5　跳过过滤器 29

2.5.6　过滤器条件 29

2.5.7　过滤器挂起 30

2.6　流 30

2.6.1 send_data(data,options={}) 30

2.6.2 send_file(path,options={}) 31

2.6.3　让web服务器发送文件 33

2.7 小结 33

第3章　路由 34

3.1　路由的两个目的 35

3.2　绑定参数 35

3.3　使用通配符（“接收器”） 36

3.4　静态字符串 37

3.5 route.rb文件 38

3.5.1 默认的路由信息 39

3.5.2　聚焦在：id字段 40

3.5.3　默认的路由生成规则 40

3.5.4　修改默认的路由信息 41

3.6　默认路由信息之前的信息和respond_to 41

3.7　空的路由信息 42

3.8　编写自定义路由规则 43

3.9　使用静态字符串 43

3.10　使用你自己的“接收器” 44

3.11 关于路由次序的说明 45

3.12　在路由信息中使用正则表达式 45

3.13　默认参数和url_for方法 46

3.14　使用文字化的URL 47

3.15　路由中的通配字段 47

3.16　通配符的键—值对 48

3.17 具名路由 48

3.17.1　创建具名路由 49

3.17.2 比较name_path和name_url的使用 49

3.17.3 请考虑 49

3.18　如何命名你的路由 50

3.18.1 参数糖衣 50

3.18.2　更多糖衣 51

3.19　特殊的范围方法with_options 51

3.20　小结 52

第4章　REST，资源和Rails 53

4.1 REST简介 53

4.2 Rails的REST 54

4.3　路由选择和CRUD 54

4.4　资源和表现 55

4.4.1 REST资源与Rails 55

4.4.2　从具名路由到REST支持 55

4.4.3 重新认识HTTP方法 56

4.5　标准的REST化的控制器动作 57

4.5.1 模拟PUT和DELETE操作 58

4.5.2 REST化的资源的单数和复数 58

4.5.3　特殊的拍档：new/create和edit/update 58

4.6　单数的资源路由 59

4.7 嵌套资源 59

4.7.1 显式地设置：path_prefix 60

4.7.2　显式地设置：name_prefix 61

4.7.3 显式地设置REST化的控制器 61

4.7.4　使用所有选项 62

4.7.5　思考嵌套路由 63

4.7.6 嵌套过深 63

4.8 自定义REST化的路由 64

4.8.1　添加成员路由 65

4.8.2　添加集合路由 65

4.8.3 思考 65

4.9　仅有控制器的资源 67

4.10　资源的不同展现形式 68

4.10.1 respond_to方法 68

4.10.2　格式化具名路由 68

4.11 REST化的Rails动作集合 69

4.11.1 Index 69

4.11.2 Show 71

4.11.3 Destory 71

4.11.4 New和Create 72

4.11.5 Edit和Update 73

4.12 小结 74

第5章　探究路由选择 75

5.1　在应用程序控制台检查路由 75

5.1.1　转存路由信息 75

5.1.2　剖析Route对象 76

5.1.3 在控制台识别和生成路由 78

5.1.4　控制台的具名路由 79

5.2　测试路由 80

5.3 Routing Navigator插件 80

5.4 小结 81

第6章　运用ActiveRecord 82

6.1 基础知识 82

6.2　数据迁移 84

6.2.1　创建迁移 84

6.2.2　用于迁移的API 87

6.2.3　定义列 88

6.3　宏样式方法 92

6.3.1　关系声明 93

6.3.2　约定优于配置 93

6.3.3 复数化 94

6.3.4　手动设置名字 95

6.3.5　遗留的命名约定 95

6.4　定义属性 96

6.4.1　默认属性值 96

6.4.2　序列化属性 98

6.5 CRUD：创建、读取、更新和删除 98

6.5.1 创建新的ActiveRecord实例 98

6.5.2　读取ActiveRecord对象 99

6.5.3　读写属性 100

6.5.4　在类型转换之前访问并且操作属性 102

6.5.5 重新载入 102

6.5.6　基于属性的动态查找器 102

6.5.7　自定义SQL查询 103

6.5.8　查询缓存 104

6.5.9　更新 106

6.5.10　基于条件的更新 107

6.5.11　更新特定实例 107

6.5.12　更新特定属性 107

6.5.13　便利的更新器 108

6.5.14　控制对属性的访问 108

6.5.15　删除和销毁 109

6.6　数据库锁定 109

6.6.1　乐观锁定 110

6.6.2 悲观锁定 111

6.6.3　需要考虑的问题 112

6.7　高级查找 112

6.7.1 条件 112

6.7.2　查询结果集的排序 114

6.7.3　限制和偏移量 114

6.7.4 select选项 115

6.7.5 from选项 115

6.7.6 group by选项 115

6.7.7 locking选项 116

6.7.8　连接和包含关联 116

6.7.9 read only 116

6.8　在不同的数据模型中连接多个数据库 116

6.9　直接使用数据库连接 117

6.9.1 DatabaseStatements模组 118

6.9.2　其他连接方法 119

6.10　其他配置选项 120

6.11 小结 121

第7章　ActiveRecord关联 122

7.1　关联的继承关系 122

7.2　一对多关联 123

7.2.1 向集合添加已经关联的对象 124

7.2.2 AssociationCollection的方法 125

7.3 belongs_to关联 127

7.3.1　重新载入关联 127

7.3.2　通过关联来构建（build）或创建（create）相关对象 128

7.3.3 belongs_to的选项 128

7.4 has_many关联 132

7.4.1 has_many的选项 133

7.4.2　代理方法 137

7.5　多对多关系 138

7.5.1 has_and_belongs_to_many 138

7.5.2 has_many:through 143

7.5.3 has_many:through的选项 146

7.6　一对一关系 148

7.6.1 has_one 148

7.6.2 has_one的选项 150

7.7　未保存的对象和关联 151

7.7.1 一对一关联 151

7.7.2　集合 152

7.8　关联的扩展 152

7.9 AssociationProxy类 153

7.10　小结 154

第8章　ActiveRecord验证 155

8.1 查找错误 155

8.2　简单的验证声明 155

8.2.1 validates_acceptance_of 156

8.2.2 validates_associated 156

8.2.3 validates_confirmation_of 156

8.2.4 validates_each 157

8.2.5 validates_inclusion_of和validates_exclusion_of 157

8.2.6 validates_existence_of 158

8.2.7 validates_format of 158

8.2.8 validates_length_of 159

8.2.9 validates_numericality_of 159

8.2.10 validates_presence_of 159

8.2.11 validates_uniqueness_of 160

8.2.12 RecordInvalid 161

8.3 通用验证选项 161

8.3.1 :allow_nil 161

8.3.2 :if 161

8.3.3 :message 161

8.3.4 :on 161

8.4　条件认证 162

8.5　使用Errors对象 163

8.5.1 操作Errors集合 163

8.5.2 Errors的检查 163

8.6 自定义验证 164

8.7　跳过验证 164

8.8 小结 165

第9章　ActiveRecord的高级技巧 166

9.1　回调方法 166

9.1.1　注册回调方法 167

9.1.2 匹配before/after回调方法 167

9.1.3 中断执行 168

9.1.4　使用回调方法 168

9.1.5　特殊的回调方法：after_initialize和after_find 170

9.1.6　回调方法类 171

9.2　观察器 173

9.2.1　命名规则 173

9.2.2　注册观察器 174

9.2.3　时机 174

9.3　单表继承（single-table inheritance,STI） 174

9.3.1 将继承映射到数据库 176

9.3.2 STI值得注意的几点 177

9.3.3 STI和数据模型关联 177

9.4　抽象数据类型的基类 179

9.5　多态的has_many关系 180

9.5.1　假如数据模型带有注释功能 180

9.5.2　使用has_many的注意事项 182

9.6　用以重用通用行为的模块 182

9.6.1 回顾类的作用范围和环境 184

9.6.2 Include回调方法 185

9.7　在运行时修改ActiveRecord 186

9.7.1 应用时的注意事项 187

9.7.2 Ruby和域指定语言 187

9.8　小结 188

第10章　ActionView 189

10.1 ERb基础 189

10.1.1 ERb实践 189

10.1.2　整理ERb输出 191

10.1.3 ERb分隔符中的注释 191

10.1.4　条件输出 191

10.1.5 RHTML?RXML?RJS? 191

10.2　布局和模板 192

10.2.1　使用Yield生成内容 193

10.2.2　模板变量 194

10.2.3　针对用户提交的数据保护你的视图 196

10.3　局部模板 197

10.3.1　简单的使用示例 197

10.3.2　重用局部模板 198

10.3.3　共享局部模板 198

10.3.4　给局部模板传递变量 199

10.3.5 渲染数据集合 200

10.3.6 日志 201

10.4　缓存 201

10.4.1　在开发模式下的缓存 201

10.4.2 页面缓存 202

10.4.3 动作缓存 202

10.4.4　片段缓存 203

10.4.5　缓存内容的期限 205

10.4.6　使用Sweeper自动过期缓存 206

10.4.7　缓存日志 207

10.4.8 Action Cache插件 208

10.4.9　缓存的存储 208

10.5 小结 209

第11章　辅助方法 210

11.1 ActiveRecordHelper 210

11.1.1　报告验证的错误 210

11.1.2　自动创建表单 212

11.1.3 自定义验证错误的高亮方式 213

11.2 AssetTagHelper 214

11.2.1 Head的辅助方法 214

11.2.2　针对插件的辅助方法以设定默认的JavaScript文件 217

11.3 BenchmarkHelper 217

11.4 CacheHelper 217

11.5 CapturelHelper 218

11.6 DateHelper 218

11.6.1 日期时间选择 218

11.6.2　单个日期和时间选择辅助 219

11.6.3 日期选择辅助方法的通用选项 220

11.6.4　名字复杂的distance_in_time方法 221

11.7 DebugHelper 222

11.8 FormHelper 222

11.8.1　通过表单创建Active Record模型 222

11.8.2　表单辅助方法是怎样取值的？ 227

11.9 FormOptionsHelpers 228

11.9.1 Select标签的辅助器 228

11.9.2 Option标签的辅助器 229

11.10 FormTagHelper 232

11.11 JavaScriptHelper 234

11.12 NumberHelper 235

11.13 PaginationHelper 236

11.13.1 will_paginate 236

11.13.2 paginator 237

11.13.3 Paginating Find 237

11.14 RecordIdentification 237

11.15 RecordTagHelper 239

11.16 TagHelper 239

11.17 TextHelper 240

11.18 UrlHelper 245

11.19　编写你自己的辅助方法 249

11.19.1　小小的优化：Title辅助方法 249

11.19.2　封装视图的逻辑：photo for辅助方法 250

11.19.3　智能视图：breadcrumbs辅助方法 250

11.20　包装并生成局部视图模板 251

11.20.1 一个tiles辅助器 251

11.20.2　生成局部模板 253

11.21 小结 255

第12章　Ajax on Rails 256

12.1 Prototype 257

12.1.1 FireBug 257

12.1.2 Prototype API 257

12.1.3　顶层函数 258

12.1.4　类 259

12.1.5 JavaScript的对象类的扩展 259

12.1.6 扩展JavaScript的Array类 260

12.1.7　扩展document对象 261

12.1.8　扩展Event类 261

12.1.9　扩展JavaScript的Function类 263

12.1.10　扩展JavaScript的Nubmer类 263

12.1.11 扩展JavaScript String类 264

12.1.12 Ajax对象 266

12.1.13 Ajax.Responders 266

12.1.14 Enumerable 267

12.1.15 Hash 270

12.1.16 ObjectRange 271

12.1.17 Prototype对象 271

12.2 PrototypeHelper模组 271

12.2.1 link_to_remote 271

12.2.2 remote_form_for 274

12.2.3 periodically_call_remote 275

12.2.4 observe_field 276

12.2.5 observe_form 277

12.3 RJS—在Ruby中编写Javascript 277

12.3.1 RJS模板 278

12.3.2 <<(javascript) 279

12.3.3 [](id) 279

12.3.4 alert(message) 279

12.3.5 call(function,*arguments,＆block) 279

12.3.6 delay(seconds=1){...} 280

12.3.7 draggable(id,options={}) 280

12.3.8 drop_receiving(id,options={}) 280

12.3.9 hide(*ids) 280

12.3.10 insert_html(position,id,*options_for_render) 280

12.3.11 literal(code) 281

12.3.12 redirect_to(location) 281

12.3.13 remove(*ids) 281

12.3.14 replace(id,*options_for_render) 281

12.3.15 replace_html(id,*options_for_render) 281

12.3.16 select(pattern) 281

12.3.17 show(*ids) 281

12.3.18 sortable(id,options={}) 282

12.3.19 toggle(*ids) 282

12.3.20 visual_effect(name,id=nil,options={} 282

12.4 JSON 282

12.5 Drag and Drop 283

12.6 Sortable 285

12.7 自动完成 285

12.8　可切换的编辑输入框 286

12.9 小结 287

第13章　Session管理 288

13.1　该把什么放在session中 288

13.1.1 当前用户 288

13.1.2 Session使用规则 289

13.2 Session属性 289

13.2.1　针对机器人关闭session功能 289

13.2.2　选择性开启session 290

13.2.3 安全的session 290

13.3　存储机制 290

13.3.1 ActiveRecord存储机制 291

13.3.2 PStore（基于文件的方式） 291

13.3.3 DRb Session存储机制 291

13.3.4 memcach存储机制 292

13.3.5 关于CookieStore的争议 292

13.4　超时机制和session生命周期 293

13.4.1 Session超时插件 294

13.4.2　跟踪活跃的session 294

13.4.3　增强安全性 295

13.4.4　清除陈旧的session 295

13.5 Cookies 295

13.6　小结 296

第14章　登录与认证 297

14.1 Acts as Authenticated 297

14.1.1　安装与设置 298

14.1.2 User数据模型 298

14.1.3 Account控制器 304

14.1.4　从Cooke中登录 306

14.1.5 当前用户 307

14.2　在登录期间测试 308

14.3 小结 309

第15章 XML和ActiveResource 310

15.1 to_xml方法 310

15.1.1 定制to_xml输出 311

15.1.2 to_xml和关联性 312

15.1.3 高级to_xml 313

15.1.4 运行时的动态属性 314

15.1.5 重载to_xml 315

15.1.6 由数组的to_xml方法所学到的 315

15.2 XML Builder 316

15.3 解析XML 318

15.3.1 将XML转换成散列 318

15.3.2 XmlSimple 319

15.3.3 类型转换 320

15.4 ActiveResource 320

15.4.1 Find 321

15.4.2 Create 322

15.4.3 Update 324

15.4.4 Delete 324

15.4.5 HTTP头信息 325

15.4.6 自定义 326

15.4.7 散列形式 327

15.5 小结 327

第16章 ActionMailer 328

16.1 安装 328

16.2 Mailer模型 328

16.2.1 准备要发出的邮件消息 329

16.2.2 HTML格式的邮件信息 331

16.2.3 复合格式的信息 331

16.2.4 文件附件 332

16.2.5 发送邮件 333

16.3 接收邮件 333

16.3.1 TMail∷Mail API参考 334

16.3.2 处理附件 334

16.4 配置 335

16.5 小结 335

第17章 测试 336

17.1 Rails中测试的专用术语 337

17.1.1 关于独立性 337

17.1.2 Rails的数据模拟 337

17.1.3 真正的数据模拟和占位代码 338

17.1.4 整合测试 339

17.1.5 避免概念混淆 339

17.2 Test∷Unit 340

17.3 数据装置 341

17.3.1 CSV格式的数据装置 342

17.3.2 在测试中访问数据装置中的记录 342

17.3.3 动态的数据装置的数据 343

17.3.4 在开发模式下使用数据装置中的数据 344

17.3.5 从开发数据中生成数据装置 344

17.3.6 数据装置的选项 345

17.3.7 大家都不喜欢数据装置 345

17.3.8 数据装置其实没那么糟糕 346

17.4 断言 347

17.4.1 基本的断言 347

17.4.2 Rails的断言 349

17.4.3 一个断言配一个测试方法 349

17.5 使用单元测试来测试数据模型 350

17.5.1 数据模型测试基础 350

17.5.2 决定测试什么 352

17.6 使用功能测试来测试控制器 352

17.6.1 结构和setup 352

17.6.2 功能测试方法 353

17.6.3 通用断言 353

17.7 使用功能测试来测试视图 356

17.7.1 测试RJS的行为 359

17.7.2 其他选择方法 359

17.7.3 测试路由规则 359

17.8 Rails整合测试 360

17.8.1 基础 361

17.8.2 整合测试的API 361

17.8.3 使用session 362

17.9 和测试相关的Rake任务 362

17.10 验收测试 362

17.11 Selenium 363

17.11.1 Selenium的基本概念 363

17.11.2 开始使用Selenium 364

17.11.3 RSelenese 365

17.12 小结 366

第18章 RSpec on Rails 367

18.1 介绍RSpec 367

18.1.1 Should和预期情况 368

18.1.2 结果预测 369

18.1.3 自定义预期情况匹配器 369

18.1.4 包含多个例子的行为 371

18.1.5 共享的行为 372

18.1.6 RSpec的数据模拟和占位代码 374

18.1.7 运行spec 376

18.1.8 安装RSpec和RSpec on Rails插件 378

18.2 RSpec on Rails插件 378

18.2.1 代码生成器 378

18.2.2 数据模型spec 378

18.2.3 控制器的spec 380

18.2.4 视图的spec 383

18.2.5 辅助器的spec 384

18.2.6 Scaffolding 385

18.3 RSpec工具 385

18.3.1 Autotest 385

18.3.2 RCov 385

18.4 小结 386

第19章 用插件扩展Rails 387

19.1 管理插件 387

19.1.1 重用代码 387

19.1.2 插件脚本 389

19.1.3 Subversion和script/plugin 391

19.2 使用Piston 392

19.2.1 安装 392

19.2.2 导入Vendor库 393

19.2.3 转换现有的Vendor库 393

19.2.4 更新 394

19.2.5 锁定和解锁版本 394

19.2.6 Piston属性 394

19.3 编写自己的插件 394

19.3.1 init.rb钩子 395

19.3.2 lib目录 396

19.3.3 扩展Rails类 396

19.3.4 README和MIT-LICENSE文件 397

19.3.5 install.rb和uninstall.rb文件 398

19.3.6 自定义Rake任务 399

19.3.7 插件的Rakefile 399

19.3.8 测试插件 400

19.4 小结 400

第20章 Rails生产环境配置 401

20.1 生产环境Rails的简史 401

20.2 一些基本的先决条件 402

20.3 软件集清单 403

20.3.1 服务器和网络环境 403

20.3.2 Web层 404

20.3.3 应用程序层 404

20.3.4 数据库层 404

20.3.5 监控 405

20.3.6 版本控制 405

20.4 安装 405

20.4.1 Ruby 405

20.4.2 RubyGems 405

20.4.3 Rails 406

20.4.4 Mongrel 406

20.4.5 Mongrel Cluster 406

20.4.6 Nginx 406

20.4.7 Subversion 407

20.4.8 MySQL 407

20.4.9 Monit 407

20.4.10 Capistrano 407

20.5 配置 408

20.5.1 配置Mongrel Cluster 408

20.5.2 配置Nginx 408

20.5.3 配置Monit 412

20.5.4 配置Capistrano 414

20.6 配置init脚本 414

20.6.1 Nginx init脚本 414

20.6.2 Mongrel init脚本 415

20.6.3 Monit配置 416

20.7 部署和发布 418

20.8 有关生产环境软件集的其他注意点 418

20.8.1 冗余和失效转移 418

20.8.2 缓存 418

20.8.3 性能和可扩展性 418

20.8.4 安全 419

20.8.5 可维护性 419

20.9 结论 419

第21章 Capistrano 421

21.1 Capistrano概述 421

21.1.1 术语 421

21.1.2 基础知识 422

21.1.3 Capistrano做了什么，没做什么 423

21.2 入门 423

21.2.1 安装 423

21.2.2 “Capify”你的Rails应用程序 423

21.2.3 配置部署 425

21.2.4 一些茧合脚本 425

21.2.5 设置部署目标服务器 426

21.2.6 部署！ 427

21.3 重载Capistrano的默认假定 427

21.3.1 使用远程用户账号 428

21.3.2 定制Capistrano使用的源代码管理系统（SCM） 428

21.3.3 部署目标服务器不能访问源代码管理系统（SCM） 428

21.3.4 如果我不把database.yml放在源代码库中 428

21.3.5 如果我的数据迁移不能从0运行到100 430

21.4 实用的Capistrano策略 431

21.4.1 变量和它们的有效范围 431

21.4.2 练习＃1：Staging 432

21.4.3 练习＃2：管理其他服务 434

21.5 多服务器部署 435

21.6 事务处理 436

21.7 代理访问部署目标服务器 437

21.8 小结 438

第22章 后台进程 439

22.1 script/runner 439

22.1.1 入门 440

22.1.2 用法说明 440

22.1.3 script/runner的考虑 441

22.2 DRb 441

22.2.1 一个简单的DRb服务 441

22.2.2 在Rails中使用DRb 442

22.2.3 DRb的考虑 442

22.2.4 资源 442

22.3 BackgrounDRb 443

22.3.1 入门 443

22.3.2 配置 443

22.3.3 理解BackgrounDRb 444

22.3.4 使用中间人 444

22.3.5 警告 445

22.3.6 BackGrounDRb的考虑 446

22.4 Daemons 446

22.4.1 用法 446

22.4.2 线程介绍 447

22.4.3 Daemon的考虑 448

22.5 小结 449

附录A ActiveSupport API参考 450

附录B Rails概要 498