Java开发速查（二）——创建WEB工程

本系列是为公司新人准备的简明指南；
持续更新，欢迎转载，请注明源地址

本文使用到工具请见: Java开发速查（一）——环境搭建

一般web工程的结构如下：
/proj （项目的根目录）
/proj/src （java代码的目录）
/proj/WebRoot （这个目录实际就是最终的web发布的目录）
/proj/WebRoot/WEB-INF （Web容器规范定义目录）
/proj/WebRoot/WEB-INF/classes
/proj/WebRoot/WEB-INF/lib

最后项目要发布到WEB应用服务器(如Tomcat)上，需要指定上下文路径（Context Path）。
这个解释一下，就是最后发布到Tomcat的webapps中的目录名称，配置中Context root、Context name指的就是这个，发布后通过 http://localhost:8080/xxx 来访问(这个xxx就是所谓的上下文路径)；

打开eclispe-jee

新建工程，选择Dynamic Web Project类型
1.输入项目名称，存放位置（一般都在workspace中）
2.Target runtime:none（因为使用Tomcat launch plugin，在后面配置）
3.Dynamic web module version: 2.5（可以理解是Servlet的版本，会反映在最终的web.xml定义中，我们还没迈入3.0）



下一步，
4.添加源文件目录（默认src）
5.默认输出目录（一般我们使用WebRoot\WEB-INF\classes）



下一步，
6.Context root:这里要填写的是上下文路径（就是最终发布的webapp的名称，这里例子中是proj）
7.Content directory:WebRoot（我们习惯用WebRoot，而不是WebContent）
8.生成web.xml选项（这个文件一般项目后面会修改）



Finish，会创建一个Web项目；

切换到Java视图,边栏应该会有包视图浏览窗口(Package Explorer).



注意项目的图标带一个小地球，标识这是一个web项目，如果上面有黄色警告叹号，说明项目中有警告信息，去到视图窗口Problems中查看；
在项目根节点上右键，选择Properties，打开属性对话框；

9.调整Project Facets节点设置，将Java版本设置到1.6（Dynamic Web Module 2.5默认对于的是Java1.5）



10.设置Tomcat插件节点，选中"Is a Tomcat Project"，填写Context name，填写web application root(Weboot).



11.lib库设置，加入servlet-api.jar

打开项目属性对话框，Java Build Path节点，Libraries选项；
注意，位于项目的WEB-INF\lib下的库，被创建为Web App Libraries了，不用手动加入jar，只要存放在此目录下的jar，自动会被加进了（在eclipse外拷贝，需要项目根节点上刷新下）；

点击 Add Variable,选中TOMCAT_HOME（这个是Tomcat插件创建的）,点击Extend..，选择到lib下的servlet-api.jar,确定就引入了tomcat中带这个servlet的api库了；



注意，不要拷贝servlet-api.jar到项目lib中去，最终的web工程都是打成war包部署到Web服务器上，这些包Web服务器lib中都有了。

从SVN上检出代码的到项目目录（推荐使用TortoiseSVN在eclipse外部操作，不建议使用eclispe的插件）
需要忽略的目录是lib目录、classes目录及一些.setting的配置目录。

12.设置忽略svn信息

打开项目属性对话框，Java Build Path节点，Source选项中设置代码编译忽略.svn目录（否则会把src中的svn信息拷贝到classes中，造成不必要的混乱），在src下配置Exclude模版加上**/.svn/即可



13.Tomcat 插件使用

在项目的根节点上右键，菜单中会多出一项Tomcat Project（设置了Is tomcat project后会有），选择Update context definition（这会创建一个context定义文件到Tomcat目录的conf/Catalina/localhost/下，这样启动Tomcat会加载此项目）。



最后，使用Tomcat插件的启动关闭来启动和关闭Tomcat,后台输出会直接打印到Console视图窗口。



创建Web工程的基本要点介绍完毕。