第八节 后台服务初始化

本节,我们将创建后台服务,开始后台代码的编写。

创建maven项目

前面我们已经知道了 maven 这个神奇的小东西,接下来我们就来创建一个依赖于maven的项目。

新建api文件夹

在项目的根目录下新建一个文件夹,命名为 api

api

打开IDEA

idea

创建maven项目

选择 Create new project ,然后在左侧选择 Maven

maven

什么也不要点,直接点击 Next 下一步。

name

GroupId 里输入 com.mengyunzhi ,在 ArtifactId 里输入 angularjs-spring-mvc 。这里直接按照我们的教程命名,后面我会简单介绍这两个名称。

下一步。

location

修改一下我们的项目路径 project location ,将项目放到我们刚刚新建的 api 文件夹下。比如我的放置到了 /home/poshichao/project/spring-test/angularJS-Spring-MVC/project/api, 最后Finish 完成。

<?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.mengyunzhi</groupId>
    <artifactId>angularjs-spring-mvc</artifactId>
    <version>1.0-SNAPSHOT</version>

</project>

点击Finish 后,我们可以看到IDEA为我们自动创建了如上的xml代码。

import

我们会发现在右下脚出现一个小提示框,它说maven项目需要导入,我们选择第二个 Enable Auto-Import 。这样,下次就不需要我们手动导入maven依赖了,IDEA会为我们自动完成。

点开左侧的 api

tree

对照一下你的项目结构。一开始最好保持与我们的目录结构一致,随着你对项目的熟悉,就可以按照自己的想法创建你的目录结构了。OK!到这里,我们的maven项目已经建好了。

配置pom.xml

maven项目创建好后,我们就要开始配置一下IDEA为我们创建的 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.mengyunzhi</groupId>
    <artifactId>angularjs-spring-mvc</artifactId>
    <version>1.0-SNAPSHOT</version>

    <!-- 继承org.springframework.boot组织下的spring-boot-starter-parent项目 -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.8.RELEASE</version>
    </parent>

    <dependencies>
        <!--spring-boot框架下的web项目依赖-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <!--spring-boot 单元测试依赖-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>

    </dependencies>

    <properties>
        <!--jdk版本-->
        <java.version>1.8</java.version>
    </properties>


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

    <repositories>
        <repository>
            <id>spring-releases</id>
            <url>https://repo.spring.io/libs-release</url>
        </repository>
    </repositories>
    <pluginRepositories>
        <pluginRepository>
            <id>spring-releases</id>
            <url>https://repo.spring.io/libs-release</url>
        </pluginRepository>
    </pluginRepositories>
</project>

刚开始我们并不需要知道上面的代码具体都是干什么的,简单了解,然后直接复制到你的文件中就可以了。

下面我来简单介绍一下上面的几个标签。

groupId: 组织名。

artifactId: 项目名。每个组织中,项目名都是唯一的。

这两条信息就像一个坐标,它能帮助别人找到我们的项目,加以依赖。

version: 版本信息。

parent: 继承。我们建立的项目是继承了spring的框架。

dependencies和dependency: 注入依赖。这里面添加我们的项目依赖。<dependency> 里写入需要依赖的信息,然后都放入到 <dependencies> 中。以后我们还会添加很多依赖,都会以这种形式添加到项目中。

我们现在添加了两个依赖,第一个是spring框架下的web项目依赖,第二个是spring的单元测试的依赖,这个我们后面会接触到。

其余的我们现在不用知道,相信随着学习的深入,你会对它们的作用有更好的了解。

创建启动项

新建文件

右键 java ,新建一个 com.mengyunzhi 包,然后在 com.mengyunzhi 中新建一个 Application 的类。

app

编写启动项

打开 Application,复制下面的代码。

package com.mengyunzhi;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

// @SpringBootApplication是一个springBoot启动项注解,整个项目会从这里开始执行。
@SpringBootApplication
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}
在springMVC项目中我们将大量使用以 "@" 注解来进行声明。

启动项目

点击左侧绿色的小三角,来启动我们的项目。

start

看到我们的控制台出现这样的信息,就说明我们的项目已经成功启动。

helloworld

新建文件

com.mengyunzhi 下新建 controller 包,然后在 controller 包下新建 HelloWorld 类。

Hello

Helloworld.java

package com.mengyunzhi.controller;

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

/**
 * HelloWorld控制器
 * 2017-10-26
 * design by Poshichao
 */

// @RestController注解,声明这是一个spring-boot创建的Rest控制器(支持前后台分离)
@RestController
public class HelloWorld {
    // @RequestMapping注解,用来设置路由
    @RequestMapping("/helloWorld")
    public String say() {
        return "hello world api";
    }
}

复制上面的代码。

启动

重启项目。这次我们可以点右上角的绿色三角。

restart

查看控制台,看看有没有报错。

测试

在IDEA上方菜单,找到 Tools ,选择 Test RESTful Web Service,打开。

test

Host/port 改成 http://localhost:8080,在 Path 中写上 helloWorld,就是我们刚刚在控制器中设置好的路径, 点击左侧的绿色三角。然后就看到控制台中出现了我们期待的 hello world api

到此为止,我们的项目已经创建完毕。

查看示例代码

git checkout -f 3.2.8-api-init

官方参考文档:http://spring.io/guides/gs/rest-service/

作者:朴世超

results matching ""

    No results matching ""