国产xxxx99真实实拍_久久不雅视频_高清韩国a级特黄毛片_嗯老师别我我受不了了小说

資訊專欄INFORMATION COLUMN

如何基于 Notadd 構(gòu)建 API (Laravel 寫 API)

megatron / 1295人閱讀

摘要:例如,為前兩個(gè)提供跨域的功能實(shí)現(xiàn),代碼參考如下控制器由于有了獨(dú)立的處理器,控制器層可以制作簡(jiǎn)單處理,僅需向控制器注入,并由提供的輔助方法返回?cái)?shù)據(jù)給前臺(tái),即可。

如何基于 Notadd 構(gòu)建 API

Notadd 底層實(shí)現(xiàn)了 passport 機(jī)制,有統(tǒng)一的授權(quán)管理,主要支持兩種方式進(jìn)行 API 授權(quán),一個(gè)是 client,領(lǐng)一個(gè)是 passport,這個(gè)在其他文檔中有做詳細(xì)的說明。

這里主要說的是,如何基于 Notadd 進(jìn)行 API 接口的開發(fā)。

業(yè)務(wù)邏輯

熟悉 Laravel 的同學(xué)都應(yīng)該知道,Laravel 遵循這樣的業(yè)務(wù)邏輯實(shí)現(xiàn):

路由(route) -> 控制器(controller) -> 業(yè)務(wù)邏輯(model) -> 數(shù)據(jù)輸出(view)

而 Notadd 的 API 業(yè)務(wù)邏輯實(shí)現(xiàn)同樣遵循類似的流程:

路由(route) -> 控制器(controller) -> API 處理器(handler) -> 模型(model) -> 數(shù)據(jù)輸出(json)

其中,主要的差異在于,API 處理器提供了對(duì)數(shù)據(jù)輸出格式的輸出,返回的數(shù)據(jù)格式統(tǒng)一為:

[
    "code" => 200,             // API 接口返回的狀態(tài)碼,默認(rèn)為 200
    "data" => [],              // API 接口返回的數(shù)據(jù),主要為數(shù)組形式
    "message" => "success!",  // API 接口返回的提示信息,可以包含錯(cuò)誤信息或成功信息
]
路由

Notadd 在實(shí)現(xiàn) API 授權(quán)的時(shí)候,使用的是有 路由中間件(middleware) 的方式來實(shí)現(xiàn)的。

具體實(shí)現(xiàn)方式,是在路由的中間配置參數(shù)中添加 auth:api

例如,在實(shí)現(xiàn) api/setting/all 和 api/setting/set 兩個(gè) API 的時(shí)候,添加 auth:api 的中間件,代碼參考如下:

$this->router->group(["middleware" => ["auth:api", "web"], "prefix" => "api/setting"], function () {
    $this->router->post("all", "NotaddFoundationSettingControllersSettingController@all");
    $this->router->post("set", "NotaddFoundationSettingControllersSettingController@set");
});

Notadd 針對(duì)需要跨域的 API 還提供了 cross 的路由中間件,以實(shí)現(xiàn) API 跨域的功能。

例如,為前兩個(gè) API 提供跨域的功能實(shí)現(xiàn),代碼參考如下:

$this->router->group(["middleware" => ["auth:api", "cross", "web"], "prefix" => "api/setting"], function () {
    $this->router->post("all", "NotaddFoundationSettingControllersSettingController@all");
    $this->router->post("set", "NotaddFoundationSettingControllersSettingController@set");
});
控制器

由于有了獨(dú)立的 API處理器 ,控制器層可以制作簡(jiǎn)單處理,僅需向控制器注入 handler,并由 handler 提供的輔助方法返回 API 數(shù)據(jù)給前臺(tái),即可。

例如,在前面路由調(diào)用的 SettingController 中,僅需要注入 AllHandler ,使用方法 toResponse 和 generateHttpResponse 來返回結(jié)果給前臺(tái),代碼參考如下:


 * @copyright (c) 2016, iBenchu.org
 * @datetime 2016-11-08 17:01
 */
namespace NotaddFoundationSettingControllers;

use NotaddFoundationRoutingAbstractsController;
use NotaddFoundationSettingContractsSettingsRepository;
use NotaddFoundationSettingHandlersAllHandler;
use NotaddFoundationSettingHandlersSetHandler;

/**
 * Class SettingController.
 */
class SettingController extends Controller
{
    /**
     * @var NotaddFoundationSettingContractsSettingsRepository
     */
    protected $settings;

    /**
     * SettingController constructor.
     *
     * @param NotaddFoundationSettingContractsSettingsRepository $settings
     *
     * @throws IlluminateContractsContainerBindingResolutionException
     */
    public function __construct(SettingsRepository $settings)
    {
        parent::__construct();
        $this->settings = $settings;
    }

    /**
     * All handler.
     *
     * @param NotaddFoundationSettingHandlersAllHandler $handler
     *
     * @return NotaddFoundationPassportResponsesApiResponse
     * @throws Exception
     */
    public function all(AllHandler $handler)
    {
        return $handler->toResponse()->generateHttpResponse();
    }

    /**
     * Set handler.
     *
     * @param NotaddFoundationSettingHandlersSetHandler $handler
     *
     * @return NotaddFoundationPassportResponsesApiResponse
     * @throws Exception
     */
    public function set(SetHandler $handler)
    {
        return $handler->toResponse()->generateHttpResponse();
    }
}
API Handler 和模型

在 API Handler中提供了模型的操作接口。

在 Notadd 中,提供了兩類 API Handler,一類是 DataHandler,另一類是 SetHandler,顧名思義,DataHandler 僅提供數(shù)據(jù)返回接口,而 SetHandler 不僅提供數(shù)據(jù)返回接口,還提供其他操作處理的接口。

具體差異體現(xiàn)在,DataHandler 在返回?cái)?shù)據(jù)接口時(shí)僅調(diào)用方法 data,而 SetHandler 在調(diào)用 data 方法前還有調(diào)用 execute 方法。

例如,在前面的 SettingController 中使用的 AllHandler 為 DataHandler 類 Handler,提供返回所有 配置項(xiàng) 的 API 功能,SetHandler 為 SetHandler 類 Handler,提供 修改配置項(xiàng) 并返回所有 配置項(xiàng) 的 API 功能。

AllHandler 的代碼如下:


 * @copyright (c) 2016, iBenchu.org
 * @datetime 2016-11-23 14:44
 */
namespace NotaddFoundationSettingHandlers;

use IlluminateContainerContainer;
use NotaddFoundationPassportAbstractsDataHandler;
use NotaddFoundationSettingContractsSettingsRepository;

/**
 * Class AllHandler.
 */
class AllHandler extends DataHandler
{
    /**
     * @var NotaddFoundationSettingContractsSettingsRepository
     */
    protected $settings;

    /**
     * AllHandler constructor.
     *
     * @param IlluminateContainerContainer                         $container
     * @param NotaddFoundationSettingContractsSettingsRepository $settings
     */
    public function __construct(
        Container $container,
        SettingsRepository $settings
    ) {
        parent::__construct($container);
        $this->settings = $settings;
    }

    /**
     * Http code.
     *
     * @return int
     */
    public function code()                                                 // 定義 API 操作結(jié)果的狀態(tài)碼
    {
        return 200;
    }

    /**
     * Data for handler.
     *
     * @return array
     */
    public function data()                                                  // 定義 API 返回的數(shù)據(jù)
    {
        return $this->settings->all()->toArray();
    }

    /**
     * Errors for handler.
     *
     * @return array
     */
    public function errors()                                                // 定義 API 操作失敗時(shí)返回的信息
    {
        return [
            "獲取全局設(shè)置失敗!",
        ];
    }

    /**
     * Messages for handler.
     *
     * @return array
     */
    public function messages()                                             // 定義 API 操作成功時(shí)返回的信息
    {
        return [
            "獲取全局設(shè)置成功!",
        ];
    }
}

SetHandler 的代碼如下:


 * @copyright (c) 2016, iBenchu.org
 * @datetime 2016-11-23 15:09
 */
namespace NotaddFoundationSettingHandlers;

use IlluminateContainerContainer;
use NotaddFoundationPassportAbstractsSetHandler as AbstractSetHandler;
use NotaddFoundationSettingContractsSettingsRepository;

/**
 * Class SetHandler.
 */
class SetHandler extends AbstractSetHandler
{
    /**
     * @var NotaddFoundationSettingContractsSettingsRepository
     */
    protected $settings;

    /**
     * SetHandler constructor.
     *
     * @param IlluminateContainerContainer                         $container
     * @param NotaddFoundationSettingContractsSettingsRepository $settings
     */
    public function __construct(
        Container $container,
        SettingsRepository $settings
    ) {
        parent::__construct($container);
        $this->settings = $settings;
    }

    /**
     * Data for handler.
     *
     * @return array
     */
    public function data()                                                                    // 定義 API 返回的數(shù)據(jù)
    {
        return $this->settings->all()->toArray();
    }

    /**
     * Errors for handler.
     *
     * @return array
     */
    public function errors()                                                                  // 定義 API 操作失敗時(shí)返回的信息
    {
        return [
            "修改設(shè)置失敗!",
        ];
    }

    /**
     * Execute Handler.
     *
     * @return bool
     */
    public function execute()                                                                 // 定義 API 執(zhí)行的修改操作
    {
        $this->settings->set("site.enabled", $this->request->input("enabled"));
        $this->settings->set("site.name", $this->request->input("name"));
        $this->settings->set("site.domain", $this->request->input("domain"));
        $this->settings->set("site.beian", $this->request->input("beian"));
        $this->settings->set("site.company", $this->request->input("company"));
        $this->settings->set("site.copyright", $this->request->input("copyright"));
        $this->settings->set("site.statistics", $this->request->input("statistics"));

        return true;
    }

    /**
     * Messages for handler.
     *
     * @return array
     */
    public function messages()                                                                // 定義 API 操作成功時(shí)返回的信息
    {
        return [
            "修改設(shè)置成功!",
        ];
    }
}
數(shù)據(jù)輸出

API 結(jié)果的數(shù)據(jù)輸出,已經(jīng)在 控制器(controller) 中做了處理。

至此,一個(gè)完整的 API 開發(fā)完成。

文章版權(quán)歸作者所有,未經(jīng)允許請(qǐng)勿轉(zhuǎn)載,若此文章存在違規(guī)行為,您可以聯(lián)系管理員刪除。

轉(zhuǎn)載請(qǐng)注明本文地址:http://specialneedsforspecialkids.com/yun/22972.html

相關(guān)文章

  • 造個(gè)輪子,基于 Laravel5.4 的下一代 PHP 開發(fā)框架 (API/SPA/Vue2/iVi

    摘要:像操作系統(tǒng)一樣,你可以通過安裝軟件,成為適用于你的電腦。先進(jìn)的技術(shù)方案,使得你無需擔(dān)心后期功能拓展與迭代問題,大大降低了維護(hù)成本。對(duì)于一個(gè)超過三年生命周期的項(xiàng)目來說,最適合不過。總之,是新的技術(shù)方向標(biāo),能讓每個(gè)藝術(shù)家像構(gòu)建工程一樣構(gòu)建程序。 這是我們團(tuán)隊(duì)的一個(gè)非盈利項(xiàng)目,以Apache2.0協(xié)議開源...不限制商用 Notadd是什么 Notadd 是基于Laravel 和 Vue 的...

    Rocture 評(píng)論0 收藏0
  • 基于 Laravel 的模塊化開發(fā)框架 Notadd RC1 fix1 發(fā)布

    摘要:目前默認(rèn)使用了包,所以無需拓展。簡(jiǎn)單的消息隊(duì)列隊(duì)列為不同的后臺(tái)隊(duì)列服務(wù)提供統(tǒng)一的,例如,,,甚至其他基于關(guān)系型數(shù)據(jù)庫的隊(duì)列。隊(duì)列的目的是將耗時(shí)的任務(wù)延時(shí)處理,比如發(fā)送郵件,從而大幅度縮短請(qǐng)求和相應(yīng)的時(shí)間。 更新內(nèi)容 修復(fù)長時(shí)間沒訪問后登錄后臺(tái)空白的BUG (@1459416736) 修復(fù)部分后臺(tái) server error 問題 (@1459416736) 增加 win 下 exten...

    Ryan_Li 評(píng)論0 收藏0
  • 基于 Laravel 的模塊化開發(fā)框架 Notadd RC1 發(fā)布

    摘要:目前默認(rèn)使用了包,所以無需拓展。簡(jiǎn)單的消息隊(duì)列隊(duì)列為不同的后臺(tái)隊(duì)列服務(wù)提供統(tǒng)一的,例如,,,甚至其他基于關(guān)系型數(shù)據(jù)庫的隊(duì)列。隊(duì)列的目的是將耗時(shí)的任務(wù)延時(shí)處理,比如發(fā)送郵件,從而大幅度縮短請(qǐng)求和相應(yīng)的時(shí)間。下載地址地址地址 更新內(nèi)容 修復(fù)了首頁編輯模式下滾動(dòng)的BUG (@Eleven) 修復(fù)了后臺(tái)菜單管理修改后不跳轉(zhuǎn)的BUG (@ganlanshu0211) 修復(fù)后臺(tái) ESLint 的...

    eccozhou 評(píng)論0 收藏0
  • Notadd Beta2 fix1 發(fā)布 基于Laravel的下一代PHP開發(fā)框架

    摘要:先進(jìn)的技術(shù)方案,使得你無需擔(dān)心后期功能拓展與迭代問題,大大降低了維護(hù)成本。對(duì)于一個(gè)超過三年生命周期的項(xiàng)目來說,最適合不過。 Notadd是什么 Notadd 是基于 Laravel 和 Vue 的開源 PHP 框架, 由于其本身的靈活性和先進(jìn)的技術(shù)架構(gòu),使得你通過模塊(主功能)、插件(功能增強(qiáng))、模板(前端樣式)像搭積木一樣組合成你想要的,能夠快速完成商城、CMS、微信、論壇的開發(fā)。 ...

    firim 評(píng)論0 收藏0
  • 基于 Laravel 的模塊化開發(fā)框架 Notad Beta5 fix2

    摘要:目前默認(rèn)使用了包,所以無需拓展。簡(jiǎn)單的消息隊(duì)列隊(duì)列為不同的后臺(tái)隊(duì)列服務(wù)提供統(tǒng)一的,例如,,,甚至其他基于關(guān)系型數(shù)據(jù)庫的隊(duì)列。隊(duì)列的目的是將耗時(shí)的任務(wù)延時(shí)處理,比如發(fā)送郵件,從而大幅度縮短請(qǐng)求和相應(yīng)的時(shí)間。 更新 添加單元測(cè)試代碼 添加功能測(cè)試代碼 重構(gòu) JWT 驗(yàn)證機(jī)制 修正安裝時(shí)對(duì)數(shù)據(jù)庫及Redis連接、賬號(hào)和密碼的驗(yàn)證 擴(kuò)展 MIME 類型,使返回的文件頭信息正常 優(yōu)化后臺(tái)導(dǎo)航欄...

    whidy 評(píng)論0 收藏0

發(fā)表評(píng)論

0條評(píng)論

最新活動(dòng)
閱讀需要支付1元查看
<