Laravel 5.5中为响应请求提供的可响应接口详解
前言
Laravel5.5也将会是接下来的一个LTS(长期支持)版本。这就意味着它拥有两年修复以及三年的安全更新支持。Laravel5.1也是如此,不过它两年的错误修复支持将在今年结束。
Laravel5.5的路由中增加了一种新的返回类型:可相应接口(Responsable)。该接口允许对象在从控制器或者闭包路由中返回时自动被转化为标准的HTTP响应接口。任何实现Responsable接口的对象必须实现一个名为toResponse()的方法,该方法将对象转化为HTTP响应对象。
看示例:
useIlluminate\Contracts\Support\Responsable; classExampleObjectimplementsResponsable { publicfunction__construct($name=null) { $this->name=$name??'Teapot'; } publicfunctionstatus() { switch(strtolower($this->name)){ case'teapot': return418; default: return200; } } publicfunctiontoResponse() { returnresponse( "Hello{$this->name}", $this->status(), ['X-Person'=>$this->name] ); } }
在路由中使用这个ExampleObject的时候,你可以这样做:
Route::get('/hello',function(){ returnnewExampleObject(request('name')); });
在Laravel框架中,Route类如今可以在准备响应内容时检查这种(实现了Responsable接口的)类型:
if($responseinstanceofResponsable){ $response=$response->toResponse(); }
假如你在App\Http\Responses命名空间下用多个响应类型来组织你的响应内容,可以参考下面这个示例。该示例演示了如何支持Posts(多个实例组成的Collection):
posts=$posts; } publicfunctiontoResponse() { returnresponse()->json($this->transformPosts()); } protectedfunctiontransformPosts() { return$this->posts->map(function($post){ return[ 'title'=>$post->title, 'description'=>$post->description, 'body'=>$post->body, 'published_date'=>$post->published_at->toIso8601String(), 'created'=>$post->created_at->toIso8601String(), ]; }); } }
以上只是一个模拟简单应用场景的基础示例:返回一个JSON响应,但你希望响应层不是简单地用内置实现把对象JSON化,而是要做一些内容处理。以上示例同时假设App\Http\Responses\Response这个类能提供一些基础的功能。当然响应层也可以包含一些转换代码(类似Fractal),而不是直接在控制器里做这样的转换。
与上面示例中的PostIndexResponse类协作的控制器代码类似以下这样:
如果你想了解更多有关这个接口的细节,可以查看项目中相关代码的commit.
总结
以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,如果有疑问大家可以留言交流,谢谢大家对毛票票的支持。