敏捷开发中如何将注释转换为代码
http://tech.ddvip.com 2008年01月22日 社区交流
内容摘要:本文讲述了敏捷开发中将注释转换为代码的必要性,需要注意的问题和具体的实例源代码,供大家参考!
示例
这是一个会议管理系统。在会议中,每个参会者都会戴一个牌子,牌子上面有该参会者的信息(比如姓名等)。在该系统中,Badge类用来存放参会者的信息。请看下面的代码跟注释:
//存放参会者所戴的牌子显示的信息
public class Badge {
String pid; //参会者ID
String engName; //英文全名
String chiName; //中文全名
String engOrgName; //所在部门英文名称
String chiOrgName; //所在部门中文名称
String engCountry; //部门所在国家的中文名称
String chiCountry; //部门所在国家的英文名称
//***********************
//构造函数
//根据参会者ID,从数据库取出该参会者信息
//***********************
Badge(String pid) {
this.pid = pid;
//***********************
//取出参会者
//***********************
ParticipantsInDB partsInDB = ParticipantsInDB.getInstance();
Participant part = partsInDB.locateParticipant(pid);
if (part != null) {
//取出参会者的英文全名
engName = part.getELastName() + ", " + part.getEFirstName();
//取出参会者的中文全名
chiName = part.getCLastName()+part.getCFirstName();
//***********************
//取出所在部门跟国家
//***********************
OrganizationsInDB orgsInDB = OrganizationsInDB.getInstance();
//取出所在部门的ID
String oid = orgsInDB.getOrganization(pid);
if (oid != null) {
Organization org = orgsInDB.locateOrganization(oid);
engOrgName = org.getEName();
chiOrgName = org.getCName();
engCountry = org.getEAddress().getCountry();
chiCountry = org.getCAddress().getCountry();
}
}
}
...
}
将注释转换为代码,让代码足够清楚到可以表示注释?
作者:王伟杰 责编:豆豆技术应用