spring-boot從創建到部署(內含swagger配置)

今天介紹一下spring-boot這個開箱即用的框架，從創建到部署

創建spring-boot項目

• 首先點擊creat new project
  
• 然後點擊spring initializr
  
• 輸入組名和項目名
  
• 選擇web
  
• finsh完成創建
  
• pom.xml配置文件

<?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/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.stalary</groupId>
    <artifactId>createdemo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>

    <name>createdemo</name>
    <description>Demo project for Spring Boot</description>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.9.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <executions>
                    <execution>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

</project>

• 此時會發現在target目錄下有了loginDemo-0.0.1-SNAPSHOT.jar文件
  
• 將這個文件上傳到服務器上，服務器上要確保已經成功安裝jdk。
• 使用nohup java -jar loginDemo-0.0.1-SNAPSHOT.jar即可運行項目(加nohup代表一直執行，不會停止，否則關閉就會停止項目)
• 使用tail -f nohup.out即可查看動態日誌
• 或者使用java -jar loginDemo-0.0.1-SNAPSHOT.jar > log.file 2>&1 &(有時候斷開與服務器連接，項目還是會停止)

如果需要在項目上部署swagger，請看下面的教程

添加swagger2

• 首先在pom.xml中添加兩個依賴

        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.7.0</version>
        </dependency>
                <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.7.0</version>
        </dependency>

• 然後添加一個Sagger2配置類

package com.stalary;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.context.request.async.DeferredResult;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration
@EnableSwagger2
public class Swagger2 {

    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .groupName("demo")
                .genericModelSubstitutes(DeferredResult.class)
                .useDefaultResponseMessages(false)
                .apiInfo(apiInfo())
                .pathMapping("/")
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.stalary.controller"))
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("登陸測試模塊")
                .description("源碼請訪問：https://github.com/stalary/SpringBootDemo")
                .termsOfServiceUrl("stalary.com")
                .version("1.0")
                .build();
    }
}

這時訪問http://120.24.5.178:8100/swagger-ui.html#/即可展示出頁面

• 最後提供一個博主spring-boot的demo
• https://github.com/stalary/SpringBootDemo