Spring Boot 构建一个 RESTful Web Service
2018-04-12 15:23 Spring.Guo 阅读(1306) 评论(0) 编辑 收藏 举报1 项目目标:
构建一个 web service,接收get 请求
http://localhost:8080/greeting
响应一个json 结果:
{"id":1,"content":"Hello, World!"}
可以在请求中添加自定义参数name
http://localhost:8080/greeting?name=User
响应结果:
{"id":1,"content":"Hello, User!"}
2 环境准备:
1) 开发工具 IntelliJ IDEA (自己下载安装) cdkey 网上找吧。
2) JAVA JDK1.8+ (http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) // 本示例是用的 jdk1.8.0_172 Windows x64
2).1 配置 JDK 环境变量。 http://www.cnblogs.com/iampkm/p/8805493.html
根据JDK 的安装路径,在系统环境变量中配置 (JAVA_HOME,PATH,CLASSPATH)
3) 配置Maven 3.2+ 下载:https://maven.apache.org/download.cgi (我用的是3.5)
3).1 新建本地库目录repository (位置可以随意)。我是在apache-maven-3.5.2 目录下 创建的。
3) .2 settings.xml 中 配置本地库 。打开maven 目录下的 conf/settings.xml 文件,修改自己的库目录
3).3 settings.xml 中修改maven镜像下载地址为淘宝,在配置文件中,加入红色代码部分
<mirrors>
<!-- mirror
| Specifies a repository mirror site to use instead of a given repository. The repository that
| this mirror serves has an ID that matches the mirrorOf element of this mirror. IDs are used
| for inheritance and direct lookup purposes, and must be unique across the set of mirrors.
|
<mirror>
<id>mirrorId</id>
<mirrorOf>repositoryId</mirrorOf>
<name>Human Readable Name for this Mirror.</name>
<url>http://my.repository.com/repo/path</url>
</mirror>
-->
<mirror>
<id>alimaven</id>
<name>aliyun maven</name>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
<mirrorOf>central</mirrorOf>
</mirror>
</mirrors>3) .4在idea 中,把maven 改成本地位置。 打开Idea ,选择File > Settings > 按照如下图配置 本地maven 的三个位置即可。
3 新建项目greeting。 启用spring boot 初始化
输入项目名,我本地取名 quickstart
选择web
创建一个资源 java 类 model
Create a resource representation class
Now that you’ve set up the project and build system, you can create your web service.
Begin the process by thinking about service interactions.
The service will handle GET
requests for /greeting
, optionally with a name
parameter in the query string. The GET
request should return a 200 OK
response with JSON in the body that represents a greeting. It should look something like this:
package com.example.qucikstart; public class Greeting { private final long id; private final String content; public Greeting(long id, String content) { this.id = id; this.content = content; } public long getId() { return id; } public String getContent() { return content; } } |
这个就是返回的结果内: 该类在返回时,会自动被转换成json格式
|
创建一个java 控制类 GreetingController
Create a resource controller
In Spring’s approach to building RESTful web services, HTTP requests are handled by a controller. These components are easily identified by the @RestController
annotation, and the GreetingController
below handles GET
requests for /greeting
by returning a new instance of the Greeting
class:
package com.example.qucikstart; import java.util.concurrent.atomic.AtomicLong; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.RestController; @RestController public class GreetingController { private static final String template ="hello,%s!"; private final AtomicLong counter = new AtomicLong(); @RequestMapping("/Greeting") public Greeting greeting(@RequestParam(value="name",defaultValue="world") String name) { return new Greeting(counter.incrementAndGet(), String.format(template, name)); } } |
This controller is concise and simple, but there’s plenty going on under the hood. Let’s break it down step by step.
The @RequestMapping
annotation ensures that HTTP requests to /greeting
are mapped to the greeting()
method.
当请求 RequestMapping 注解会把 greeting 的请求,映射到 greeting 方法。
确保main 程序用springboot 启动
Make the application executable
Although it is possible to package this service as a traditional WAR file for deployment to an external application server, the simpler approach demonstrated below creates a standalone application. You package everything in a single, executable JAR file, driven by a good old Java main()
method. Along the way, you use Spring’s support for embedding the Tomcat servlet container as the HTTP runtime, instead of deploying to an external instance.
package com.example.qucikstart; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; @SpringBootApplication public class QucikstartApplication { public static void main(String[] args) { SpringApplication.run(QucikstartApplication.class, args); } } |
项目结构:
最后执行:
1 ctrl+F9 编译,确保程序无错误。
2 Shift+F10 启动程序
Now that the service is up, visit http://localhost:8080/greeting, where you see:
使用 name 参数
http://localhost:8080/greeting?name=java
到此,java spring boot hello 就搞定了。
参考spring boot 官方文档资料链接:https://spring.io/guides/gs/rest-service/
-----------------------------------------------------------------
8080 端口占用解决办法:
打开命令窗口,输入 netstat –ano
打开任务管理器,找到1572PID 的任务,关掉