Springboot+Maven多模块开发 （一）初始化工程（新建第一个web工程）

学习Springboot+maven多模块开发笔记。

首先创建一个空项目，新建一个pom文件，该pom文件是整个工程的parent pom。

pom文件内容如下：

<pre name="code" class="html"><?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.cn</groupId>
    <artifactId>SpringBoot</artifactId>
    <packaging>pom</packaging>
    <version>1.0.0-SNAPSHOT</version>
    <modules>
        <module>webapp-pc</module>
    </modules>
    <name>SpringBoot Maven Webapp </name>
    <url>http://maven.apache.org</url>
    <dependencyManagement>
        <dependencies>
            <dependency>
                <!-- Import dependency management from Spring Boot -->
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>1.3.3.RELEASE</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <!--如果要把springboot工程打包成war执行，需要该jar-->
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-legacy</artifactId>
                <version>1.0.2.RELEASE</version>
            </dependency>
        </dependencies>
    </dependencyManagement>
</project>

这里用import的方式引入springboot的parent，因为我们要分模块开发，由一个父pom来管理 所有模块的依赖，总不能在每个模块里面都引入。

新建第一个Maven web工程：

webapp-pc的pom文件内容如下：

<pre name="code" class="html"><project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <parent>
        <artifactId>SpringBoot</artifactId>
        <groupId>com.cn</groupId>
        <version>1.0.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <artifactId>webapp-pc</artifactId>
    <packaging>war</packaging>
    <name>webapp-pc Maven Webapp</name>
    <url>http://maven.apache.org</url>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <!--要使用LOG4J，去掉该依赖-->
            <exclusions>
                <exclusion>
                    <groupId>org.slf4j</groupId>
                    <artifactId>log4j-over-slf4j</artifactId>
                </exclusion>
                <exclusion>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-starter-logging</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        <!--使用log4j，不使用默认的logback-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-log4j</artifactId>
        </dependency>
        <!--要打成war包执行，需要该依赖-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-legacy</artifactId>
        </dependency>
        <!--要打成war包执行，去掉内嵌的tomcat-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
            <scope>provided</scope>
        </dependency>
    </dependencies>
    <build>
        <finalName>webapp-pc</finalName>
    </build>
</project>

我一般喜欢打包成war放到tomcat下运行，不喜欢直接打包成一个富jar执行，所以加入了 spring-boot-legacy依赖，去掉了 spring-boot-starter-tomcat运行依赖。

如果你的servlet容器版本低于2.5，在maven打包war的时候会找不到web.xml而报错，需要在WEB-INF下加入一个空的web.xml：

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">
  <!--

      这个空的xml，为了假装自己是一个web工程，不要在这里写任何东西
  -->
</web-app>

在app启动类里面：

import org.springframework.boot.context.web.SpringBootServletInitializer;

/**
 * Created by XX on 2016/5/2.
 */
@SpringBootApplication
public class App extends SpringBootServletInitializer {

//    private Logger logger = LoggerFactory.getLogger(App.class);

    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(App.class);
    }

    public static void main(String[] args){
        SpringApplication.run(App.class, args);
    }
}

为了打包war包执行，需要继承 SpringBootServletInitializer 。

下面新建一个测试Controller：

package com.cn.controller;

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * Created by XX on 2016/5/2.
 */
@RestController
public class TestController {
    
    @RequestMapping("/test")
    public String test(){
        return "webapp start..";
    }
    
}

最后在tomcat启动该工程,在浏览器访问：http://localhost:8080/webapp-pc/test

因为我打包成war包在自己的tomcat发布，所以工程路径和端口都是以tomcat里面设置的为准。

代码路径： 代码github地址