本文仅是我个人在实际开发中习惯的编写方式,当然这种方式也是来自很多官方的推荐,所以在一定程度上是可以被模仿套用的。本文将不定期更新~
零、指导原则
优先保证可读性,不要过分追求代码艺术和效率
在可读性和代码效率方面,请选择可读性。为了可读性我宁可多建立一个对象,或者是多写一个方法。当然,如果这段代码是执行频次很高的代码,那么请在编码后再进行优化。
追求模块化和开闭原则
一个类里可以写多个方法,但不要为了调用方便而肆意定义全局变量。宁可多些几个方法的参数也不要随便定义全局变量。定义全局变量首先会让可读性变差,阅读会到处跳转到找到这个变量的定义,而且不能很好的进行方法的开闭。其次,全局变量比局部变量更占内存,更不易被回收。
一、编码规范
使用特殊转义序列而不是它的八进制
我们应该用特殊的转移序列,比如:(\b, \t, \n, \f, \r, \”, \’及\),而不是它们对应的八进制,比如:\012
大胆使用非ASCII字符
如果我们在实际中需要用到非ASCII字符,我们当然可以去查表得到他们的转义码,但是没有必要。你可以大胆的在代码中这么写,或者加上注释。应为这样很便于阅读。
String unitAbbrev = "μs";
import不要使用通配符
不要出现类似这样的import语句:import java.util.*;
不要忽略大括号
大括号与if, else, for, do, while
语句一起使用,即使只有一条语句(或是空),也应该把大括号写上。
什么时候换行
对于非空块和块状结构,大括号遵循Kernighan和Ritchie风格
(Egyptian brackets):
- 左大括号前不换行
- 左大括号后换行
- 右大括号前换行
- 如果右大括号是一个语句、函数体或类的终止,则右大括号后换行; 否则不换行。例如,如果右大括号后面是else或逗号,则不换行。
boolean isShow = true;
if (isShow) { } else { }
截断代码换行
如果一行代码太长了,那么可能会需要换行。这时候换行的原则是:在“非赋值运算符”处断开。下面是几个例子:
“+”在下一行
String url = "http://blog.isming.me/2014/10/27/"
+ "google-java-style/";
“&”在下一行
if (changed == true
& show == true) { }
“."在下一行
Logger
.init(YOUR_TAG) // default PRETTYLOGGER or use just init()
.setMethodCount(3) // default 2
.hideThreadInfo() // default shown
.setLogLevel(LogLevel.NONE); // default LogLevel.FULL
变量声明
每次只声明一个变量,不要:int a,b;
推荐下面的方式:
int a;
int b;
数组中的中括号
中括号应该是类型的一部分,不要按照C++的方式来写,而且中括号和左边不要有空格。应该像下面这样:
int[] d
Switch-case中的default
每个switch语句都包含一个default
语句组,即使它什么代码也不包含。
Switch-case中的break
如果你的上一个判断和下个判断需要执行的代码是一致的,那么你可以不用break,但必须在原来break的地方加上注释。
switch (input) {
case 1:
case 2:
prepareOneOrTwo();
// break;
// fall through
case 3:
handleOneTwoOrThree();
break;
default:
handleLargeNumber(input);
}
限定符的顺序
我们的变量或方法可能有多个限定符,比如public,static什么的,那么请按照如下的顺序进行编写。
public protected private abstract static final transient volatile synchronized native strictfp
eg:
public static final String TAG;
包名的取法
包名全部小写,连续的单词只是简单地连接起来,不能使用下划线。
类名
类名通常是名词或名词短语,接口名称有时可能是形容词或形容词短语。
抽象类
以Abstract开头
例:AbstractDataManager
接口
以I开头,比如:IPointView
方法名
方法名通常是动词或动词短语。
异常
一般情况下捕获的异常都是需要打印出log的,但有些异常是我们在已知的,或者在这里出现异常是必然的化,我们可以不加捕获,但需要添加注释。
如果一个捕获的异常被命名为expected
,则它可以被不加注释地忽略。下面是一种非常常见的情形,用以确保所测试的方法会抛出一个期望中的异常,
因此在这里就没有必要加注释。
try {
emptyStack.pop();
fail();
} catch (NoSuchElementException expected) {
}
Javadoc标记
标准的Javadoc标记按以下顺序出现:@param
, @return
, @throws
, @deprecated
, 前面这4种标记如果出现,描述都不能为空。
当描述无法在一行中容纳,连续行需要至少再缩进4个空格。
/**
* Adds a {@link Fragment} to this activity's layout.
*
* @param containerViewId The container view to where add the
* fragment.(换行得有缩进)
*
* @param fragment The fragment to be added.
*/
除了第一个段落,每个段落第一个单词前都有标签<p>
,并且它和第一个单词间没有空格。
Intent中的key
从A跳转到B时,需要将intent中的key定义在B这个activity的内部,而不是全局的一个key文件中。这样确保传过去的key不会出现问题,适用于多入口的情况。
public class BActivity extends Activity{ public static final String KEY_USERNAME = "USER_NAME"; @Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
String username = getIntent().getStringExtra(KEY_USERNAME);
}
}
方法体尽可能独立
写方法的时候不要为了引用简单而去定义一堆类变量,尽可能的和方法外部独立,多写几个形参都是可以的。这样即使删掉一些类变量,也不会影响到具体方法的实现。
错误的写法:
String username = "jack"; /**
* 应用了类变量(不好)
*/
private void updateUsername() {
username = "tony";
}
正确的写法:
/**
* 独立性强,外界对内部完全没有任何影响
*/
private String updateUsername(String username) {
username = "tony";
return username;
}
id命名
linearLayout = ll
RelativeLayout = rl
GridLayout = gl
TextView = tv
ImageView = iv
ImageButton = ib
Button = btn
ScrollView = sv
EditText = et
CheckBox = cb
ProgressBar = pb
Activity命名
XxxActivity - xxx_activity
XxxFragment - xxx_header_fragment
XxxItem - xxx_item
数字、字母全部全角化
用animation-list做动画
用StringBuffer来做拼接字符串
我们尽量不用string来进行字符串拼接,都用stringBuffer来代替。如果你需要通过一个方法来返回一个String对象,并且你知道得到的字符串最终是要进行拼接的,那么请将返回的对象从String改为StringBuffer。比如:
private StringBuffer getString() {
return new StringBuffer("This is a string");
}
不多建立对象,经可能复用现有的对象
当从输入的数据集中抽取出Strings的时候,尝试返回原数据的substring对象,而不是创建一个重复的对象。
尽可能使用简单对象
一组int数据要比一组Integer对象要好很多。可以得知,两组1维数组要比一个2维数组更加的有效率。同样的,这个道理可以推广至其他原始数据类型。
如果你需要实现一个数组用来存放(Foo,Bar)的对象,尝试分解为Foo[]与Bar[]要比(Foo,Bar)好很多。(当然,为了某些好的API的设计,可以适当做一些妥协。但是在自己的代码内部,你应该多多使用分解后的容易。
恰当的使用static
我个人不是很喜欢用static关键字,因为当你的方法或者是变量被static标识了后,只要别的地方碰到了你的这个类,所有static的方法/变量都会被产生。因此在类的内部尽量不要用static。如果你这个方法是工具方法,或者某个常量是要被其他类引用的,那么请将其设置为static,这样方法调用将快15%-20%。这是一个好的习惯,因为你可以从方法声明中得知调用无法改变这个对象的状态。
常量声明为staic final
先看下面这种声明的方式:
static int intVal = 42;
static String strVal = "Hello, world!";
编译器会在类首次被使用到的时候,使用初始化方法来初始化上面的值,之后访问的时候会需要先到它那里查找,然后才返回数据。我们可以使用static final来提升性能:
static final int intVal = 42;
static final String strVal = "Hello, world!";
这时再也不需要上面的那个方法来做多余的查找动作了。 所以,请尽可能的为常量声明为static final类型的。
尽量使用增强型for循环
增强型for循环会让遍历更高效,但是需要注意:
对于ArrayList这种集合,自己手写的循环要比增强型for循环更快,而其他的集合就没有这种情况。因此,对于我们来说,默认情况下可以都使用增强型for循环,而遍历ArrayList时就还是使用传统的循环方式吧。在JAVA8中统一使用foreach做循环。
for (int i = 0; i < mArray.length; ++i) {
sum += mArray[i].mSplat;
}
尽量不要用内部类访问外部类的私有成员
虽然内部类是可以访问外部类的私有成员的(如一个变量),但这样效率会很低。你可以把内部类需要访问的域和方法声明为包级访问,而不是私有访问权限。不幸的是,这意味着在相同包中的其他类也可以直接访问这些域,所以在公开的API中你不能这样做。
public class Foo {
private class Inner {
void stuff() {
Foo.this.doStuff(Foo.this.mValue);
}
}
private int mValue;
private void doStuff(int value) {
System.out.println("Value is " + value);
}
}
能不用float就不用
Android系统中float类型的数据存取速度是int类型的一半,尽量优先采用int类型。
在列表滑动时不加载图片
当SCROLL_STATE_FLING时停止异步加载
采用view组件复用,而不是布局页面复用
很多页面只有一两个元素不同,但我们不应该去做页面的复用,利用逻辑来控制某些控件的可见性是不可取的。应该找到共同的组件,利用fragment和其他方案来进行组件的组合。而不是强制复用layout文件,强制复用会带来后期维护的困难。