## 创建第一个API
1. 为了保证工程结构清晰,我们将不同用处的类归并到对应功能描述的`package`中。
2. 创建`API`用到的是`Controller`,所以我们新建一个`controller`的`package`并新建一个`DemoController`的类。
![](https://box.kancloud.cn/300aebaa86009d9aeba42d916d839286_883x331.png)
3. 新建一个最简单的`API`。
![](https://box.kancloud.cn/d0faf13237c7c33e4a2750cf936889b3_406x208.png)
4. `@RestController`注解相当于`@ResponseBody`+`@Controller`合在一起的作用。
5. `@RequestMapping("api")`将当前`DemoController`下的方法增加一个前缀`api`,可以快速定位。
6. 以下代码定义了一个`info`方法,传入name参数,返回`"Hello, My Name Is: " + name`的字符串。
~~~
@GetMapping("info")
public String info(String name) {
return "Hello, My Name Is: " + name;
}
~~~
7. 重启`DemoApplication`或者使用快捷键`Ctrl+F9`重载class,让我们新建的`API`生效
8. 上一章我们以`9101`的端口启动了`blade-demo`,那么要访问这个`API`的话,则地址为:[http://localhost:9101/api/info?name=Chill](http://localhost:9101/api/info?name=Chill)或[http://localhost/blade-demo/api/info?name=Chill](http://localhost/blade-demo/api/info?name=Chill)(推荐使用后一种,通过API 网关,采用负载均衡的算法动态调用名为`blade-demo`的服务)
9. 我们使用[Postman](https://www.getpostman.com/)或者其他api调试工具调用接口查看结果
![](https://img.kancloud.cn/dc/67/dc679566f17caa37e3400ddc6044261a_1295x585.png)
10. 请求成功,但是返回的消息是:`请求未授权`,这是为何?
11. 因为任何一个API,都需要考虑安全性,不能让未授权的请求,调用到受保护的API,那么就需要一个安全框架来支撑。
## API安全框架
* Spring家族有著名的Spring Security,功能非常完善,但SpringBlade准备在集成oauth2的时候再使用这个重量级的家伙,所以现阶段封装了个很简单的安全框架:`Secure`。
* 麻雀虽小五脏俱全,那么下面我们来学习下 API 的鉴权吧!
- 序
- 快速开始
- 环境要求
- 环境准备
- 工程导入
- 工程运行
- 技术基础
- Java8
- Lambda
- Lambda 受检异常处理
- Stream 简介
- Stream API 一览
- Stream API(上)
- Stream API(下)
- Optional 干掉空指针
- 函数式接口
- 新的日期 API
- Lombok
- SpringMVC
- Swagger
- Mybaties
- Mybaties-plus
- 开发初探
- 新建微服务工程
- 第一个API
- API鉴权
- API响应结果
- Redis 缓存
- 第一个CRUD
- 建表
- 建Entity
- 建Service和Mapper
- 新增API
- 修改API
- 删除API
- 查询API
- 单条查询
- 多条查询
- 分页
- 微服务远程调用
- 声明式服务调用Feign
- 熔断机制 Hystrix
- 开发进阶