Ecology系统程序员开发指南.docVIP

Ecology系统程序员开发指南 文件编号： FFPD-0100- JSWD- 001 生效日期： 2003-08-25 受控编号： FFPD-0100- JSWD- 001 密级： 版次：1.1 修改状态： 总页数 正文 附录 编制：杨国生 审核：刘煜 批准：刘煜 文件修改控制 修改记录编号 修改 状态 修改页码及条款 修改人 审核人 批准人 修改日期 A1 新建V1.0 杨国生 刘煜 刘煜 2003-08-25 目 录 1. 引言 4 1.1 概述 4 1.2 定义 4 1.3 参考资料 4 2. 开发规范 5 3. 底层包应用及范例 7 3.1 最基本的继承类 7 3.2 怎样记录日志 8 3.3 怎样获取属性文件的值 11 3.4 怎样获取系统的运行目录 13 3.5 怎样访问和运行数据库脚本 14 3.6 如何上传一个文件 18 3.7 如何访问已经上传的文件 22 3.8 如何使用缓存提高系统效率 23 3.9 其它底层类基本方法 32 引言 概述 本需求文档为泛微协同商务系统（Ecology）程序员开发指导文档，讲述了开发的规范，底层工具包的应用，常用功能的开发。通过本文档，开发人员应掌握 定义 参考资料 书籍资料 编号 资料名称 简介 1 Thinking in java Java 思想－一本很不错的书 2 Java Servlet Programing Java Servlet 编程 3 J2EE 大全 J2EE 的一本学习书 Intenet上杂志、专业著作、技术标准以及他们的网址。 网址 简介 J SUN 的java 网站 java 中文站 （较多的书籍， 代码） java 学习网 开发规范 程序文件头部加上文件描述，包括标题，描述，公司，作者，版本，创建日期，修改记录，如下： /** * Title: 数据库链接池集合 * Description: 所有的数据库链接池的集合，用链接池名称区别每一个 * 链接池 * Company: 泛微软件 * @author : 杨国生 * @version 1.0 * create date : 2001-10-23 * modify log: * 2002-09-13 杨国生 增加链接池Encode参数 * * */ 各个明显部分间加空行，各方法间加空行，方法前面加方法的注释，遵从JavaDoc规范，与所释方法间不加空行。注释用中文给出： /** * 从指定名称的链接池中获得一个可用连接.若没有可用连接,且已有连接 * 数小于最大连接数限制, 则创建并返回新连接.否则, 在指定的时间内等 * 待其它线程释放连接.如指定的时间内没有链接返回，则返回空。 * * @param name 连接池名字 * @param time 以毫秒计的等待时间 * @return WeaverConnection 可用连接或null */ public WeaverConnection getConnection(String name, int time) { DBConnectionPool pool = (DBConnectionPool) pools.get( name ) ; if (pool == null) pool = createPools( name ) ; if (pool != null) { clients ++ ; return pool.getConnection( time ) ; } return null; } 大括号{ 不换行， } 需要换行。当中代码要缩进。缩进为4个空格，必须以空格代替Tab键。 圆括号()与前面的方法名间留一个空格，括号内的每个参数前留一个空格，最后一个参数后也留一个空格。 逗号后面，分号前面，运算符号和赙值符号的前后，留一个空格。 类、接口名大写字母开头，后面单词首字母大写。尽量不用下划线。如UserGroup（Class）。 对象实例、变量小写字母开头，后面单词大写。如userSQLBean（UserSQL对象的实例） ， locationName（变量）。 方法名小写字母开头，首单词一般为动词，后面单词大写开头。如User.getUserName，UserSQLBean.formatSQLSearch。 开发代码不能使用当前开发环境已经不