4.电商框架搭建(一)Spring MVC配置

最新推荐文章于 2025-12-02 15:55:42 发布

原创最新推荐文章于 2025-12-02 15:55:42 发布 · 239 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#java #测试 #web.xml

Java Web总结专栏收录该内容

15 篇文章

订阅专栏

本文详细介绍如何使用Maven创建Java Web项目并配置Spring MVC框架，包括项目结构、依赖管理、Spring MVC配置等方面的内容。

在之前的工作都很好完成的情况下，可以开始搭建电商框架了。

1. 首先，新建一个maven项目。

这里maven项目其实等于maven + Java Web项目。新建的过程中选择的archetype决定Java项目的类型，比如选择webapp 就是Java Web项目，选择quickstart 就是新建一个简单的Java项目。

（Maven相关使用请参考 Maven总结，Java Web 项目请参考简单Java Web项目举例）

项目建成之后，显示如下：

这里myeclipse自动给项目名后面添加了Maven Webapp,我一般习惯把名字改成实际的项目名，这里修改为myecom，项目主要有以下几部分组成：

pom.xml：主要用来配置项目的jar包等等，
src/main/resources：主要用来存放配置项目的配置文件和一些资源
src/main/webapp：主要用来放置前端页面相关的文件，其中web.xml是项目的启动入口
src/main/java：Myeclipse没有自动生成java文件夹，这里需要我们手动进入硬盘目录新建一下，这个文件夹主要是放置Java代码
target：存放项目构建后的文件和目录，jar包、war包、编译的class文件等。
初始化依赖包

添加java文件夹，修改source显示方式（右击项目build path->config build path,右侧source tab 下，点击add folder按钮，选中java文件夹即可，当然也可以通过项目的.classpath文件修改），最后可以看到显示如下：

以上是我工作中常用的项目结构，至于有些书或者博客讲的结构标准化，可以了解参考，我觉得类似。

项目建成之后右击run as -> run on server，http://localhost:8080/myecom/ 地址的页面显示hello world 表示新建成功。

2.添加需要用到的jar包

之前的博客说过，我们用spring4 来完成这个项目，那我们就通过pom.xml来添加spring4相关的包。点击pom.xml，再点击pom.xml的dependencies，点击add按钮，搜索spring4的包，点击添加，如下：

经过多次添加后如下：

当然，包能正确引入的前提是，对相关包的作用以及关联包比较熟悉，这个需要查看官网、博客以及长期的经验积累，这里我添加的包以及用途可以参看pom.xml代码，如下：

  <!-- spring mvc相关的包-->
        <dependency>
        	<groupId>org.springframework</groupId>
        	<artifactId>spring-webmvc</artifactId>
        	<version>4.3.0.RELEASE</version>
        </dependency>
        
         <!-- spring 事物管理相关的包-->
        <dependency>
        	<groupId>org.springframework</groupId>
        	<artifactId>spring-tx</artifactId>
        	<version>4.3.0.RELEASE</version>
        </dependency>
        
        <!-- spring 数据库链接相关的包-->
        <dependency>
        	<groupId>org.springframework</groupId>
        	<artifactId>spring-jdbc</artifactId>
        	<version>4.3.0.RELEASE</version>
        </dependency>
        <dependency>
			<groupId>springframework</groupId>
			<artifactId>spring-orm</artifactId>
			<version>1.2.5</version>
		</dependency>
		
		<!-- Spring 面向切面AOP相关用到的包，Spring 3.0以前的版本不需要手动引入，之后则需要引入，如下 -->
        <dependency>
        	<groupId>org.aspectj</groupId>
        	<artifactId>aspectjweaver</artifactId>
        	<version>1.8.9</version>
        </dependency>
       
         <!-- HttpServletRequest 等用 -->
        <dependency>
        	<groupId>javax.servlet</groupId>
        	<artifactId>servlet-api</artifactId>
        	<version>2.5</version>
        </dependency>

引入的所有包可以在Maven Dependencies下查看：

点击相关的包可以查看所包含的class以及源文件。值得注意的是，有些在pom.xml里没手动引入的包也在maven dependencies里了，这是maven根据jar之间的依赖关系自动下载并引入的。

3.配置Spring MVC

Java Web项目的配置，基本上都是从myecom\src\main\webapp\WEB-INF\web.xml这个文件开始的。Spring MVC的启动时通过DispatcherServlet这个servlet启动的，所以我们要在web.xml里配置并声明其为第一个启动的servlet，如下：

  <servlet>
    <servlet-name>springmvc</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:config/springmvc-servlet.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
  
  <servlet-mapping>
    <servlet-name>springmvc</servlet-name>
    <url-pattern>*.do</url-pattern>
  </servlet-mapping>

其中，

①<servlet>标签里的内容是配置并设置启动的servlet，如果没有<init-param>这个标签，系统在启动时会默认在webapp\WEB-INF下找 servlet-name+"-servlet"名字的xml，有的话就去相应路径加载。
②classpath:config/springmvc-servlet.xml（内容见后面部分），是src\main\resources\config\springmvc-servlet.xml，为了方便管理配置文件，我们常常会在src\main\resources\下新建一个config文件，将所有配置文件放到这里，配置是路径类似：classpath:config/文件名.xml等。
③</servlet-mapping>里面规定的是请求格式，这里我们就允许以.do的请求访问。

springmvc-servlet.xml是servlet的一些配置，目前初始还是简单配置，之后配置会慢慢增多，如下：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p"
    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-3.0.xsd
    http://www.springframework.org/schema/context
    http://www.springframework.org/schema/context/spring-context-3.0.xsd
    http://www.springframework.org/schema/mvc
    http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd"> 
   
    <!-- 默认的注解映射的支持 -->  
    <mvc:annotation-driven />
     
    <!-- 自动扫描该包，将注解的类变为bean，并注入上下文直接使用-->  
    <context:component-scan base-package="com.qyuz.controller" />
    
    <!-- 定义跳转的文件的前后缀 ，视图模式配置 -->  
    <bean  
        class="org.springframework.web.servlet.view.InternalResourceViewResolver">  
        <!-- 这里的配置我的理解是自动给后面action的方法return的字符串加上前缀和后缀，变成一个 可用的url地址 -->  
        <property name="prefix" value="/WEB-INF/views/" />
        <property name="suffix" value=".jsp" />
    </bean>
</beans>

其中，

①<mvc:annotation-driven/>相当于注册了DefaultAnnotationHandlerMapping和AnnotationMethodHandlerAdapter两个bean，配置一些messageconverter。简单地说，就是提供了注解可使用的前提，注解相关内容见
②<context:component-scan base-package="com.qyuz.controller" />，xml配置了这个标签后，Spring可以自动去扫描base-package下面或者子包下面的类文件，如果扫描到有@Controller@Service等这些注解的类，则把这些类注册为bean，并注入上下文使用（com.qyuz.controller这个包现在还没有，后面会建）。
注意：如果配置了<context:component-scan>，那么<context:annotation-config/>标签就可以不用配置了，前者包含了后者。另，扫描范围可以自定义，将<context:component-scan的use-default-filters设置为false，配合使用 <context:include-filter> <context:exclude-filter>即可。
③<bean></bean>标签里的内容是定义了一个内容解析器，用来处理Controller返回的ModelAndView，并映射成<property>标签规定的样子，这里是映射成，"/WEB-INF/views/"+返回值+".jsp".

到此，Spring mvc在项目中相关的配置基本完成。

查看下一篇博客继续…