Javaプログラミング仕様の心得
6280 ワード
Java ,“ , ”—— ( )。 ruby webx , , , 。1.
a) ( , , List Map , )
b) , , ,
:
/**
* ID , , :
* [ .ID, . ], [ X.ID, X. ], …[ .ID, . ]。
*
* @param catPath
*
* @return String[][]
*
*/
String[][] getCategoryStringByPath(String catPath);
: はずっと で、 ロジックの が なので、 の にこの でテストした と の ロジックの を えて します.このように、 ロジックの やこの が された 、 このテストコードを したり したりすることができます. なコードや いコードをプログラムに しておくのではなく、コードをますます くし、ますます みにくくします.
2.メソッドのコメントでは、パラメータの と り の を に く/**
* null
”"
。
*
* StringUtil.isEmpty(null) = true
* StringUtil.isEmpty(“”) = true
* StringUtil.isEmpty(” “) = false
* StringUtil.isEmpty(“bob”) = false
* StringUtil.isEmpty(“ bob “) = false
*
*
*@param strチェックする
*
*@returnが の はtrue
を します.
*/
public static boolean isEmpty(String str) {
return ((str == null) || (str.length() == 0));
}
:このコードは1 しかないのに、8 の をつけて、 しただけでなく、このコードは をしているのか、5つの を げてプログラム の な を しました.このように の はこのコードを むと、この の が なのかをよく っていて、コードを む を らします. たち のテストスクリプト( な)も の を にして、 の いたスクリプトに しい を えて、スクリプトのメンテナンスと の を にすることができます.
3. なコードを け、 なimportがなく、 なメンバー がなく、 なprivateメソッドがありません.
:コードやスクリプトの さを らし、コードの を めることができます.
4.メソッドのパラメータは5 を えないでください.パラメータが すぎる は、オブジェクトパッケージ( えばQuery)を します.
:
/**
* user can update the specified item, so prepare an DO and update database with that DO.
*
* @param vo – user submitted data
* @param sellerID – seller ID
* @param itemID – item ID
*
* @return -
*
* @link Result
*/
private Result updateItem(BidItemVO vo, String sellerID, String itemID, List lvo, String hasUpload, long limitCode) {}
: のこの は で6つのパラメータがあって、 6のパラメータは が えたので、パラメータが すぎて のパラメータが をしているのか らないので、この を び す があります.
:
/**
* ruyue 2007-06-11
*
* @param String
* itemId, String dbRoute
* @return title id pictUrl ownerId price auctionType end props category
*/
public Result getAuctionDetail4Mercury(ItemDetailQuery query) {}
5.「import java.io.*;を します.
:このようなimport では、 くの に たないクラスをプログラムに します. のEclipseは、ロードするクラスを に し、すべてのクラスをロードすることはありませんが、コードやスクリプトを くときは けなければならない い です.
6. すぎる 、 えばand、orが ある 、かっこをつけて し、 する.
:andとorの を らないにかかわらず、 が すぎる は、できるだけ をつけるべきで、このように エラーを らすことができて、コードの を して、 でコードのメンテナンスを にすることができます.
7. を に し、ハードコーディング( き みが んだ) 、 をできるだけ ける.
: や を に かないで、できるだけ を って、この に をつけて、 い コード(このif が をしているのか も らないので)がプログラムに っていることを けなければなりません.
8. のクラスにメソッドを します.このクラスが で されていない は、 、 、コメントを することをお めします. のメソッドに やその のビジネスロジックを するには、 ずコメントしてください./**
* ruyue 2007-06-11
*
* @param String
* itemId, String dbRoute
* @return title id pictUrl ownerId price auctionType end props category
*/
public Result getAuctionDetail4Mercury(ItemDetailQuery query) {}
if (ucBaseDO == null || ucBaseDO.isGradeNormal()) { // ,
// VIP
if (user.isRegieUser()) {
// VIP wanjian 2007.03.26
UserCardBaseDO mallVipCardDO = this.userCardManager
.findMallVIPCard(query.getLoginUserId(),
user.getUserId(), query
.getTrackNick());
if (mallVipCardDO != null) {
if (ucBaseDO == null) {
ucBaseDO = mallVipCardDO;
} else if (mallVipCardDO.getCurGradeIndex() > ucBaseDO
.getCurGradeIndex()) {
ucBaseDO = mallVipCardDO;
}
}
}
}
: が したクラスやメソッドに のコードを れるときは、クラスのヘッダや した に の 、 、コメントを れます.これにより、コードのメンテナンスを にし、コードの み り を め、できるだけ くエラーをチェックすることができます.
9. の は ちに しなければならない.
: が する :ユーザー を えずmapにputするが、このmapからユーザー を したことがないため、メモリが なくなり、 できない をもたらす.
10.「||」&&&」 では, が さく,しばしば する に に する.
: の さいものを に し、この の 、 の をしなくても を ることができ、コストを することができるかもしれません.
11.テストクラスで されるパラメータは、 メソッド に することが ましい.
: を でテストするのに です.
12. は、 にeditページにアクセスし、コミット の に してeditページに り、エラーが したページで データが われないようにすることに してください.
: は1つのケースを かち いました: めてeditページに って した 、 に してeditページに り、ページ の でない が われました.このケースは、 からテスト・インスタンスでこの が きされていましたが、ビジネス・プロセスで に したり、 に したりした 、 、 、リクエストに したりするには、データの やその のエラーがあるかどうかを することに するように しています.
13.パラメータ を に う
a)Publicタイプの は、 をする に、 したパラメータがあなたの に することを しなければならない.public boolean isMatchMD5(String source, String encodedStr) {
if (StringUtil.isBlank(source) || StringUtil.isBlank(encodedStr)) {
return false;
}
if (!CodesUtil.encodeMD5(source).equals(encodedStr)) {
return false;
}
return true;
}
:「 からも されるパラメータを しない」-- さん、Publicメソッドは の に び される が い.パラメータが されるときに される が いパラメータはあなたの に わないので、メソッドにパラメータチェックを れなければなりません.テスト にとっては「 からも されたパラメータに が まれているとは じないでください」と います.
b)パラメータ の は で、 の が さいことを する.
は が《Javaプログラミング 》の の に しても たちのテストの しの を って、みんなの の とコードに つことを んでいます.
は ず Taobao QA Team、 を しなければならない.http://qa.taobao.com/?p=8400