androidjava代码规范Word下载.docx
《androidjava代码规范Word下载.docx》由会员分享，可在线阅读，更多相关《androidjava代码规范Word下载.docx（12页珍藏版）》请在冰点文库上搜索。
Service
表明这个类是个服务类，里面包含了给其他类提同业务服务的方法
PaymentOrderService
Impl
这个类是一个实现类，而不是接口
PaymentOrderServiceImpl
Inter
这个类是一个接口
LifeCycleInter
Dao
这个类封装了数据访问方法
PaymentOrderDao
Action
直接处理页面请求，管理页面逻辑了类
UpdateOrderListAction
Listener
响应某种事件的类
PaymentSuccessListener
Event
这个类代表了某种事件
PaymentSuccessEvent
Servlet
一个Servlet
PaymentCallbackServlet
Factory
生成某种对象工厂的类
PaymentOrderFactory
Adapter
用来连接某种以前不被支持的对象的类
DatabaseLogAdapter
Job
某种按时间运行的任务
PaymentOrderCancelJob
Wrapper
这是一个包装类，为了给某个类提供没有的能力
SelectableOrderListWrapper
Bean
这是一个POJO
MenuStateBean
1.4方法名
首字母小写，如addOrder（）不要AddOrder（）
动词在前，如addOrder（），不要orderAdd（）
动词前缀往往表达特定的含义，如下表：
前缀名
create
创建
createOrder（）
delete
删除
deleteOrder（）
add
创建，暗示新创建的对象属于某个集合
addPaidOrder（）
remove
removeOrder（）
init或则initialize
初始化，暗示会做些诸如获取资源等特殊动作
initializeObjectPool
destroy
销毁，暗示会做些诸如释放资源的特殊动作
destroyObjectPool
open
打开
openConnection（）
close
关闭
closeConnection（）<
read
读取
readUserName（）
write
写入
writeUserName（）
get
获得
getName（）
set
设置
setName（）
prepare
准备
prepareOrderList（）
copy
复制
copyCustomerList（）
modity
修改
modifyActualTotalAmount（）
calculate
数值计算
calculateCommission（）
do
执行某个过程或流程
doOrderCancelJob（）
dispatch
判断程序流程转向
dispatchUserRequest（）
start
开始
startOrderProcessing（）
stop
结束
stopOrderProcessing（）
send
发送某个消息或事件
sendOrderPaidMessage（）
receive
接受消息或时间
receiveOrderPaidMessgae（）
respond
响应用户动作
responseOrderListItemClicked（）
find
查找对象
findNewSupplier（）
update
更新对象
updateCommission（）
find方法在业务层尽量表达业务含义，比如findUnsettledOrders（），查询未结算订单，而不要findOrdersByStatus（）。
数据访问层，find,update等方法可以表达要执行的sql，比如findByStatusAndSupplierIdOrderByName（）
1.5.1静态常量
全大写用下划线分割，如
publicstaticStringORDER_PAID_EVENT=“ORDER_PAID_EVENT”;
1.5.2其他
首字母小写，骆驼法则，如：
publicStringorderName;
1.6局部变量名
参数和局部变量名首字母小写，骆驼法则。
尽量不要和域冲突，尽量表达这个变量在方法中的意义。
2.注释规范
2.1注释vs代码
∙注释宜少而精，不宜多而滥，更不能误导
∙命名达意，结构清晰，类和方法等责任明确
∙不能正确表达代码意义的注释，只会损害代码的可读性。
∙过于详细的注释，对显而易见的代码添加的注释，罗嗦的注释，还不如不写。
∙注释不是用来管理代码版本的，如果有代码不要了，直接删除，svn会有记录的，不要注释掉，否则以后没人知道那段注释掉的代码该不该删除。
2.2JavaDoc
表明类、域和方法等的意义和用法等的注释，要以javadoc的方式来写。
JavaDoc是给类的使用者来看的，主要介绍是什么，怎么用等信息。
凡是类的使用者需要知道，都要用JavaDoc来写。
非JavaDoc的注释，往往是给代码的维护者看的，着重告述读者为什么这样写，如何修改，注意什么问题等。
如下：
/**
*Thisisaclasscomment
*/
publicclassTestClass{
/**
*Thisisafieldcomment
*/
publicStringname;
*Thisisamethodcomment
publicvoidcall（）{
}
}
2.3块级别注释
2.3.1块级别注释，单行时用//,多行时用/*..*/。
2.3.2较短的代码块用空行表示注释作用域
2.3.3较长的代码块要用
/*------start:
------*/
和
/*--------end:
-------*/
包围
如：
/*----------start:
订单处理-------*/
//取得dao
OrderDaodao=Factory.getDao（"
OrderDao"
）;
/*查询订单*/
Orderorder=dao.findById（456）;
//更新订单
order.setUserName（"
uu"
order.setPassword（"
pass"
order.setPrice（"
ddd"
orderDao.save（order）;
/*----------end:
2.3.4可以考虑使用大括号来表示注释范围
使用大括号表示注释作用范围的例子：
/*----------订单处理-------*/
{
//取得dao
OrderDaodao=Factory.getDao（"
/*查询订单*/
Orderorder=dao.findById（456）;
//更新订单
order.setUserName（"
order.setPassword（"
order.setPrice（"
orderDao.save（order）;
2.4行内注释
行内注释用//写在行尾
3最佳实践和禁忌
3.1每次保存的时候，都让你的代码是最美的
程序员都是懒惰的，不要想着等我完成了功能，再来优化代码的格式和结构，等真的把功能完成，很少有人会再愿意回头调整代码。
3.2使用log而不是System.out.println（）
log可以设定级别，可以控制输出到哪里，容易区分是在代码的什么地方打印的，而System.out.print则不行。
而且，System.out.print的速度很慢。
所以，除非是有意的，否则，都要用log。
至少在提交到svn之前把System.out.print换成log。
3.3每个ifwhilefor等语句，都不要省略大括号{}
看下面的代码：
if（a>
b）
a++;
如果在以后维护的时候，需要在a>
b时，把b++，一步小心就会写成：
b++;
这样就错了，因为无论a和b是什么关系，b++都会执行。
如果一开始就这样写：
b）{
相信没有哪个笨蛋会把b++添加错的。
而且，这个大括号使作用范围更明显，尤其是后面那行很长要折行时。
3.4善用TODO:
在代码中加入//TODO:
，大部分的ide都会帮你提示，让你知道你还有什么事没有做。
if（order.isPaid（））{
//TODO:
更新订单
3.5在需要留空的地方放一个空语句或注释，告述读者，你是故意的
if（!
exists（order））{
;
或：
//nothingtodo
3.6不要再对boolean值做truefalse判断
if（order.isPaid（）==true）{
//Dosomethinghere
不如写成：
//Dosomethinghere
后者读起来就很是iforderispaid,….要比iforder’sisPaidmethodreturnstrue,…更容易理解
3.7减少代码嵌套层次
代码嵌套层次达3层以上时，一般人理解起来都会困难。
下面的代码是一个简单的例子：
publicvoiddemo（inta,intb,intc）{
if（a>
if（b>
c）{
doJobA（）;
}elseif（b<
doJobB（）
}else{
if（a<
doJobC（）;
}
减少嵌套的方法有很多：
∙合并条件
∙利用return以省略后面的else
∙利用子方法
比如上例，合并条件后成为：
b&
&
b>
c>
doJobB（）;
=b&
c<
a<
如果利用return则成为：
return;
利用子方法，就是将嵌套的程序提取出来放到另外的方法里。
3.8程序职责单一
关注点分离是软件开发的真理。
人类之所以能够完成复杂的工作，就是因为人类能够将工作分解到较小级别的任务上，在做每个任务时关注更少的东西。
让程序单元的职责单一，可以使你在编写这段程序时关注更少的东西，从而降低难度，减少出错。
3.9变量的声明，初始化和被使用尽量放到一起
比方说如下代码：
intorderNum=getOrderNum（）;
//dosomethingwithouorderNumhere
call（orderNum）;
上例中的注释处代表了一段和orderNum不相关的代码。
orderNum的声明和初始化离被使用的地方相隔了很多行的代码，这样做不好，不如这样：
3.10缩小变量的作用域
能用局部变量的，不要使用实例变量，能用实例变量的，不要使用类变量。
变量的生存期越短，意味着它被误用的机会越小，同一时刻程序员要关注的变量的状态越少。
实例变量和类变量默认都不是线程安全的，局部变量是线程安全的。
比如如下代码：
publicclassOrderPayAction{
privateOrderorder;
publicvoiddoAction（）{
order=orderDao.findOrder（）;
doJob1（）;
doJob2（）;
privatevoiddoJob1（）{
doSomething（order）;
privatevoiddoJob2（）{
doOtherThing（order）;
上例中order只不过担当了在方法间传递参数之用，用下面的方法更好：
doJob1（order）;
doJob2（order）;
privatevoiddoJob1（Orderorder）{
privatevoiddoJob2（Orderorder）{
3.11尽量不要用参数来带回方法运算结果
publicvoidcalculate（Orderorder）{
intresult=0;
//dolotsofcomputingandstoreitintheresult
order.setResult（result）;
publicvoidaction（）{
calculate（order）;
//dolotsofthingsaboutorder
例子中calculate方法通过传入的order对象来存储结果，不如如下写：
publicintcalculate（Orderorder）{
returnresult;
order.setResult（calculate（order））;
升级会员 