引言

我们一直在讲,通过路由传达到控制器,处理好数据并渲染到视图,但是对于现代的应用, 前后端分离的情况下,后端写个接口就完事儿了。




JAVAAPI详解 javaapi接口怎么写_laravel restful


本期为大家说一说用laravel写restful风格的API,看看能有多简单。

以路由开端

写API接口,与传统的渲染前端模板页面有什么区别?少了视图,只需要准备好数据, 并按照规则格式化,返回就可以了。

laravel默认的api接口路由在 routes/api.php


Route


调用了 auth:api

那么这个路由文件,是什么时候加载上去的呢?在文件 app/Providers/RouteServiceProvider.php


protected


该服务提供者声明路由使用 api 字符前缀,并调用 api 中间件,该中间件定义在 app/Http/Kernel.php


protected


至于命名空间 $this->namespace 一般返回 AppHttpControllers,我们为了区分API与其他应用,在目录 app/Http/Controller 下创建 API

那么上述的 RouteServiceProvider.php 文件内 mapApiRoutes 方法内的 namespace


->


仍然以 Event 模型作为示例,在 routes/api.php


Route


注意命名空间上多出来的前缀 API ,这说明我们是把 EventController

用户权限

让我们把目光还聚焦在系统默认声明的那条路由:


Route


注意中间件 auth:api,因为api请求是无状态的,每次请求之间没有任何关联,所以使用用户权限区分资源的返回。那么我们怎么拿到用户授权呢?这在 config/auth.php


'guards'


这一段定义了我们使用何种方式认证用户的身份。默认的驱动 token 定义在框架文件 laravel/framework/src/Illuminate/Auth/TokenGuard.php


UserProvider


简单说,就是使用 users 表的 api_token


php


首先是迁移方法 up


public


还有回滚使用的 down


public


这些都是常规操作,我们在之前的章节,使用了N多次了。执行指令迁移数据库:


php


看看效果

准备好了路由,而且路由内声明了一个get方法返回用户模型数据。也准备好了数据库表字段 api_token。我们在数据库表内找到一个用户数据,把api_token值设置为 1234,用于测试。

现在在浏览器内请求类似如下的url地址:


http://www.example.com/api/user?api_token=1234


如无异常,顺利会输出一个 json 字符串,


{


这个json格式的数据是怎么来的呢?是在路由内,$request->user() 方法返回的User模型,使用 toArray()

特别需要注意的是,关键的密码字段,以及 token 字段,是默认隐藏的,这得益于 User 模型内 $hiden


protected


这些字段都对对外不公开访问。

写在最后

本文介绍了如何声明api地址,已经解释了api从中间件到路由的由来,明白了api授权的方式,可以为我们更灵活地定制授权方式提供便利。这在laravel内都是可插拔的,替换为我们的逻辑代码就可以愉快工作了。

Happy coding :-)