1. 新建项目
IDEA中新建Maven项目,使用Maven Archetype原型:maven-archetype-webapp
新建项目结构为:
2. 新建包目录
- 新建Java代码目录:src.main.java
src.main.java
下新建分层模型package,带上项目的groupId
(仅供参考)common
:存放全局变量,公共枚举等base
:存放基础组件,如工具类,过滤器,配置类等controller
:控制层vo
:前端传输过来的对象,如封装的请求bo
:业务对象,可能是多个dto/entity的整合service
:业务层- intf:接口
- impl:实现
dao
:数据库访问层- intf:接口(MyBatis中为xxxMapper.java)
- impl:实现(MyBatis中自动生成实现类)
dto
:数据传输对象,存放多表联合对象entity
:实体,对应数据库表
- 新建资源目录:src.main.resources
3. 按需引入pom
新建工程后,不建议一次性引入所有的依赖,而是在需要的时候逐步引入,这样虽然会踩很多坑,但是可以熟悉每个依赖的作用,防止以后踩更大的坑。
新建工程后,第一次需要引入的依赖有:
- Servlet API
Java Web的应用服务器会带有Servlet API,所以这个依赖的scope设成provided
<dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>${servlet.version}</version> <scope>provided</scope> </dependency>
- Spring Web Mvc
Spring Web依赖,包括Spring MVC,IDEA会把Spring Web Mvc所依赖的其他Spring模块也引入,有:aop、beans、context、core、expression、web,其余的模块不用引,但是为了扩展性,还是引入比较好。
<dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>${spring.version}</version> </dependency>
4. 配置web.xml
4.1 配置ContextLoaderListener
ContextLoaderListener
是ServletContext监听器,用于创建容器对象,并且将ApplicationContext对象放到Application域中,并指定spring核心配置文件。
关于ContextLoaderListener的具体作用及源码,会另写文章分析。
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:spring.xml</param-value>
</context-param>
4.2 配置DispatcherServlet
DispatcherServlet
是前端控制器,配置中指定Spring MVC的配置文件。
关于DispatcherServlet的具体作用及源码,会另写文章分析。
<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:spring-mvc.xml</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>
4.3 处理中文乱码问题
配置CharacterEncodingFilter
过滤器处理中文乱码问题,要放到所有过滤器之前。
<filter>
<filter-name>CharacterEncodingFilter</filter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
<init-param>
<param-name>forceRequestEncoding</param-name>
<param-value>true</param-value>
</init-param>
<init-param>
<param-name>forceResponseEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>CharacterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
4.4 整合Restful风格请求
配置HiddenHttpMethodFilter
过滤器,将get/post请求转换为标准的http方法,使得支持GET、POST、PUT与DELETE请求。
<filter>
<filter-name>HiddenHttpMethodFilter</filter-name>
<filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>HiddenHttpMethodFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
5. 配置Spring配置文件
Spring配置文件路径是配置在web.xml ContextLoaderListener
中。
初始的Spring配置文件需要配置包扫描,将满足条件的Java Bean注入到Spring容器中,由Spring进行管理。
<!-- 设置包扫描,不扫描Controller -->
<context:component-scan base-package="com.lyldelove">
<context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
</context:component-scan>
6. 配置Spring MVC配置文件
Spring MVC配置文件路径是配置在web.xml DispatcherServlet
中。
初始的Spring MVC配置文件需要配置以下3项:
- 包扫描。扫描所有Controller
- 开启基于注解驱动的mvc。开启后可使用Spring MVC的高级功能
- 配置默认的静态资源处理器
- 配置视图解析器
<!-- 设置包扫描,扫描所有的Controller -->
<context:component-scan base-package="com.lyldelove" use-default-filters="false">
<context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
</context:component-scan>
<!-- 开启基于注解驱动的mvc,开启后可使用Spring MVC的高级功能 -->
<mvc:annotation-driven/>
<!-- 配置默认的静态资源处理器 -->
<mvc:default-servlet-handler/>
<!-- 配置视图解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<!--配置解析前后缀-->
<property name="prefix" value="/WEB-INF/views/"/>
<property name="suffix" value=".jsp"/>
</bean>
静态资源的处理,还可以通过<mvc:resources />来解析配置
7. 引入前端JS/CSS
前端所需的js/css等静态文件,一般放在webapp
目录下
8. 日志框架整合
在整合其他框架的过程中,项目可能会有很多异常/报错,我们需要通过日志来查找问题。
日志框架需要日志门面及日志实现,我们采用slf4j
做日志门面,log4j
做日志实现,看如何整合。
引入依赖:
<!-- 日志,slf4j做日志门面,log4j做日志实现 -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>${slf4j.version}</version>
</dependency>
引入slf4j-log4j12后,IDEA会自动引入slf4j-api和log4j的依赖,不需要再显示引入
log4j
会自动扫描src/main/resources
目录下的log4j.xml
或log4j.properties
,我们把配置文件放在此目录下。
#log4j.properties
#日志输出级别
log4j.rootLogger=debug,stdout,D,E
#设置stdout的日志输出控制台
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
#输出日志到控制台的方式,默认为System.out
log4j.appender.stdout.Target = System.out
#设置使用灵活布局
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
#灵活定义输出格式
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} -[%p] method:[%c (%rms)] - %m%n
9. 数据源整合
以Druid为例,需要引入Spring JDBC
和Druid
的依赖,同时数据库连接信息最好单独出一个配置文件来管理,再在Spring配置文件中引入外部的配置文件。
依赖:
<!-- Spring jdbc -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-jdbc</artifactId>
<version>${spring.version}</version>
</dependency>
<!-- 数据源Druid -->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>${druid.version}</version>
</dependency>
注意:要记得引入Spring jdbc的依赖,否则后面出问题会很难找(有日志还好找一点,所以最好日志框架的整合放到最前面)。
Spring配置:
<!-- 加载外部配置文件 -->
<context:property-placeholder location="classpath:jdbc.properties"/>
<!-- 配置Druid数据源 -->
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource">
<property name="url" value="${jdbc.url}"/>
<property name="username" value="${jdbc.user}"/>
<property name="password" value="${jdbc.password}"/>
<!-- 指定连接池中最大的活跃连接数 -->
<property name="maxActive" value="20"/>
<!-- 指定启动连接池时,初始建立的连接数量 -->
<property name="initialSize" value="1"/>
<!-- 指定连接池等待连接返回的最大等待时间,毫秒单位. -->
<property name="maxWait" value="60000"/>
<!-- 指定必须保持连接的最小值(For DBCP and Tomcat connection pools) -->
<property name="minIdle" value="1"/>
</bean>
10. MyBatis + MySql整合
依赖:
<!-- Spring jdbc -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-jdbc</artifactId>
<version>${spring.version}</version>
</dependency>
<!-- MyBatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>${mybatis.version}</version>
</dependency>
<!-- MyBatis整合spring -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
<version>${mybatis.spring.version}</version>
</dependency>
<!-- MySQL驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>${mysql.version}</version>
</dependency>
Spring配置文件中配置MyBatis:
需要配置下面2项:
- 配置sqlSessionFactory
- 配置映射扫描器
<!-- 配置MyBatis sqlSessionFactory -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource"/>
<!-- 指定MyBatis 的 XML 配置文件路径 -->
<property name="configLocation" value="classpath:mybatis.xml"/>
<!-- 指定映射器 XML 文件路径 -->
<property name="mapperLocations" value="classpath:mapper/**/*.xml"/>
</bean>
<!-- 扫描MyBatis映射器 -->
<bean id="mapperScannerConfigurer" class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value="com.lyldelove.dao"/>
</bean>
MyBatis配置文件:
在Spring配置文件sqlSessionFactory配置项中配置了MyBatis的配置文件,MyBatis的配置文件中,需要配置骆驼命名法则,还可以配置别名。
<settings>
<!-- 其余骆驼命名法则,是的数据库字段可以对应JavaBean属性 -->
<setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>
<!-- 起别名,这样在Mapper.xml文件中,resultType就可以简写,默认规则是JavaBean类名首字母小写 -->
<typeAliases>
<package name="com.lyldelove.entity.system"/>
</typeAliases>
11. 需要深入挖掘的点
ContextLoaderListener
作用及源码分析DispatcherServlet
作用及源码分析- Filter过滤器工作原理
- Spring/Spring MVC配置文件解析及相关配置项的作用和源码分析
- 日志框架深入,配置项
- 日志框架是如何整合进来的,实现原理
- 什么是数据源
原文地址:https://www.cnblogs.com/lyldelove/p/12624256.html