maven+SSM+junit+jetty+log4j2环境配置的最佳实践

思路大致是 jetty插件 -> junit -> SpringMVC -> Spring -> log4j2 -> Mybatis整合

pom中的依赖跟着思路一批一批的来

 

创建项目

1、eclipse中创建一个maven项目，Packing选war，

Project Facts的Dynamic Web Module改成3.0，Java改成1.8。

 

2、创建后用Java EE Tools -> Generate Deployment Descriptor Stub生成WEB-INF目录。

错误消除。确保web.xml的version是3.0。

 

jetty插件

3、在src/main/resource下建立jetty目录，把编辑好的webdefault.xml放进去（webdefault.xml的取得和修改）。

在pom.xml里追加<build/>

    <build>
        <plugins>
            <plugin>
                <groupId>org.eclipse.jetty</groupId>
                <artifactId>jetty-maven-plugin</artifactId>
                <version>9.4.6.v20170531</version>
                <configuration>
                    <scanIntervalSeconds>60</scanIntervalSeconds>
                    <webApp>
                        <contextPath>/</contextPath>
                        <defaultsDescriptor>
                            src/main/resources/jetty/webdefault.xml
                        </defaultsDescriptor>
                    </webApp>
                    <stopKey>shutdown</stopKey>
                    <stopPort>8085</stopPort>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.6.1</version>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                </configuration>
            </plugin>
        </plugins>
    </build>

 

4、eclipse -> Run创建一个External Tools，

Main选项卡中Location指向maven客户端，

Working Directory指向本项目，

Arguments填jetty:run，

Environment选项卡中追加

　　MAVEN_OPTS

　　-Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,address=8090,server=y,suspend=y

 

5、创建一个Remote DEBUG，端口填8090

 

※ 红蓝先后启动后，服务器就正式启动了，

但是由于jetty默认首页被注释掉了，所以想要测试的话，

需要在webapp目录下写个html做测试（顺便可以试试热修改静态文件）。

 

6、想要关闭的话，创建一个External Tools即可，其中Arguments填jetty:stop，Environment中不追加参数

 

※ 默认端口号(8080)，DEBUG用端口号(8090)，关闭用端口号(8085)，三者最好不一致，避免不必要的麻烦。

 

Junit

7、pom.xml追加

　　junit

　　spring-test

 

SpringMVC

8、pom.xml中追加

　　spring-webmvc

　　servlet-api

 

9、web.xml追加DispatcherServlet，顺便把编码过滤器也加了

    <servlet>
        <servlet-name>spring-webmvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springframework/dispatcherservlet-servlet.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>spring-webmvc</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

    <filter>
        <filter-name>encodingFilter</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>forceEncoding</param-name>
            <param-value>true</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>encodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

 

10、src/main/resources的springframework中创建配置文件

dispatcherservlet-servlet.xml

<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.xsd
            http://www.springframework.org/schema/context
            http://www.springframework.org/schema/context/spring-context.xsd
            http://www.springframework.org/schema/mvc
            http://www.springframework.org/schema/mvc/spring-mvc.xsd">

    <!-- 处理静态资源 -->
    <mvc:default-servlet-handler />

    <!-- 注解驱动 -->
    <mvc:annotation-driven />

    <!-- 扫描controller -->
    <context:component-scan base-package="io.deolin.controller" />

    <!-- 视图解析器 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/html/" />
        <property name="suffix" value=".html" />
    </bean>

</beans>

 

※ SpringMVC完成，可以写个controller测试一下

 

Spring

11、需要spring-context依赖，但在spring-webmvc里面已经有了，所以pom.xml不用追加了

 

12、src/main/resources的springframework中创建配置文件

application-context.xml

<?xml version="1.0" encoding="UTF-8" ?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.springframework.org/schema/beans
                http://www.springframework.org/schema/beans/spring-beans.xsd">

    <import resource="classpath:springframework/spring-*.xml" />

    <bean class="io.spldeolin.bestpractice.util.ApplicationContext" />

</beans>

 

 

13、创建类io.deolin.util.ApplicationContext

package io.deolin.util;

import org.springframework.context.ApplicationContextAware;

public class ApplicationContext implements ApplicationContextAware {

    private static org.springframework.context.ApplicationContext applicationContext;

    @Override
    public void setApplicationContext(org.springframework.context.ApplicationContext applicationContext) {
        ApplicationContext.applicationContext = applicationContext;
    }

    public static org.springframework.context.ApplicationContext getApplicationContext() {
        return applicationContext;
    }

    public static Object getBean(String name) {
        return applicationContext.getBean(name);
    }

}

 

 

 

14、web.xml追加Spring上下文监听器和上下文配置

    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>
            classpath:springframework/application-context.xml
        </param-value>
    </context-param>

 

※ Spring完成，Spring上下文被映射到了工具类SpringContext，可以写个POJO，注册到application-context.xml中，测试一下

 

Log4j2

 

15、pom.xml中追加

log4j-web　　　　(里面包含了log4j2的api依赖 和 实现依赖)

log4j-jcl　　　　　(使log4j2的实现依赖能适配到spring-core中commons logging的api依赖)

 

16、web.xml中追加Log4j2上下文监听器和过滤器

    <listener>
        <listener-class>org.apache.logging.log4j.web.Log4jServletContextListener</listener-class>
    </listener>
    <filter>
        <filter-name>log4jServletFilter</filter-name>
        <filter-class>org.apache.logging.log4j.web.Log4jServletFilter</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>log4jServletFilter</filter-name>
        <url-pattern>/*</url-pattern>
        <dispatcher>REQUEST</dispatcher>
        <dispatcher>FORWARD</dispatcher>
        <dispatcher>INCLUDE</dispatcher>
        <dispatcher>ERROR</dispatcher>
    </filter-mapping>

 

17、src/main/resources中新建log4j2.xml

Deolin目前用的是 这套配置

 

MyBatis

18、pom.xml中追加

mybatis

mybatis-spring

commons-dbcp2

spring-tx

spring-jdbc

mysql-connector-java

 

19、src/main/resources中新建mybatis/db.properties

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/web-integration?characterEncoding=UTF-8&useSSL=false
jdbc.username=root
jdbc.password=root

 

20、src/main/resources/mybatis中新建mappers.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <mappers>
        <package name="io.deolin.mapper" />
    </mappers>
</configuration>

 

21、在src/main/resources/springframework中新建spring-mybatis.xml

<?xml version="1.0" encoding="UTF-8" ?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:context="http://www.springframework.org/schema/context"
    xmlns:tx="http://www.springframework.org/schema/tx" xmlns:util="http://www.springframework.org/schema/util"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.springframework.org/schema/beans
                http://www.springframework.org/schema/beans/spring-beans.xsd
                http://www.springframework.org/schema/context
                http://www.springframework.org/schema/context/spring-context.xsd">

    <context:property-placeholder location="classpath:mybatis/db.properties" />

    <bean id="dataSource" class="org.apache.commons.dbcp2.BasicDataSource">
        <property name="driverClassName" value="${jdbc.driver}" />
        <property name="url" value="${jdbc.url}" />
        <property name="username" value="${jdbc.username}" />
        <property name="password" value="${jdbc.password}" />
    </bean>

    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="dataSource" ref="dataSource" />
        <property name="configLocation" value="classpath:mybatis/mappers.xml" />
    </bean>

    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="io.deolin.mapper"></property>
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"></property>
    </bean>

</beans>

 

 

22、application-context.xml中追加

    <import resource="classpath:springframework/spring-mybatis.xml" />

 

※ Mybatis整合完整，同时启动了事务管理，可以写个Service层和Mapper层测试一下。

 

详细：Github