Spring Boot 2.0 (Ⅰ) Getting Started

灰太狼 2022-05-19 14:28 169阅读 0赞

# Spring Boot 2.0 (Ⅰ) Getting Started #

*  Spring Boot 2.0 (Ⅰ) Getting Started
    
     *  系统和环境
     *  github
     *  Maven 依赖
        
         *  parent
         *  dependencyManagement
         *  Spring Boot CLI
            
             *  安装
             *  简单使用
     *  如何运行
     *  升级

## 系统和环境 ##

> 行内代码修饰的是本系列使用的环境

*  `Windows10`
 *  `Spring Boot 2.0.3.RELEASE`
 *  `Java8`\+
 *  `Spring Framework 5.0.7.RELEASE`\+
 *  Maven 3.2+`(Maven 3.5)`/Gradle 4+
 *  Tomcat 8.5+`(spring boot default)`/Jetty 9.4+/Undertow 1.4+/任何一个兼容Servlet 3.1+的容器

## github ##

[spring-boot-demo][]

## Maven 依赖 ##

### parent ###

<?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">
        <parent>
            <artifactId>spring-boot-demo</artifactId>
            <groupId>github.clyoudu.spring.boot</groupId>
            <version>1.0-SNAPSHOT</version>
        </parent>
        <modelVersion>4.0.0</modelVersion>
    
        <artifactId>spring-boot-maven-install</artifactId>
    
        <name>spring-boot-maven-install</name>
        <url>http://www.example.com</url>
    
        <properties>
            <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
            <maven.compiler.source>1.8</maven.compiler.source>
            <maven.compiler.target>1.8</maven.compiler.target>
        </properties>
    
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
            </dependency>
        </dependencies>
    
    </project>

### dependencyManagement ###

<?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>
    
        <artifactId>spring-boot-maven-install2</artifactId>
    
        <name>spring-boot-maven-install2</name>
        <url>http://www.example.com</url>
    
        <properties>
            <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
            <maven.compiler.source>1.8</maven.compiler.source>
            <maven.compiler.target>1.8</maven.compiler.target>
        </properties>
    
        <dependencyManagement>
            <dependencies>
                <dependency>
                    
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-dependencies</artifactId>
                    <version>2.0.3.RELEASE</version>
                    <type>pom</type>
                    <scope>import</scope>
                </dependency>
            </dependencies>
        </dependencyManagement>
    
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
            </dependency>
        </dependencies>
    </project>

### Spring Boot CLI ###

> Spring Boot Command Line Interface，只考虑在Windows上的安装、配置和使用。

#### 安装 ####

下载地址：[spring-boot-cli-2.0.3.RELEASE-bin.zip][]。

解压。

添加环境变量：`SPRING_PATH=/path/to/sring/boot/root/dir`。

编辑`PATH`环境变量，末未添加：`%SPRING_HOME%\bin`。

验证：`cmd -> spring --version -> Spring CLI v2.0.3.RELEASE`。

#### 简单使用 ####

对于熟悉`spring boot`的选手来说，这个工具略显鸡肋，但是对于初次学习的人来说，可以快速初始化一个项目，也可以很快打包、启动一个`spring boot`项目。

1.  写一个正常的`SpringMVC Controller`：
    
        package github.clyoudu.spring.boot;
        
        import org.springframework.web.bind.annotation.PathVariable;
        import org.springframework.web.bind.annotation.RequestMapping;
        import org.springframework.web.bind.annotation.RestController;
        
        /** * Hello world! */
        @RestController
        public class App { 
        
            @RequestMapping("/{name}")
            public String hello(@PathVariable(value = "name") String name){
                return "Hello " + name;
            }
        
        }
2.  打开命令提示符窗口；
3.  切换工作目录到`Controller`对应目录；
4.  执行命令：`sping run App.java`，等待控制抬输出启动成功消息；
5.  浏览器输入`http://localhost:8080/clyoudu`；
6.  页面显示：`Hello clyoudu`。

很明显，就样可以快速构建一个`spring boot`项目。当然这并不是`CLI`唯一的功能，还有跟多高级的功能，比如打包、初始化项目等。

详见：[新手必看，Spring Boot CLI 必会必知][Spring Boot CLI]

## 如何运行 ##

开发的时候，直接写一个包含`main`方法的类，加上`SpringBootApplication`注解，`mian`方法内调用`SpringApplication.run(App.class,args);`即可：

package github.clyoudu.spring.boot;
    
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    
    /** * Hello world! */
    @SpringBootApplication
    public class App { 
        public static void main(String[] args) {
            SpringApplication.run(App.class,args);
        }
    }

然后`run`这个类就能启动，但是注意这个类最好写在所有包的最外层，以便于`spring boot`扫描组件、配置。

当需要打包到不同的环境运行时，可以使用`maven`插件打包，先添加插件：

<build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

然后运行命令：`mvn -DskipTests=true package`，在`target`文件夹就可以找到`your-project-name-1.0-SNAPSHOT.jar`，最后使用`java -jar your-project-name-1.0-SNAPSHOT.jar`就可以启动，当然这里有一些参数可以配置，比如使用哪个`profile`，后面再记录。

## 升级 ##

因为`spring boot 1.x`和`spring boot 2.x`差别较大，几乎不能直接从`1.x`升级到`2.x`，因此对于升级，`sring boot`有一套专门的解决方案，这里不考虑升级的情况。

详见：[Spring Boot 2.0 Migration Guide][]

[spring-boot-demo]: https://github.com/clyoudu/spring-boot-demo
[spring-boot-cli-2.0.3.RELEASE-bin.zip]: https://repo.spring.io/release/org/springframework/boot/spring-boot-cli/2.0.3.RELEASE/spring-boot-cli-2.0.3.RELEASE-bin.zip
[Spring Boot CLI]: https://www.bysocket.com/?p=1982
[Spring Boot 2.0 Migration Guide]: https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-2.0-Migration-Guide