java代码规范要求(公司用-补充版).doc

代码规范要求 为保证我公司研发代码的规范性、可读性，特制定该代码规范：1、代码应遵循国际java代码规范2、代码中所有 switch（param）case int：break；中 case 参数应该为在类开始时定义的字符串，以增加后续研发中的可读性。例：private final int company=0; switch(param)case company:break;不允许出现 case 0，case 1 等字样。3、在对数据库进行大量数据读取时，应采用jdbc方式读取。以增快响应速度，减少内存消耗。数据量超过万单位时必须采用jdbc读取数据库，且应分页读取数据库。4、方法作用必须注释，方法中传递的参数应该有注释，全局变量，局部变量都应有注释，以说明变量的意义。如方法会被多次调用，或应对二次开发则应注明返回值 例： return Boolean true 成功 false 失败 ；5、代码中应该采用try catch捕获异常，且应该处理常见异常。6、代码呈现页面不能出现null字样。7、代码测试应用及所需捕获异常或输出信息应该采用log4j进行输出。杜绝出现System.out.println();字样8、代码不应出现重复定义，同一方法不能多次调用数据库，如一个方法中需要多次调用数据库则应拆分为两个或多个。9、同一方法中代码量超过50行则应进行拆分。10、代码应该采用format格式化。11、代码已经提交或二次开发时，应注明修改时间 修改人 修改原因 修改后提交参数的内容12、在未进行实例化的参数判断是否为空时，应该null在前 例：if(null!=param)13、在判断变量是否为空时，尽量避免采用if else 应采用Parame=null?”0”:parame;进行判断赋值14、代码应遵循可读性原则，不能出现过于冗长的代码。15、多次在不同类中反复调用且内容相同的方法，应该写到公用代码中进行调用。16、已经失效，且不会被调用的代码应该注销、删除。17、代码在未经测试时，不要进行提交，以免造成现调用的其他类出现错误。18、项目的配置文档应该遵循规范格式，尽量增加注释。19、页面中的js脚本应该具备可读性、增加注释。Js脚本的规范遵从国际js规范。20、页面中提交的必要的变量参数应该有验证。21、页面提交的信息或执行时间较长、页面上传文档时应该提示用户正在执行等字样。22、页面ext的方法复写定义应该在项目中为唯一，不得出现重复定义相同名称的方法。23、页面提交信息应该与返回提示，例执行成功，执行失败。返回的提示应具有可读性，不得出现英文错误提示。24、vo，set，session，list，map赋值应该及时清空，以免占用内存。25、如集合中的数据在同一类中会被多次调用，应该定义到类的全局变量中，在同一类的不同方法中进行调用，避免重复占用内存。26、代码的业务规范应该遵从严谨的要求，在进行数据操作时，出现异常应有回滚操作。27、代码hibernate调用数据库查询时，应采用query分页，尽量避免使用subList方法。28、页面进行打印，线条应采用单线。29、页面在通常没有特殊要求的情况下，最少应支持ie浏览器。30、代码在提交时，不应出现需要测试用的log内容，前期试运行时如需跟踪则应注明，在正常运行后进行删除或注销。31、系统中反复使用的变量因进行缓存调用。32、避免在for循环中反复调用数据库进行对比。33、sql中尽量避免使用like查询。34、id一般不用int类型，用long类型。35、尽量避免拼凑sql语句，应当用占位符，预处理来发送sql语句。36、在处理多个字符串变量的时候要尽量使用 StringBuffer 类。37、方法名及类名称应具备一定的意义，而非随意命名。38、代码提交到cvs、svn、gita服务器时，要注明提交内容。39、不得随意覆盖其他人提交的代码，提交时应给予沟通，验证无问题、不影响系统运行、不影响系统参数传递及结果时，才可提交。40、所有代码功能都要进行详细测试，应按照测试报告规范格式进行测试，并注明测试用例，测试结果，问题跟踪及解决情况。41、测试人