一、项目结构

这里和其他项目区别不大,我将模板抽离出来,更容易分析和理解:

 

解释一下:js主要包括extends(引入第三方的js)、module(项目模块自己的js)、lib(引用包,这里也可以继续拆分),module中包含具体的模块中的js。common.js是核心命名空间的js.

二、common.js

 

解释一下,Globals作为全局命名空间,各个模块均可以在此命名空间里定义域(如果有不明白的可以自学下命名空间,这个文件写死就行,也不用具体理解)。

 

 


华东web项目工程规范

 

 



基于Java开发平台开发业务系统,建议使用maven作为构建工具,以方便不同组件和依赖包的管理。客户现场开发的情况,访问Maven仓库确实困难的,可事先将依赖关系以Release的方式下载到一个集中的目录,然后使用Ant对工程进行构建。

程序目录结构应遵从maven默认约定(即使采用ANT构建),以统一规范,简化构建配置。一个典型的JavaEE应用(对应公司某产品、或某个项目的程序),目录结构如下:

 

大型项目应划分多个工程(project,模块),每个工程的目录结构也同样遵从相同约定。

各目录的内容/用途如下:


目录



用途



src/main/java



Application /Library 的java源代码(再分package)



src/main/flex



增加:flex源码,包含mxml定义、assets和as脚本



src/main/resources



Application/Library 的资源文件,如多字符集boundle,位图,配置文件等(单独建立conf等子目录)



src/main/resources/conf



增加:准备封到JAR包中的配置文件(默认包下conf/目录)



src/main/filters



【暂不用】Resource filter files



src/main/assembly



【暂不用】Assembly descriptors



src/main/config



【暂不用】maven配置文件



src/main/webapps



Web 应用的网页,WEB-INF目录等所在,详见本表下方说明



 



 



src/test/java



单元测试的源代码



src/test/resources



测试使用的资源文件,如集成测试脚本等



src/test/resources/conf



增加:测试用例需要的配置文件



src/test/filters



【暂不用】Test resource filter files



src/site



【暂不用】Site



 



 



target



maven编译目录,包含中间过程文件和最终的工件(如jar)



 



 



pom.xml



Maven工程的配置文件,以此控制maven构建行为



LICENSE.txt



产品/本工程的版权信息文件



README.txt



产品/本工程的说明文件


 

为规范war包结构,对src\main\webapp目录做如下约定:


目录



存放内容



css



存放.css格式文件(可再分目录)



skins



存放皮肤文件(按主题划分的framework的位图)



images



存放图片,按产品、功能模块划分子目录



js



JavaScript文件(对象、函数库)



include



存放被包含的JS文件片段【注:JSP文件互相不要包含,通过模板/组件/标签库/BEAN实现重用】



resources



存放JSF组件、相关资源等



templates



模板文件存放地,按类别划分子目录



pages



网页目录(静态和动态网页,除index.jsp),按产品、功能模块划分子目录



webapp下其他目录



解释为模块名,认为其中全部为网页,可再分子目录



META-INF



存放清单文件、services等配置信息



WEB-INF



网站配置文件目录,存放WEB.XML等配置信息



WEB-INF/classes



未打包的项目编译代码,禁止手工修改。



WEB-INF/conf



存放struts,spring,hibernate,JSF等的配置文件



WEB-INF/lib



存放第三方JAR包,使用MAVEN构建时此目录禁止手动放入文件!



WEB-INF/pages



高安全性的网页目录,如登录信息维护等



WEB-INF/tld



JSP标签库定义文件存放目录