From: "Nickle Wang" <nickle.wang@hpe.com>
To: "Chang, Abner (HPS SW/FW Technologist)" <abner.chang@hpe.com>,
"devel@edk2.groups.io" <devel@edk2.groups.io>
Cc: Michael D Kinney <michael.d.kinney@intel.com>,
Liming Gao <gaoliming@byosoft.com.cn>,
Zhiguang Liu <zhiguang.liu@intel.com>,
Jiaxin Wu <jiaxin.wu@intel.com>, Siyuan Fu <siyuan.fu@intel.com>,
Fan Wang <fan.wang@intel.com>, Jiewen Yao <jiewen.yao@intel.com>
Subject: Re: [RestJsonStructureDxe PATCH v3 1/3] MdePkg/Include: Definitions of EFI REST JSON Structure Protocol
Date: Thu, 29 Oct 2020 06:52:09 +0000 [thread overview]
Message-ID: <DF4PR8401MB08122280BA68DCE2F8EFF0AFFF140@DF4PR8401MB0812.NAMPRD84.PROD.OUTLOOK.COM> (raw)
In-Reply-To: <20201015154928.16211-2-abner.chang@hpe.com>
Hi Abner,
I found an issue on function header of EFI_REST_JSON_STRUCTURE_REGISTER that is not follow UEFI spec.
Thanks,
Nickle
> -----Original Message-----
> From: Chang, Abner (HPS SW/FW Technologist) <abner.chang@hpe.com>
> Sent: Thursday, October 15, 2020 11:49 PM
> To: devel@edk2.groups.io
> Cc: Michael D Kinney <michael.d.kinney@intel.com>; Liming Gao
> <gaoliming@byosoft.com.cn>; Zhiguang Liu <zhiguang.liu@intel.com>; Jiaxin
> Wu <jiaxin.wu@intel.com>; Siyuan Fu <siyuan.fu@intel.com>; Fan Wang
> <fan.wang@intel.com>; Jiewen Yao <jiewen.yao@intel.com>; Wang, Nickle
> (HPS SW) <nickle.wang@hpe.com>
> Subject: [RestJsonStructureDxe PATCH v3 1/3] MdePkg/Include: Definitions
> of EFI REST JSON Structure Protocol
>
> Add definitions of EFI REST JSON Structure according to UEFI spec
> 2.8 Section 29.7.3 EFI REST JSON Resource to C Structure Converter.
>
> Signed-off-by: Abner Chang <abner.chang@hpe.com>
>
> Cc: Michael D Kinney <michael.d.kinney@intel.com>
> Cc: Liming Gao <gaoliming@byosoft.com.cn>
> Cc: Zhiguang Liu <zhiguang.liu@intel.com>
> Cc: Jiaxin Wu <jiaxin.wu@intel.com>
> Cc: Siyuan Fu <siyuan.fu@intel.com>
> Cc: Fan Wang <fan.wang@intel.com>
> Cc: Jiewen Yao <jiewen.yao@intel.com>
> Cc: Nickle Wang <nickle.wang@hpe.com>
> Reviewed-by: Liming Gao <gaoliming@byosoft.com.cn>
> ---
> MdePkg/Include/Protocol/RestJsonStructure.h | 161
> ++++++++++++++++++++
> MdePkg/MdePkg.dec | 3 +
> 2 files changed, 164 insertions(+)
> create mode 100644 MdePkg/Include/Protocol/RestJsonStructure.h
>
> diff --git a/MdePkg/Include/Protocol/RestJsonStructure.h
> b/MdePkg/Include/Protocol/RestJsonStructure.h
> new file mode 100644
> index 0000000000..adaf148f71
> --- /dev/null
> +++ b/MdePkg/Include/Protocol/RestJsonStructure.h
> @@ -0,0 +1,161 @@
> +/** @file
> + This file defines the EFI REST JSON Structure Protocol interface.
> +
> + (C) Copyright 2020 Hewlett Packard Enterprise Development LP<BR>
> +
> + SPDX-License-Identifier: BSD-2-Clause-Patent
> +
> + @par Revision Reference:
> + This Protocol is introduced in UEFI Specification 2.8
> +
> +**/
> +
> +#ifndef EFI_REST_JSON_STRUCTURE_PROTOCOL_H_
> +#define EFI_REST_JSON_STRUCTURE_PROTOCOL_H_
> +
> +///
> +/// GUID definitions
> +///
> +#define EFI_REST_JSON_STRUCTURE_PROTOCOL_GUID \
> + { \
> + 0xa9a048f6, 0x48a0, 0x4714, {0xb7, 0xda, 0xa9, 0xad,0x87, 0xd4, 0xda,
> 0xc9 } \
> + }
> +
> +typedef struct _EFI_REST_JSON_STRUCTURE_PROTOCOL
> EFI_REST_JSON_STRUCTURE_PROTOCOL;
> +typedef CHAR8 * EFI_REST_JSON_RESOURCE_TYPE_DATATYPE;
> +
> +///
> +/// Structure defintions of resource name space.
> +///
> +/// The fields declared in this structure define the
> +/// name and revision of payload delievered throught
> +/// REST API.
> +///
> +typedef struct _EFI_REST_JSON_RESOURCE_TYPE_NAMESPACE {
> + CHAR8 *ResourceTypeName; ///< Resource type name
> + CHAR8 *MajorVersion; ///< Resource major version
> + CHAR8 *MinorVersion; ///< Resource minor version
> + CHAR8 *ErrataVersion; ///< Resource errata version
> +} EFI_REST_JSON_RESOURCE_TYPE_NAMESPACE;
> +
> +///
> +/// REST resource type identifier
> +///
> +/// REST resource type consists of name space and data type.
> +///
> +typedef struct _EFI_REST_JSON_RESOURCE_TYPE_IDENTIFIER {
> + EFI_REST_JSON_RESOURCE_TYPE_NAMESPACE NameSpace; ///<
> Namespace of this resource type.
> + EFI_REST_JSON_RESOURCE_TYPE_DATATYPE DataType; ///< Name of
> data type declared in this
> + ///< resource type.
> +} EFI_REST_JSON_RESOURCE_TYPE_IDENTIFIER;
> +
> +///
> +/// List of JSON to C structure conversions which this convertor supports.
> +///
> +typedef struct _EFI_REST_JSON_STRUCTURE_SUPPORTED {
> + LIST_ENTRY NextSupportedRsrcInterp; ///< Linklist to next
> supported conversion.
> + EFI_REST_JSON_RESOURCE_TYPE_IDENTIFIER RestResourceInterp; ///<
> JSON resource type this convertor supports.
> +} EFI_REST_JSON_STRUCTURE_SUPPORTED;
> +
> +///
> +/// The header file of JSON C structure
> +///
> +typedef struct _EFI_REST_JSON_STRUCTURE_HEADER {
> + EFI_REST_JSON_RESOURCE_TYPE_IDENTIFIER JsonRsrcIdentifier; ///<
> Resource identifier which use to
> + ///< choice the proper interpreter.
> + ///< Follow by a pointer points to JSON structure, the content in the
> + ///< JSON structure is implementation-specific according to converter
> producer.
> + VOID *JsonStructurePointer;
> +} EFI_REST_JSON_STRUCTURE_HEADER;
> +
> +/**
> + JSON-IN C Structure-OUT function. Convert the given REST JSON resource
> into structure.
> +
> + @param[in] This This is the
> EFI_REST_JSON_STRUCTURE_PROTOCOL instance.
> + @param[in] JsonRsrcIdentifier This indicates the resource type and
> version is given in
> + ResourceJsonText.
> + @param[in] ResourceJsonText REST JSON resource in text format.
> + @param[out] JsonStructure Pointer to receive the pointer to
> EFI_REST_JSON_STRUCTURE_HEADER
> +
> + @retval EFI_SUCCESS
> + @retval Others
> +--*/
> +typedef
> +EFI_STATUS
> +(EFIAPI *EFI_REST_JSON_STRUCTURE_TO_STRUCTURE)(
> + IN EFI_REST_JSON_STRUCTURE_PROTOCOL *This,
> + IN EFI_REST_JSON_RESOURCE_TYPE_IDENTIFIER *JsonRsrcIdentifier
> OPTIONAL,
> + IN CHAR8 *ResourceJsonText,
> + OUT EFI_REST_JSON_STRUCTURE_HEADER **JsonStructure
> +);
> +
> +/**
> + Convert the given REST JSON structure into JSON text.
> +
> + @param[in] This This is the
> EFI_REST_JSON_STRUCTURE_PROTOCOL instance.
> + @param[in] JsonStructureHeader The point to
> EFI_REST_JSON_STRUCTURE_HEADER structure.
> + @param[out] ResourceJsonText Pointer to receive REST JSON resource
> in text format.
> +
> + @retval EFI_SUCCESS
> + @retval Others
> +
> +--*/
> +typedef
> +EFI_STATUS
> +(EFIAPI *EFI_REST_JSON_STRUCTURE_TO_JSON)(
> + IN EFI_REST_JSON_STRUCTURE_PROTOCOL *This,
> + IN EFI_REST_JSON_STRUCTURE_HEADER *JsonStructureHeader,
> + OUT CHAR8 **ResourceJsonText
> +);
> +
> +/**
> + This function destroys the REST JSON structure.
> +
> + @param[in] This This is the
> EFI_REST_JSON_STRUCTURE_PROTOCOL instance.
> + @param[in] JsonStructureHeader JSON structure to destroy.
> +
> + @retval EFI_SUCCESS
> + @retval Others
> +
> +--*/
> +typedef
> +EFI_STATUS
> +(EFIAPI *EFI_REST_JSON_STRUCTURE_DESTORY_STRUCTURE)(
> + IN EFI_REST_JSON_STRUCTURE_PROTOCOL *This,
> + IN EFI_REST_JSON_STRUCTURE_HEADER *JsonStructureHeader
> +);
> +/**
> + This function provides REST JSON resource to structure converter
> registration.
> +
> + @param[in] This This is the
> EFI_REST_JSON_STRUCTURE_PROTOCOL instance.
> + @param[in] JsonStructureSupported The type and version of REST JSON
> resource which this converter
> + supports.
> + @param[in] ToStructure The function to convert REST JSON
> resource to structure.
> + @param[in] ToJson The function to convert REST JSON structure
> to JSON in text format.
> + @param[out] DestroyStructure Destroy REST JSON structure returned
According to UEFI 2.8, this is [in] parameter.
> in ToStructure() function.
> +
> + @retval EFI_SUCCESS Register successfully.
> + @retval Others Fail to register.
> +
> +--*/
> +typedef
> +EFI_STATUS
> +(EFIAPI *EFI_REST_JSON_STRUCTURE_REGISTER)(
> + IN EFI_REST_JSON_STRUCTURE_PROTOCOL *This,
> + IN EFI_REST_JSON_STRUCTURE_SUPPORTED *JsonStructureSupported,
> + IN EFI_REST_JSON_STRUCTURE_TO_STRUCTURE ToStructure,
> + IN EFI_REST_JSON_STRUCTURE_TO_JSON ToJson,
> + IN EFI_REST_JSON_STRUCTURE_DESTORY_STRUCTURE DestroyStructure
> +);
> +
> +///
> +/// EFI REST JSON to C structure protocol definition.
> +///
> +struct _EFI_REST_JSON_STRUCTURE_PROTOCOL {
> + EFI_REST_JSON_STRUCTURE_REGISTER Register; ///< Register
> JSON to C structure convertor
> + EFI_REST_JSON_STRUCTURE_TO_STRUCTURE ToStructure; ///< The
> function to convert JSON to C structure
> + EFI_REST_JSON_STRUCTURE_TO_JSON ToJson; ///< The
> function to convert C structure to JSON
> + EFI_REST_JSON_STRUCTURE_DESTORY_STRUCTURE DestoryStructure;
> ///< Destory C structure.
> +};
> +
> +#endif
> diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec
> index 5205374d62..645f61b80e 100644
> --- a/MdePkg/MdePkg.dec
> +++ b/MdePkg/MdePkg.dec
> @@ -1855,6 +1855,9 @@
> gEfiRestExProtocolGuid = { 0x55648b91, 0xe7d, 0x40a3, { 0xa9, 0xb3,
> 0xa8, 0x15, 0xd7, 0xea, 0xdf, 0x97 }}
> gEfiRestExServiceBindingProtocolGuid = { 0x456bbe01, 0x99d0, 0x45ea,
> { 0xbb, 0x5f, 0x16, 0xd8, 0x4b, 0xed, 0xc5, 0x59 }}
>
> + ## Include/Protocol/RestJsonStructure.h
> + gEfiRestJsonStructureProtocolGuid = { 0xa9a048f6, 0x48a0, 0x4714, {0xb7,
> 0xda, 0xa9, 0xad,0x87, 0xd4, 0xda, 0xc9 }}
> +
> #
> # Protocols defined in Shell2.0
> #
> --
> 2.17.1
next prev parent reply other threads:[~2020-10-29 6:52 UTC|newest]
Thread overview: 12+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-10-15 15:49 [RestJsonStructureDxe PATCH v3 0/3] EFI REST JSON Structure Protocol Abner Chang
2020-10-15 15:49 ` [RestJsonStructureDxe PATCH v3 1/3] MdePkg/Include: Definitions of " Abner Chang
2020-10-29 6:52 ` Nickle Wang [this message]
2020-10-30 1:32 ` Abner Chang
2020-11-02 3:53 ` Nickle Wang
2020-10-15 15:49 ` [RestJsonStructureDxe PATCH v3 2/3] RedfishPkg/RestJsonStructureDxe: " Abner Chang
2020-10-29 6:57 ` Nickle Wang
2020-10-30 1:37 ` Abner Chang
[not found] ` <1642A15CB7E86403.17837@groups.io>
2020-10-30 1:42 ` [edk2-devel] " Abner Chang
2020-10-15 15:49 ` [RestJsonStructureDxe PATCH v3 3/3] RedfishPkg: Changes on RedfishPkg for CI test Abner Chang
2020-10-29 6:59 ` Nickle Wang
-- strict thread matches above, loose matches on Subject: below --
2020-10-15 15:33 [RestJsonStructureDxe PATCH v3 0/3] EFI REST JSON Structure Protocol Abner Chang
2020-10-15 15:33 ` [RestJsonStructureDxe PATCH v3 1/3] MdePkg/Include: Definitions of " Abner Chang
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-list from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=DF4PR8401MB08122280BA68DCE2F8EFF0AFFF140@DF4PR8401MB0812.NAMPRD84.PROD.OUTLOOK.COM \
--to=devel@edk2.groups.io \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox