Page History

...

Code Block

title	不推荐

if (booleanExpression) {
     return true; 
} else { 
    return false;
}

Code Block

title	正确

return booleanExpression;

Note
严格控制方法/变量的权限，只在当前类使用的方法/变量，必须使用private修饰符。

遵循零public方法原则，也就是尽量少的public方法。如果一个公共方法只有其子类调用，那么必须去掉这个公共方法。如果一个公共方法只有一个地方调用，考虑这个调用可否被其他方式替代。

...

Code Block

title	不推荐

Border border = Utils.createBorder(font, null);

Code Block

title	正确

//先在Utils里面加这么个方法： 
public static Border createBorder(Font font) { 
    return createBorder(font, null);
} 
//再调用
Border border = Utils.createBorder(font);

Note
在重写方法时，禁止出现下面的写法，即只简单的调用了一下super而没有额外的实现, 这里有一个例外，就是实现了FClone接口的类必须要实现clone方法，和该规则冲突，不用管。

Code Block

title	不推荐

@override
public void doSomething() {
    super.doSomething(); 
}

Note
代码中出现的中文（英文）等字符，必须做国际化。

Code Block

title	错误

String shapeName = "圆形";

Code Block

title	正确

String shapeName = Inter.getLocText("FR-Designer_Chart_Circle");

Note
包名要具有描述意义，而且包中的类需要严格按照包描述的意义进行放置，另外，包名都必须是由小写字母组成。

比如com.fr.chart.axis包中的所有类都必须是和坐标轴相关的类。

Note
数组的声明总是采用统一的方式。

Code Block

title	不推荐

String strArray[];

Code Block

title	正确

String[] strArray;

Note
如果一个方法的返回值是数组，那么就必须返回一个数组，如果是空值就使用空数组的代替。

Code Block

title	示例

public String[] getNames4JionTheParty() {
     if (a) {   
         return new String[] {"张三", "李四", "王麻子"};
     } else (b) {
         return new String[0]; 
     } 
}

Note
在需要条件判断的地方，比如if语句里不要写过长的表达式（不超过两个逻辑表达式），此时应该用一个方法来替代表达式。

Code Block

title	不推荐

if (a > -1 && a != 1 && dim.width > 0 && dim.height > 0) { 
    doSomething(); 
}

Code Block

title	正确

if (shouldDoSomething(a, dim)) { 
    doSomething(); 
} 
boolean shuoldDoSomething(int a, Dimension dim) {
    return a > -1 && a != 1 && dim > width && dim.height > 0;
}

Note

...

使用HashMap和HashSet以及HashTable等时要注意，如果使用的自定义的对象作为key，需要同时重写该对象的equals和hashCode方法。

...

Note
变量的声明应当尽可能靠近其使用的位置。局部变量应该在方法顶部出现，而循环中的控值变量应该总是在循环语句中声明。

Note
当switch的一个case语句没有break时，需要在case结尾处写上注释，防止是漏掉了break语句而不是原本就是想贯穿的。

Code Block

title	示例代码

public String diffResult(int type) {
    String someDescription = "abc";
    switch (type) {
        // 这里需要贯穿
        case 1:
          someDescription = "def";
        case 2:
          someDescription = "xyz";
          break;
        default:
            someDescription = "mnx";
            break;
    }
    return someDescription;
}

Note
异常信息的日志写法要符合规范。

Code Block

title

...

错误的写法
try {
     doSomething();
} catch (Exception e) {
     e.printStackTrace();
}
 Code Block

...

title	正确的写法

try { 
    doSomething();
} catch (Exception e) {   
    FRContext.getLogger.error(e.getMessage, e);// 这里调用的方法视情况而定
}

Note
如果需要忽略掉异常信息，请显示的将异常对象命名为 ignore。

Code Block

title	忽略异常

try { 
    doSomething();
} catch (Exception ignore) {   
    
}

Note
在Java代码中需要输出JSON格式时，JSON字符串需要按照标准写。

...

Code Block

title	错误

{a:"bb"};  
{'a':"bb"};

Code Block

title

...

正确

{"aa":"bb"};

Note
在写需要输出到客户端的JSON对象时，如果需要输出数组对象，不要使用普通的Java数组对象，要使用JSONArray对象。

Code Block

title

...

JSONObject

JSONObject jo =

...

 JSONObject.create();
String[] names = new String[]{"aaa", "bbb", "ccc"}; 
jo.put("names", names);

Code Block

title

...

JSON数组

JSONObject jo =

...

JSONObject.create();
JSONArray ja = new JSONArray(); ja.put("aaa").put("bbb").put("ccc"); jo.put(

...

"names", ja);

Page tree

Versions Compared

Old Version 4

New Version 5

Key