Java编程风格及基础类库使用培训

, , , , , ,*,Java,编程风格及基础类库使用培训,清华大学计算中心,培训安排,一、,Java,的编程规范,1. Java,语言的编写规范,2. JSP,的编程规范,3. Java,的设计模式,二、基础类库的使用,1.,信息发布基础类,2.,权限管理基础类,3.,数据库访问基础类,4.,数据库数据导入导出基础类库,1,）,Dbf,文件的导入导出,2,）,Excel,文件的导入导出,3,）,PDF,文件的导出,Java,的编程规范,Java,语言的编程规范,命名的规范,Java,的样式文件,代码的编写风格,程序的编写规范,JSP,的编程规范,Java Web,程序的结构,Jsp/Servlet,的编程规范,Java,的设计模式,基础的设计模式,J2EE,的设计模式,Java,程序的开发框架（,FrameWork,）,Java,语言的编写规范,命名的规范,Package,的命名,应该都是由一个小写单词组成。,Class,的命名,必须由大写字母开头而其他字母都小写的单词组成,Class,变量的命名,变量的名字必须用一个小写字母开头。后面的单词用大写字母开头,Static Final,变量的命名,Static Final,变量的名字应该都大写，并且指出完整,含义,参数的命名,参数的名字必须和变量的命名规范一致,数组的命名,数组应该总是用下面的方式来命名：,byte buffer,方法的参数,使用有意义的参数命名,如果可能的话，使用和要赋值的字段一样的名字,Java,语言的编写规范,Java,文件样式,版权信息,Package/Imports,Class,Class Fields,构造函数,存取方法,克隆方法,类方法,toString,方法,main,方法,Java,语言的编写规范,代码编写格式,代码样式,代码应该注意回车换行的格式,在一个项目中不要混用,unix,和,windows,两种不同的回车换行格式,文档化,是用,Javadoc,来为类生成文档,它是标准，也被各种,java,编译器都认可的方法,缩进,缩进应该是每行,2,个空格,不要在源文件中保存,Tab,字符,.,Tab,字符会因为用户设置的不同而扩展为不同的宽度,.,页宽,页宽应该设置为,80,字符,超长的语句应该在一个逗号或者一个操作符后折行,一条语句折行后,应该比原来的语句再缩进,2,个字符,Java,语言的编写规范,对,中的语句应该单独作为一行,括号,左括号和后一个字符之间不应该出现空格,右括号和前一个字符之间也不应该出现空格,不要在语句中使用无意义的括号,Java,语言的编写规范,程序编写规范,exit,exit,除了在,main,中可以被调用外，其他的地方不应该调用,后台服务地程序不应该因为某个库模块决定要退出就退出,异常,申明的错误应该抛出一个,RuntimeException,或者派生的异常,垃圾收集,需要调用,close,的对象一定要及时调用,close,打开的流对象,数据库连接,Clone,final,类,绝对不要因为性能的原因将类定义为,final,一个类还没有准备好被继承，最好在类文档中注明,访问类的成员变量,大部分的类成员变量应该定义为,private,的来防止继承类使用他们,JSP,的编写规范,Java Web,程序的架构,表示层,负责,HTML,页面的生成,使用,Jsp,或,Servlet,逻辑层,负责业务逻辑的处理,使用,Java Bean,或普通,Java,类,持久层,负责数据库数据的获取,使用,DAO (Data Access Object),获取数据库数据,使用,VO,（,Value Object,）传输数据,JSP,的编写规范,JSP,的编写规范,JSP/Servlet,的编程规范,适用场合,JSP,用于显示页面,Servlet,可以完成更强大的功,Filter,对所有页面统一做处理,startup servlet,启动的时候初始化,errorPage,每一个,JSP,都应该包含,ErrorPage,页面,contentType,每一个页面都应该指定,contentType,如果要指定中文编码，适用,GBK,而不是,GBK2312,多使用已有的,tag lib,Tag,是,JSP,的一个重要扩展,基础类,库中定义的,应用的,tag,，要求尽量使用,提取公用部分,对于,JSP,中大量使用的公有部分，必须写成单独的,JSP,供其他页面,include,JSP,的编写规范,不直接被,WEB,访问的文件放到,WEB-INF,目录下,WEB-INF,目录是,j2ee,规范中不被,WEB,访问的目录,不能被用户直接访问的文件可以放到这个目录下,可以将,JSP,文件放到这个目录下，然后使用,Forward,的方式访问,大,括号,由于,JSP,比较容易混乱，在控制语句的代码块中，后面的,语句后面尽量加上注释以便于阅读,特别是中间混杂了,HTML,代码的更是需要加上注释。,的缩进量应保持一致,JSP,的编写规范,Java,程序的设计模式,面向对象开发中程序员更重视代码的重用性和可维护性,一个好的，对某个问题空间的通用的解决方案可以称之为设计模式,设计模式通常描述了一组相互紧密作用的类与对象,设计模式提供一种讨论软件设计的公共语言，使得熟练设计者的设计经验可以被初学者和其他设计者掌握,设计模式为软件重构提供了目标,设计模式使人们可以更加简单方便地重复使用成功的设计和体系结构,JSP,的编写规范,基础的设计模式,基础模式,委托模式,接口模式,代理模式,创建型模式,抽象工厂模式,生成器模式,工厂方法模式,原型模式,单例模式,结构型模式,适配器模式,桥接模式,组合模式,容器模式,修饰模式,扩展性模式,外观模式,享元模式,管道与过滤器模式,代理模式,JSP,的编写规范,J2EE,的设计模式,在基础的设计模式之上，针对,Web,方式的程序开发提出的设计模式,表示层设计模式,逻辑层设计模式,持久层设计模式,JSP,的编写规范,Java,程序的开发框架,Framework,即架构,某个问题空间抽象的、可复用的解决方式,软件的架构方式,一组设计模式的集合,形成一个适应项目需要的稳定架构是项目开发过程中一个非常重要的步骤,多利用现有的程序开发架构和工具,Struts,Tiles,Hibernate,.,基础类库的使用,基础类库,信息发布,权限管理,数据库访问,数据库数据的导出导入,其他,正在整理,正在开发中,待研究,信息发布基础类,信息发布基础类功能说明：,信息发布基础类库提供了信息发布中需要用到的数据库数据操作的基本功能,显示,修改,插入,删除,数据合法性检查,出错信息提示,信息发布基础类的使用要求,信息发布,基础类库通过数据库访问基础类访问,Oracle,数据库,信息发布基础类需要业务数据库中建立特定的数据表,信息发布基础类以,Jsp Taglib,的形式提供,信息发布基础类,信息发布基础类的数据库结构,信息发布基础类要求对所操作的数据表和数据字段在信息发布基础类的自建表中进行定义和说明,信息发布基础类库需要在业务库中建立如下表,xxfb_bmb,信息发布数据定义表,存储信息发布中所需访问的业务系统数据表的相关信息,t_sjzdb,信息发布数据字典表,存储信息发布中所需访问到的业务系统的数据字段信息的描述,xxfb_dxxxb,信息发布单项选择表：,用于存储信息发布中用到的单向选择列,Sequence,的命名规范为,“,seq_”+,数据数据表名,权限管理基础类,权限管理基础类功能说明,用户的身份认证,用,户权限的存储结构,用户权限的检查,权限管理的使用要求,信息发布,基础类库通过数据库访问基础类访问,Oracle,数据库,信息发布基础类需要业务数据库中建立特定的数据表,信息发布基础类以,Jsp Taglib,的形式提供,权限管理基础类,权限管理的基本概念,权限,组成的四大基本要素,用户,指应用系统的用户，是系统的直接面对者。,角色,是为了对权限进行组织和管理而建立的“用户组”实体,在某些应用系统中可能是一个职位的体现；,权限,是指为了完成某个系统功能而必须具有的权力,对应于应用系统的最小功能单位；,模块,是系统功能的具体实现，,一般情况下，每个系统功能必须由一个至多个模块来共同完成,这里的模块一般以一个,WEB,页面为单位,权限管理基础类,权限系统四大要素的对应关系,用户到角色的对应,指明了每个用户所拥有的角色,指明了每个角色所对应的所有用户,是多对多的关系,角色到权限的对应,指明了每个角色所拥有的权限,每个权限也可以被多个角色所拥有,是多对多的关系,权限到模块的对应,指明为了完成某个权限赋予的功能所需要的模块,每个模块也可能支持多个权限,是多对多的关系,权限管理基础类,权限管理基础类的数据库结构,用户信息表,：,其重要字段是“用户,ID”,这是,varchar2,类型的数据，最长可达,64,位,详细的用户信息表由应用系统自行决定,基础类提供一个参考表,org_thcic_userinfo,org_thcic_roles,角色说明表,存放角色的信息和说明,角色,ID,类型是,number(9),，数值可以自由分配；,org_thcic_perms,权限说明表,存放权限的信息和说明,权限,ID,类型是,number(9),，数值可以自由分配,；,权限管理基础类,org_thcic_modules,模块说明表,存档模块的信息和说明,模块,ID,类型是,varchar2(256),取值规则是”应用名称,:,模块,URL,全路径,:,子模块号“,其中子模块号可以为空，但最后的”,:“,不能省略,子模块号的作用是，当同一个页面可以完成若干功能时，可能对应于不同的权限，那么就需要子模块号来做更细的区分,org_thcic_user_role,用户、角色对应表,存放用户、角色的对应关系,org_thcic_role_perm,角色、权限对应表,存放角色、权限的对应关系,org_thcic_module_perm,模块、权限对应表,存放模块、权限的对应关系,权限管理基础类,org.thcic.sysconf,系统配置表,与授权系统相关的配置信息有：,EnableAuthority,指明是否启动授权系统,DefaultAuthorityClassName,指明管理授权系统的类名字，默认是,org.thcic.authority.AuthorityDB,数据库访问基础类,功能说明,提供了对,Jdbc,的封装,实现了对数据库数据的访问,数据库访问基础类的使用要求,使用数据库连接池,不自带数据库连接池，需使用第三方提供的数据库连接池,Resin,Weblogic,其他,默认的数据连接池名是,OracleDB,数据库访问基础类,数据库数据导入导出基础类库,数据库数据导入导出基础类库实现了,将,Oracle,数据库中的数据导出到不同格式的数据文件中,将不同格式的数据文件中的数据导入到数据库中,数据库数据导入导出基础类包括,D,bf,数据的导入导出,Excel,数据的导入导出,Oracle,数据库中的数据导出到,PDF,文件中,数据库数据导入导出基础类库,Dbf,数据的导入导出,功能说明,将,Oracle,数据库中的数据导出到,Dbf,文件中,将,Dbf,文件中的数据导入到,Java,的数据对象或,Oracle,数据库中,使用要求,目前只支持,DBASE III,标准的,Dbf,文件，不支持其他标准（例如,DBASE IV,）的,Dbf,文件,基础类只支持对文件系统中的,Dbf,文件进行导入导出的功能。不支持从数据流中导出,Dbf,数据，或将,Dbf,数据导出到数据流中,Dbf,文件导入导出基础类通过数据库访问基础类访问,Oracle,数据库,调用类,org.thcic.datafile.dbf.*,数据库数据导入导出基础类库,Excel,数据的导入导出,功能说明,将,Oracle,数据库中的数据导出到,Excel,文件中,将,Excel,文件中的数据导入到,Java,的数据对象中,使用要求,Excel,导入导出基础类使用了第三方的,Java,库，因此需要使用库文件,jxt.jar,调用类,org.thcic.datafile.excel.*,数据库数据导入导出基础类库,PDF,数据的导出,功能说明,将,Oracle,数据库中的数据导出到,PDF,文件中,使用要求,PDF,导出基础类使用了第三方的,Java,库，因此需要使用库文件,iText.jar,和,iTextAsian.ja,r,目前只提供数据库中的数据以表格的形式到出到,PDF,文件中的功能,调用类,org.thcic.datafile.pdf.*,