转载

通过springBoot构建一个简单的Restful webService

1.登录网站 https://start.spring.io/ ,生成一个基本的SpringBoot应用。

通过springBoot构建一个简单的Restful webService

2.将应用导入Eclipse IDE。目录结构如下:

通过springBoot构建一个简单的Restful webService

3.由于生成的是Maven Project,需要提前安装好Maven工具。并将Maven中央仓库配置为可以访问到的地址,如果遇到“无法从远程仓库“ https://repo.maven.apache.org... ”下载插件”错误,可以参考如下链接解决。

http://blog.csdn.net/wusunshi...

4.编写domain类

package com.example.domain;
public class Phone {
    private String phoneName;
    private String phoneNumber;
    public String getPhoneName() {
        return phoneName;
    }
    public void setPhoneName(String phoneName) {
        this.phoneName = phoneName;
    }
    public String getPhoneNumber() {
        return phoneNumber;
    }
    public void setPhoneNumber(String phoneNumber) {
        this.phoneNumber = phoneNumber;
    }
}

5.编写controller类

package com.example.controller;
import java.util.HashMap;
import java.util.Map;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping(value="/phone")
public class PhoneController {
    
    @RequestMapping
    public String index(){
        return "Hello World!";
    }
    
    @RequestMapping(value="/getmap")
    public Map<String,String> getMap(){
        Map<String,String> phoneMap = new HashMap<String,String>();
        phoneMap.put("name", "apple phone");
        phoneMap.put("money", "5000");
        return phoneMap;
    }
}

6.Pom.xml配置如下,增加对“spring-boot-starter-web”依赖。

<?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.example</groupId>
    <artifactId>demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>

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

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.1.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</artifactId>
        </dependency>
        
        <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>
            </plugin>
        </plugins>
    </build>
</project>

7.目录结果如下:

通过springBoot构建一个简单的Restful webService

8.执行main函数,启动SpringBoot应用,打印如下日志,表示内置的tomcat启动且新增加的WebService服务地址已经载入。

通过springBoot构建一个简单的Restful webService

9.使用postman进行restful客户端请求。方法为GET,URL为 http://localhost:8080/phone/g... ,正确返回了Response。

通过springBoot构建一个简单的Restful webService

10.如果你的应用涉及到数据库,需要在pom.xml中增加对数据库服务的访问包。

<dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>
        <dependency>
          <groupId>mysql</groupId>
          <artifactId>mysql-connector-java</artifactId>
        </dependency>

11.配置application.properties文件

spring.datasource.url=jdbc:mysql://127.0.0.1:3306/demo_test
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.username=root
spring.datasource.password=root

12.本地需要正确安装了mysql数据库server,且存在demo_test这个database。

通过springBoot构建一个简单的Restful webService

13.重新运行main函数启动SpringBoot应用。启动正常。

通过springBoot构建一个简单的Restful webService

14.在实际操作过程中遇到一个问题:

启动SpringBoot应用以后,新增的WebService服务地址一直无法访问,报错如下:

通过springBoot构建一个简单的Restful webService

后查看启动过程,未加载新增的WebService服务地址/phone、/phone/getmap

通过springBoot构建一个简单的Restful webService

究其原因,原来是将main函数类DemoApplication放到了和controller和domain目录同级目录的app目录下面,导致@SpringBootApplication注解自动扫描的作用没法扫描到本目录和子目录下的注解类。目录结构如下:

通过springBoot构建一个简单的Restful webService

将DemoApplication.java类放置到com.example下面,重新启动SpringBoot应用,一切正常。

通过springBoot构建一个简单的Restful webService

至此,一个简单的基于SpringBoot的Restful WebService搭建完成。

原文  https://segmentfault.com/a/1190000008327663
正文到此结束
Loading...