magento webapi 接口返回 json对象

news/2024/4/27 11:42:48/文章来源:https://blog.csdn.net/FateDant/article/details/130326216

前言

现在主流的项目开发都是前后端分离，数据通过json对象格式进行传输。但是magento框架，和传统PHP框架相比，区别很大。虽然也支持以RestApi的形式传输数据，但是要么格式并非是传统jsonObject要么就是需要大量的get、set方法。本文就是在此基础上使用插件对原来的数据返回进行了封装，实现了接口可以返回json对象。

前置条件（创建一个可供访问的接口模块）

自定义创建一个模块，并在模块下面创建访问的包

模块： /app/code/Mageplaza （路径固定，名称随便取）
包：/app/code/Mageplaza/JsonReturn

在这里插入图片描述

定义接口

创建接口文件：/app/code/Mageplaza/JsonReturn/Api/JsonDataInterface (路径固定，名字随便起) 一定得是interface文件

在这里插入图片描述

创建路由

定义di配置文件、webapi 配置文件和 module配置文件

在这里插入图片描述
di.xml

<?xml version="1.0" ?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd"><preference for="Mageplaza\JsonReturn\Api\JsonDataInterface" type="Mageplaza\JsonReturn\Model\ReturnJson"/>
</config>

module.xml

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd"><module name="Mageplaza_JsonReturn" setup_version="1.0.0"></module>
</config>

webapi.xml

<?xml version="1.0" ?>
<routes xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Webapi:etc/webapi.xsd"><route method="GET" url="/V1/json-return"><service class="Mageplaza\JsonReturn\Api\JsonDataInterface" method="returnJsonData"/><resources><resource ref="anonymous"/></resources></route>
</routes>

定义模型用来实现接口

Model：/app/code/Mageplaza/JsonReturn/Model/ReturnJson

<?phpnamespace Mageplaza\JsonReturn\Model;use Mageplaza\JsonReturn\Api\JsonDataInterface;class ReturnJson implements JsonDataInterface
{/*** @inheritDoc*/public function returnJsonData(){return ['item' =>[['name' => '蔡徐坤', 'age' => 234,'hobby' => ['key' => '唱', '跳', 'rap', '篮球']],['name' => '坤坤', 'age' => 124,'hobby' => ['key' => '说唱', '跳高', 'rap', '篮球']],],'msg' => '提示信息','code' => 200];}
}

定义注册文件（必须要固定的）

/app/code/Mageplaza/JsonReturn/registration.php

<?php
\Magento\Framework\Component\ComponentRegistrar::register(\Magento\Framework\Component\ComponentRegistrar::MODULE,'Mageplaza_JsonReturn',__DIR__
);

运行发现问题

前置条件创建完成后，清楚缓存，进行升级，在postman进行访问

php bin/magento s:up

在post进行访问

http://{{host}}/rest/V1/json-return  访问api 路径前面需要带上rest

想要的格式是这样的

{"item": [{"name": "蔡徐坤","age": 234,"hobby": {"key": "唱","0": "跳","1": "rap","2": "篮球"}},{"name": "坤坤","age": 124,"hobby": {"key": "说唱","0": "跳高","1": "rap","2": "篮球"}}],"msg": "提示信息","code": 200
}

但最后的结果是这样的
在这里插入图片描述
item、msg、code 属性统统消失。前端肯定没法处理这种数据。这就是问题所在。

解决办法：

从网上搜到了一些解决办法，选择了其中一个非常nice的分享出来
外国盆友的解决办法
在这里插入图片描述
按照该方法，我们对原来的文件进行修改。

新建插件文件

/app/code/Mageplaza/JsonReturn/Plugin/ServiceOutputProcessorPlugin.php (路径固定，文件名随便起)

<?phpnamespace Mageplaza\JsonReturn\Plugin;use Magento\Framework\Webapi\ServiceOutputProcessor;class ServiceOutputProcessorPlugin
{public function aroundConvertValue(ServiceOutputProcessor $subject, callable $proceed, $data, $type){if ($type == 'array') {return $data;}return $proceed($data, $type);}
}

修改di.xml 文件

<?xml version="1.0" ?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd"><preference for="Mageplaza\JsonReturn\Api\JsonDataInterface" type="Mageplaza\JsonReturn\Model\ReturnJson"/><type name="Magento\Framework\Webapi\ServiceOutputProcessor"><plugin name="mageplaza_jsonReturnplugin" type="Mageplaza\JsonReturn\Plugin\ServiceOutputProcessorPlugin" disabled="false"/></type>
</config>