SpringMVC框架下Web项目的搭建与部署
这篇文章已被废弃。
现在,Deolin使用Maven构建项目,而不是下载Jar文件,使用Jetty插件调试项目,而不是外部启动Tomcat。
SpringMVC比起Servlet/JSP方便了太多
Web容器——Tomcat
访问http://tomcat.apache.org/download-90.cgi,
根据操作系统,选择并下载Binary Distributions - Core下的zip文件,解压。
测试:运行%tomcat%\bin\startup.bat,浏览器访问localhost:8080…
成功。
下载JAR文件
http://repo.spring.io/release/org/springframework/spring/4.3.7.RELEASE/
如果想要选择其他的版本,改变链接中的4.3.7即可。
选择*-dist.zip即可。
构建项目
1.在eclipse Java EE中新建一个动态Web项目(Dynamic Web Project)
2.更改配置路径
3.声明依赖库
4.单纯在项目中声明jar文件,只能让eclipse能够找到这些jar文件,
使代码中引入这些类时不至于编译报错,但仅仅这样是不足的,
为了让Web容器也能访问到项目所需的jar文件,需要复制一份到WEB-INF/lib目录下。
5.编写web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://java.sun.com/xml/ns/javaee"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">
<display-name>DemoApp</display-name>
<servlet>
<servlet-name>springmvc</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value><!-- 等完成了SpringMVC的配置文件再来补全 --></param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springmvc</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
6.生成并编写SpringMVC配置文件。
在此之前需要生成一个区别于“src”的全新的代码文件夹(Source Folder),专门用于存放配置文件。
对于会用到不止一个框架的JavaWeb项目来说,将所有的配置文件统一起来是合适的。
与“src”一样,“conf”内的文件会输出到项目的classpath中(与“src”内的java文件先编译成class文件输出不同的是,xml文件被直接复制到classpth中)。
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-3.2.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd">
<!-- 注解处理器适配器、处理器映射器 -->
<mvc:annotation-driven />
<!-- 处理器(@controller) -->
<context:component-scan base-package="controller" />
<!-- 视图解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/jsp/" />
<property name="suffix" value=".jsp" />
</bean>
</beans>
7.补全web.xml
<param-value>classpath:springframework/springmvc-servlet.xml</param-value>
8.web.xml已经完成,现在web容器可以基于web.xml内的<servlet/>和<servlet-mapping/>来将请求URL映射到指定的Servlet类(对于SpringMVC来说,是DispatcherServlet.class)上了。
但在此之前,需要让tomcat知道DemoApp的存在——指定tomcat的默认应用为本演示项目。
编辑%tomcat%\conf\server.xml,在最后的“Host”标签中添加“Context”标签。
尝试着启动tomcat(%tomcat%\bin\startup.bat)...
...结果是启动失败,控制台闪退。
Deolin尝试了很多次,还是没能在闪退前成功地将控制台窗口截图。
查看一下日志文件(%tomcat%\logs\catalina.*.log)
问题在于缺少了Apache Commons Logging库(http://commons.apache.org/proper/commons-logging/download_logging.cgi)
下载解压完毕后,将jar文件复制到WEB-INF/lib
再次启动tomcat…
启动成功。
9.编写个控制器和JSP
/DemoApp/src/controller/ForumController.java
package controller;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class ForumController {
@RequestMapping(value="/forum")
public String requestMethod(Model m) {
m.addAttribute("oneName", "oneValue");
System.out.println("Hey, there");
return "Forum";
}
}
/DemoApp/WebContent/WEB-INF/jsp/Forum.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ page import="java.util.*" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML>
<HEAD>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<TITLE>title</TITLE>
</HEAD>
<BODY>
${oneName}
</BODY>
</HTML>
重启tomcat,浏览器访问 localhost:8080
(由于在tomcat配置文件的Context标签中定义了本应用的路径(path)为“/”,所以URL中没有“上下文”部分)
10.声明静态资源
比起测试通过,更有趣的事情是出现了一个新的警告。
每次请求时,tomcat会去访问Web应用根路径下的favicon.ico作为网页的图标,而这个请求会被DispatcherServlet认为是一个用来请求控制器的URI而拦截。
由于控制器中不存在映射了[/favicon.ico]的请求方法,那么自然会出现noHandlerFound警告
解决方法是为这个URI单独添加专门的映射。
/DemoApp/conf/springframework/springmvc-servlet.xml的<beans/>标签内。
<!-- 为静态资源单独映射 -->
<mvc:resources mapping="/favicon.ico" location="/favicon.ico" />
单纯变更SpringMVC的配置文件并不需要重启tomcat,等应用完成了部署,浏览器再次访问 localhost:8080
警告消失了。
至此,Web项目便搭建和部署完成了。
远程Debug
1.首先要让tomcat开放用于Debug的端口。
编辑%tomcat%\bin\startup.bat
所有指令的前面添加一条指令
set CATALINA_OPTS=-server -Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8000
测试:重启动tomcat
可以看到启动最初的消息中出现了新增配置中的信息。
2.在eclipse中启动Debug(初次启动)
Debug View显示Debug已经开始
添加断点
浏览器再次访问 localhost:8080。
断点正常工作。
3.退出Debug
远程Debug不影响tomcat,需要退出Debug模式仅仅需要在eclipse的Debug View中中断Debug即可。
4.日常启动Debug
初次配置过Debug以后,每次启动debug便不在需要配置,直接启动即可。