rails规范

Ruby on rails 开发规范
					

(一)目录 结构的 一些约定
		目录结构如下
├─app                          
│  ├─controllers  
│      └─application_controller.rb
│  ├─helpers
│      └─application_helper.rb
│  ├─mailers
│  ├─models
│  ├─views
│       ├─layouts
│            └─application.html.erb
├─config
│  ├─environments
│ 	    └─development.rb
│  	└─production.rb
│  	└─test.rb
│ 	├─initalizers
│  	└─backtrace_silencers.rb
│  	└─inflections.rb
│  	└─mime_types.rb
│  	└─secret_token.rb
│ 		└─session_store.rb
│  ├─locales
│ 		└─en.yml
│  └─application.rb
│  └─boot.rb
│  └─database.yml
│  └─environment.rb
│  └─routes.rb

├─db
│  └─seeds.rb 
├─doc
│  └─README_FOR_APP

├─lib
│  ├─tasks
│       └─.gitkeep
├─log
│ 	└─development.rb
│    └─production.rb
│    └─test.rb

├─public
│  ├─images
│  ├─javascripts
│  ├─stylesheets
│  └─404.html
│  └─422.html
│  └─500.html
│  └─favicon.ico
│  └─index.html
│  └─robots.txt
├─script
│  └─rails
├─test
│  ├─fixtures
│  ├─functional
│  ├─integration
│  ├─performance
│  ├─unit
│  └─test_helper.rb
├─tmp
│  ├─cache
│  ├─pids
│  ├─sessions
│  ├─sockets
├─vendor
│  ├─plugins
│  	└─.gitkeep
└─.gitignore
└─config.ru
└─Gemfile
└─Rakefile
└─README



     
app:Model,View,Controller都在这个目录下,大部分的工作都在这里进行。其中admin为管理类文件
config:数据库配置信息。
db:存放数据库schema和migration信息
doc:存放文档,RDoc自动生成的文档
lib:存放在Model, View和Controller间共享的代码分包
    为方便整理,不同功能的代码可放到其不同的子目录下.
调用sub_dir下的my_lib_code.rb代码的方法为: require "sub_dir/my_lib_code"
log:项目的日志信息,里面有development.log,production.log,server.log,test.log,我们在开发时的信息都写在development.log里,而测试时的log都写在test.log里。
public:web服务器把这个目录作为应用程序的根目录,可以从Web访问的目录,如果我们在浏览器的地址栏里直接输入:http://localhost:3000/那么看到的就是这里的index.html页面。
script:Rails用到的脚本,也即常用的工具程序比如:generate
test:Model测试,功能测试,测试用的数据等等。
vendor:存放外来代码, 如外来插件, 也可用来放rails构架本身, 以使rails兼容不同版本需求的程序.
tmp: 临时文件,如:cache

注释
1)	#
# 注释内容
#
2)
  =begin
  =end

(二)命名规范:
(1)基本命名规则:
1)	局部变量和方法名(method):都是小写,若以多个单词命名,则单词与单词之间用 ”_” 连接, 在 Rails 中连文件名也是按照这个规则命名:				如: user_username(局部变量)get_username(方法名), user_controller.rb    (文件名) 
2)	实例(Instance) 变量:(就是每个 Object Instance 都有的变量), 要用 ”@” 开头,其余的规则和局部变量一致										如: @name, @created_at 
3)	类(Class) 变量:(就是每个 Object Instance 都会共用的变量), 要用 "@@" 开头,其余的规则和局部变量一致											如: @@lookup_table, @@count 
4)	全局变量:要用 ”$” 开头,其余的规则和局部变量一致		 			如: $global
5)	常量:一般首字母大写,但建议全部大写,以多个单词命名,则单词与单词之间用 ’_’ 连接															如:PDF_KEK
6)	Class 名字也是属于常量:但都是开头大写其他小写并且单词与单词之间直接相连	如: AciveRecord, ApplicationController 
7)	模块与类:所有单词首字母大写,其余小写并且单词与单词之间直接相连		如:ArticlesHelper(模块),AdminBaseController(类)
8)	 参数:都是小写,若以多个单词命名,则单词与单词之间用 ”_” 连接,使用有意义的参数命名,如果可能的话,使用和要赋值的字段一样的名字				如:name

(2)命名约定:
1)	控制器(controller)、助手(helper)、视图(views)一般使用复数,实体(model)使用单数,数据库表名使用实体名称的复数					如:users_controller、users_helper、users、user、users(此顺序和上述表述一一对应)
2)	局部模板以下划线开始

(三)编程规范:
(1)编程规范:
1)	关键字之后留空格
2)	 逗号“,”、分号“;”后留空格,“,”、“;”向前紧跟,紧跟处不留空格
3)	sql语句 全部小写
4)	尽量避免一行的长度超过80个字符
5)	不允许把多个短语句写在一行中,即一行只写一条语句
6)	若函数或过程中的参数较长,则要进行适当的划分
7)	长表达式要在低优先级操作符处划分新行,操作符放在新行之首
8)	较长的语句、表达式等要分成多行书写
9)	相对独立的程序块与块之间加空行
10)函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格

(2)编程惯例:
		功能书写
			View 层 负责页面数据显示
				    尽可能的瘦和简单化
				    尽可能合理的情况下,不写入业务逻辑
				    尽量把条件逻辑放在控制层
			Controller层 负责业务逻辑 
方法与变量要有必要的注释说明
			Model 层 负责单表数据处理与服务器端数据校验规则
helpers层 负责页面表现逻辑
		
				
(四)可读性
	  (1)避免使用不易理解的数字、字母,使用有意义的标识来替代。  
(2)不要使用难懂的技巧性很高的语句。            
(3)源程序中关系较为紧密的代码应尽可能相邻。	


你可能感兴趣的:(Rails,rails规范)