现在的位置: 首页 > 综合 > 正文

コーディング規約(Java標準規約に対する制約)について示す

2013年09月18日 ⁄ 综合 ⁄ 共 2871字 ⁄ 字号 评论关闭
培训内容:
1、                通用命名相关:
①、单词的首字母大写,别的小写。例如:
 例)
How are you        → HowAreYou
Telephone number   → TelephoneNumber
②、如果单词数太长的话,可以缩写。缩写参照以下规则:
a、取单词母音缩写:
   例:OderItem   à OdrItm
b、取前3个字母缩写:
   例:Request    à Req
③、组合的情况下,只取首字母。(不常用)
④、如果变量有专业术语,则需要使用专业术语。
⑤、几个单词的缩写(如:XML和SQL),有以下情况:
如果是定义常量的话,参照以下格式:
static final String XML_DOCUMENT = “text/XML”;
如果是方法名,变量的头文字,类名,则参照以下格式:
private Document xmlDocument; //
private Document myXmlDocument;
public class XmlDocument;
⑥、不能使用大小写相异的变量名来却别变量。
例)
theSQLInputStream和theSqlIputStream,不允许
2、                JAVA相关命名:
①、包的命名方式:
公司域名的倒写,例如:jp.co.nttdata.roukin.ib.business.enduser
②、类的命名方式:
      如果类表示是一个集合体的话,则类名需要用复数形式。
  例如:
public class Types {
  public final static int BIT = -7;
  public final static int TINYINT = -6;
  public final static int SMALLINT = 5;
  public final static int INTEGER = 4;
  public final static int BIGINT = -5;
  public final static int FLOAT = 6;
  public final static int REAL = 7;
  public final static int DOUBLE = 8;
  public final static int NUMERIC = 2;
  public final static int DECIMAL = 3;
  public final static int CHAR = 1;
}
如果是本工程的业务类,则起名按一下规则:
 X xx X xx  Bean     
(固定)
取引ID(英字3
業務ID(英字3
  
  业务ID、取引ID的首字母大写。
①、方法命名方式:
使用动词。第一个动词首字母小写,别的单词首字母大写。参照以下情况使用前缀。
メソッドのprefix一覧
照会(値取得)
get
登録
set
更新
update
削除
delete
チェック(*)
is
計算
calculate
生成
create
②、常量命名方式:
    把常量定义在常量类里,用static和final来修饰。常量名全部大写,中间用“_”连接。常量名不能缩写。
    例:public static final String MINIMUM_BALANCE = “www”;
③、集合命名
    如果集合是一系列对象的集合,则集合名需要是复数形式。
④、资源文件命名
    资源文件命名不能缩写。
2、                コーディング規約
①、格式
参照Java命名・コーディング規約v1.0.doc
②、注释
方法名参照以下注释
 
/**
 * ○○○○を取得する。
 *
 * @param bizForm ×××画面入力情報
 * @param requestAttr ロジックのOUTパラメータ
 * @param sessionAttr ロジックのIN-OUTパラメータ
 * @param ibUser 契約者情報(不変条件:xxxx)
 * @return boolean 処理が成功したときはtrueを返し、失敗したときはfalseを返す。
 */
 
 


字段名参照一下注释
         在字段末尾注释。
 
public Integer brcCode; // 店舗コード
 
 
方法内部的注释
         メソッド本体の内部にコメントを付加する場合は、ソースコードの動作理解に役立つ情報(処理内容や分岐条件等)を記述する。
         コメントが必要なソースコード行の上に原則1行コメントのスタイルで記述する。
         コメント付与のサンプルは以下のとおり。
 
 
/**
 * ○○○○○○○○により、×××を取得する。、
 */
 
// ○○を選択した場合
 
// xxxを選択した場合
 
 
 
 
控制块的注释参照以下sample:
 
 for (i …) {
    for (j …) {
      while(…) {
        if (…) {
          switch (…) {
          } // end switch
        } // end if
      } // end while
    } // end for j
 } // end for i
 
 


         JSP的头参照以下格式
 

ファイルの先頭に記述し、2行目に当該JSPのファイル名を記述する

 


<%--
  Copyright c NTT DATA CORPORATION 2006 All Rights Reserved.
  Hogehoge.jsp
--%>
 
・・・
 

Javaソースのクラス・インタフェースコメントとほぼ同様で、「クラス名」のかわりに「画面名称」を日本語で記述する。

<%--

   [画面名称] <br>
    XXXXXXX画面<br><br>
   [機能概要] <br>
    取引件数情報の集計を行う。<br><br>
   [変更履歴] <br>
    2006/4/10 ver1.00 新規作成 Chen MingJian <br>
    2006/5/10 ver1.00 仕変N-0024対応 Chen MingJian <br>
 
  @author NTT DATA CORPORATION
  @version 1.00
--%>
 
・・・
 
 
3、                一些注意点
①、字符串比较不能使用“==”,只能使用equals,且需要将固定的字符串写在前面。
例:String name = bizForm.get(“name”);
    boolean flag = “wanghai”.equals(name);
②、不推荐使用内部类和匿名类。
③、在导入包的时候,要指定到某个具体的类。
例:import java.util.ArrayList; 不推荐使用 import java.util.*;
④、数组在使用的时候,要注意别让数组下标越界。
⑤、如果是集合型的对象,在再次使用的时候,需要先清空集合。不建议反复使用同一集合。
⑥、如果有if语句,就算if语句中只有一行代码,if也得加上{}。
⑦、swith语句中,每一个case后都需要加上break,且最后得加default。
⑧、在try…catch中不能使用return,break,continue等。

 

抱歉!评论已关闭.