RedfishPkg/library: EDK2 port of jansson library

edk2 JsonLib which is the edk2 port of open source
jansson library.
(https://github.com/akheron/jansson)
jansson library is the open source project to manipulate
JSON data structure.

Signed-off-by: Abner Chang <abner.chang@hpe.com>

Cc: Leif Lindholm <leif@nuviainc.com>
Cc: Nickle Wang <nickle.wang@hpe.com>
Cc: Peter O'Hanley <peter.ohanley@hpe.com>
Reviewed-by: Nickle Wang <nickle.wang@hpe.com>
Acked-by: Leif Lindholm <leif@nuviainc.com>
Reviewed-by: Michael D Kinney <michael.d.kinney@intel.com>
This commit is contained in:
Abner Chang 2020-12-04 23:59:59 +08:00 committed by mergify[bot]
parent 6e9233f968
commit ea830b96fd
9 changed files with 3047 additions and 1 deletions

View File

@ -0,0 +1,779 @@
/** @file
APIs for JSON operations.
Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
(C) Copyright 2020 Hewlett Packard Enterprise Development LP<BR>
SPDX-License-Identifier: BSD-2-Clause-Patent
**/
#ifndef JSON_LIB_H_
#define JSON_LIB_H_
typedef VOID* EDKII_JSON_VALUE;
typedef VOID* EDKII_JSON_ARRAY;
typedef VOID* EDKII_JSON_OBJECT;
///
/// Map to json_int_t in jansson.h
///
typedef INT64 EDKII_JSON_INT_T; // #JSON_INTEGER_IS_LONG_LONG is set to 1
// in jansson_Config.h
///
/// Map to the definitions in jansson.h
/// See below URI for the JSON encoding flags reference.
/// https://jansson.readthedocs.io/en/2.13/apiref.html#encoding
///
#define EDKII_JSON_MAX_INDENT 0x1F
#define EDKII_JSON_INDENT(n) ((n) & EDKII_JSON_MAX_INDENT)
#define EDKII_JSON_COMPACT 0x20
#define EDKII_JSON_ENSURE_ASCII 0x40
#define EDKII_JSON_SORT_KEYS 0x80
#define EDKII_JSON_PRESERVE_ORDER 0x100
#define EDKII_JSON_ENCODE_ANY 0x200
#define EDKII_JSON_ESCAPE_SLASH 0x400
#define EDKII_JSON_REAL_PRECISION(n) (((n) & 0x1F) << 11)
#define EDKII_JSON_EMBED 0x10000
///
/// Map to the definitions in jansson.h
/// See below URI for the JSON decoding flags reference.
/// https://jansson.readthedocs.io/en/2.13/apiref.html?highlight=json_loadb#decoding
///
#define EDKII_JSON_REJECT_DUPLICATES 0x1
#define EDKII_JSON_DISABLE_EOF_CHECK 0x2
#define EDKII_JSON_DECODE_ANY 0x4
#define EDKII_JSON_DECODE_INT_AS_REAL 0x8
#define EDKII_JSON_ALLOW_NUL 0x10
#define EDKII_JSON_ARRAY_FOREACH(Array, Index, Value) \
for(Index = 0; \
Index < JsonArrayCount(Array) && (Value = JsonArrayGetValue(Array, Index)); \
Index++)
///
/// Map to the json_error_t in jansson.h
///
#define EDKII_JSON_ERROR_TEXT_LENGTH 160
#define EDKII_JSON_ERROR_SOURCE_LENGTH 80
typedef struct {
INTN Line;
INTN Column;
INTN Position;
CHAR8 Source [EDKII_JSON_ERROR_SOURCE_LENGTH];
CHAR8 Text [EDKII_JSON_ERROR_TEXT_LENGTH];
} EDKII_JSON_ERROR;
///
/// Map to the json_type in jansson.h
///
typedef enum {
EdkiiJsonTypeObject,
EdkiiJsonTypeArray,
EdkiiJsonTypeString,
EdkiiJsonTypeInteger,
EdkiiJsonTypeReal,
EdkiiJsonTypeTrue,
EdkiiJsonTypeFalse,
EdkiiJsonTypeNull
} EDKII_JSON_TYPE;
/**
The function is used to initialize a JSON value which contains a new JSON array,
or NULL on error. Initially, the array is empty.
The reference count of this value will be set to 1, and caller needs to cleanup the
value by calling JsonValueFree().
More details for reference count strategy can refer to the API description for JsonValueFree().
@retval The created JSON value which contains a JSON array or NULL if intial a JSON array
is failed.
**/
EDKII_JSON_VALUE
EFIAPI
JsonValueInitArray (
VOID
);
/**
The function is used to initialize a JSON value which contains a new JSON object,
or NULL on error. Initially, the object is empty.
The reference count of this value will be set to 1, and caller needs to cleanup the
value by calling JsonValueFree().
More details for reference count strategy can refer to the API description for JsonValueFree().
@retval The created JSON value which contains a JSON object or NULL if intial a JSON object
is failed.
**/
EDKII_JSON_VALUE
EFIAPI
JsonValueInitObject (
VOID
);
/**
The function is used to initialize a JSON value which contains a new JSON string,
or NULL on error.
The input string must be NULL terminated Ascii format, non-Ascii characters will
be processed as an error. Unicode characters can also be represented by Ascii string
as the format: \u + 4 hexadecimal digits, like \u3E5A, or \u003F.
The reference count of this value will be set to 1, and caller needs to cleanup the
value by calling JsonValueFree().
More details for reference count strategy can refer to the API description for JsonValueFree().
@param[in] String The Ascii string to initialize to JSON value
@retval The created JSON value which contains a JSON string or NULL. Select a
Getter API for a specific encoding format.
**/
EDKII_JSON_VALUE
EFIAPI
JsonValueInitAsciiString (
IN CONST CHAR8 *String
);
/**
The function is used to initialize a JSON value which contains a new JSON string,
or NULL on error.
The input must be a NULL terminated UCS2 format Unicode string.
The reference count of this value will be set to 1, and caller needs to cleanup the
value by calling JsonValueFree().
More details for reference count strategy can refer to the API description for JsonValueFree().
@param[in] String The Unicode string to initialize to JSON value
@retval The created JSON value which contains a JSON string or NULL. Select a
Getter API for a specific encoding format.
**/
EDKII_JSON_VALUE
EFIAPI
JsonValueInitUnicodeString (
IN CHAR16 *String
);
/**
The function is used to initialize a JSON value which contains a new JSON integer,
or NULL on error.
The reference count of this value will be set to 1, and caller needs to cleanup the
value by calling JsonValueFree().
More details for reference count strategy can refer to the API description for JsonValueFree().
@param[in] Value The integer to initialize to JSON value
@retval The created JSON value which contains a JSON number or NULL.
**/
EDKII_JSON_VALUE
EFIAPI
JsonValueInitNumber (
IN INT64 Value
);
/**
The function is used to initialize a JSON value which contains a new JSON boolean,
or NULL on error.
Boolean JSON value is kept as static value, and no need to do any cleanup work.
@param[in] Value The boolean value to initialize.
@retval The created JSON value which contains a JSON boolean or NULL.
**/
EDKII_JSON_VALUE
EFIAPI
JsonValueInitBoolean (
IN BOOLEAN Value
);
/**
The function is used to initialize a JSON value which contains a new JSON NULL,
or NULL on error.
NULL JSON value is kept as static value, and no need to do any cleanup work.
@retval The created NULL JSON value.
**/
EDKII_JSON_VALUE
EFIAPI
JsonValueInitNull (
VOID
);
/**
The function is used to decrease the reference count of a JSON value by one, and once
this reference count drops to zero, the value is destroyed and it can no longer be used.
If this destroyed value is object type or array type, reference counts for all containing
JSON values will be decreased by 1. Boolean JSON value and NULL JSON value won't be destroyed
since they are static values kept in memory.
Reference Count Strategy: BaseJsonLib uses this strategy to track whether a value is still
in use or not. When a value is created, it's reference count is set to 1. If a reference to a
value is kept for use, its reference count is incremented, and when the value is no longer
needed, the reference count is decremented. When the reference count drops to zero, there are
no references left, and the value can be destroyed.
The given JSON value maybe NULL and not causing any problem. Just output the debug message
to inform caller the NULL value is passed in.
@param[in] Json The JSON value to be freed. json_decref may return without any
changes if Json is NULL.
**/
VOID
EFIAPI
JsonValueFree (
IN EDKII_JSON_VALUE Json
);
/**
The function is used to create a fresh copy of a JSON value, and all child values are deep
copied in a recursive fashion. It should be called when this JSON value might be modified
in later use, but the original still wants to be used in somewhere else.
Reference counts of the returned root JSON value and all child values will be set to 1, and
caller needs to cleanup the root value by calling JsonValueFree().
* Note: Since this function performs a copy from bottom to up, too many calls may cause some
performance issues, user should avoid unnecessary calls to this function unless it is really
needed.
@param[in] Json The JSON value to be cloned.
@retval Return the cloned JSON value, or NULL on error.
**/
EDKII_JSON_VALUE
EFIAPI
JsonValueClone (
IN EDKII_JSON_VALUE Json
);
/**
The function is used to return if the provided JSON value contains a JSON array.
@param[in] Json The provided JSON value.
@retval TRUE The JSON value contains a JSON array.
@retval FALSE The JSON value doesn't contain a JSON array.
**/
BOOLEAN
EFIAPI
JsonValueIsArray (
IN EDKII_JSON_VALUE Json
);
/**
The function is used to return if the provided JSON value contains a JSON object.
@param[in] Json The provided JSON value.
@retval TRUE The JSON value contains a JSON object.
@retval FALSE The JSON value doesn't contain a JSON object.
**/
BOOLEAN
EFIAPI
JsonValueIsObject (
IN EDKII_JSON_VALUE Json
);
/**
The function is used to return if the provided JSON Value contains a string, Ascii or
Unicode format is not differentiated.
@param[in] Json The provided JSON value.
@retval TRUE The JSON value contains a JSON string.
@retval FALSE The JSON value doesn't contain a JSON string.
**/
BOOLEAN
EFIAPI
JsonValueIsString (
IN EDKII_JSON_VALUE Json
);
/**
The function is used to return if the provided JSON value contains a JSON number.
@param[in] Json The provided JSON value.
@retval TRUE The JSON value is contains JSON number.
@retval FALSE The JSON value doesn't contain a JSON number.
**/
BOOLEAN
EFIAPI
JsonValueIsNumber (
IN EDKII_JSON_VALUE Json
);
/**
The function is used to return if the provided JSON value contains a JSON boolean.
@param[in] Json The provided JSON value.
@retval TRUE The JSON value contains a JSON boolean.
@retval FALSE The JSON value doesn't contain a JSON boolean.
**/
BOOLEAN
EFIAPI
JsonValueIsBoolean (
IN EDKII_JSON_VALUE Json
);
/**
The function is used to return if the provided JSON value contains a JSON NULL.
@param[in] Json The provided JSON value.
@retval TRUE The JSON value contains a JSON NULL.
@retval FALSE The JSON value doesn't contain a JSON NULL.
**/
BOOLEAN
EFIAPI
JsonValueIsNull (
IN EDKII_JSON_VALUE Json
);
/**
The function is used to retrieve the associated array in an array type JSON value.
Any changes to the returned array will impact the original JSON value.
@param[in] Json The provided JSON value.
@retval Return the associated array in JSON value or NULL.
**/
EDKII_JSON_ARRAY
EFIAPI
JsonValueGetArray (
IN EDKII_JSON_VALUE Json
);
/**
The function is used to retrieve the associated object in an object type JSON value.
Any changes to the returned object will impact the original JSON value.
@param[in] Json The provided JSON value.
@retval Return the associated object in JSON value or NULL.
**/
EDKII_JSON_OBJECT
EFIAPI
JsonValueGetObject (
IN EDKII_JSON_VALUE Json
);
/**
The function is used to retrieve the associated Ascii string in a string type JSON value.
Any changes to the returned string will impact the original JSON value.
@param[in] Json The provided JSON value.
@retval Return the associated Ascii string in JSON value or NULL.
**/
CONST CHAR8 *
EFIAPI
JsonValueGetAsciiString (
IN EDKII_JSON_VALUE Json
);
/**
The function is used to retrieve the associated Unicode string in a string type JSON value.
Caller can do any changes to the returned string without any impact to the original JSON
value, and caller needs to free the returned string using FreePool().
@param[in] Json The provided JSON value.
@retval Return the associated Unicode string in JSON value or NULL.
**/
CHAR16*
EFIAPI
JsonValueGetUnicodeString (
IN EDKII_JSON_VALUE Json
);
/**
The function is used to retrieve the associated integer in a number type JSON value.
The input JSON value should not be NULL or contain no JSON number, otherwise it will
ASSERT() and return 0.
@param[in] Json The provided JSON value.
@retval Return the associated number in JSON value.
**/
INT64
EFIAPI
JsonValueGetNumber (
IN EDKII_JSON_VALUE Json
);
/**
The function is used to retrieve the associated boolean in a boolean type JSON value.
The input JSON value should not be NULL or contain no JSON boolean, otherwise it will
ASSERT() and return FALSE.
@param[in] Json The provided JSON value.
@retval Return the associated value of JSON boolean.
**/
BOOLEAN
EFIAPI
JsonValueGetBoolean (
IN EDKII_JSON_VALUE Json
);
/**
The function is used to retrieve the associated string in a string type JSON value.
Any changes to the returned string will impact the original JSON value.
@param[in] Json The provided JSON value.
@retval Return the associated Ascii string in JSON value or NULL on errors.
**/
CONST CHAR8*
EFIAPI
JsonValueGetString (
IN EDKII_JSON_VALUE Json
);
/**
The function is used to get the number of elements in a JSON object, or 0 if it is NULL or
not a JSON object.
@param[in] JsonObject The provided JSON object.
@retval Return the number of elements in this JSON object or 0.
**/
UINTN
EFIAPI
JsonObjectSize (
IN EDKII_JSON_OBJECT JsonObject
);
/**
The function is used to enumerate all keys in a JSON object.
Caller should be responsible to free the returned key array reference using
FreePool(). But contained keys are read only and must not be modified or freed.
@param[in] JsonObj The provided JSON object for enumeration.
@param[out] KeyCount The count of keys in this JSON object.
@retval Return an array of the enumerated keys in this JSON object or NULL if
JsonObj is not an JSON object, key count is zero or on other errors.
**/
CHAR8**
JsonObjectGetKeys (
IN EDKII_JSON_OBJECT JsonObj,
OUT UINTN *KeyCount
);
/**
The function is used to get a JSON value corresponding to the input key from a JSON object.
It only returns a reference to this value and any changes on this value will impact the
original JSON object. If that is not expected, please call JsonValueClone() to clone it to
use.
Input key must be a valid NULL terminated UTF8 encoded string. NULL will be returned when
Key-Value is not found in this JSON object.
@param[in] JsonObj The provided JSON object.
@param[in] Key The key of the JSON value to be retrieved.
@retval Return the corresponding JSON value to key, or NULL on error.
**/
EDKII_JSON_VALUE
EFIAPI
JsonObjectGetValue (
IN CONST EDKII_JSON_OBJECT JsonObj,
IN CONST CHAR8 *Key
);
/**
The function is used to set a JSON value corresponding to the input key from a JSON object,
and the reference count of this value will be increased by 1.
Input key must be a valid NULL terminated UTF8 encoded string. If there already is a value for
this key, this key will be assigned to the new JSON value. The old JSON value will be removed
from this object and thus its' reference count will be decreased by 1.
More details for reference count strategy can refer to the API description for JsonValueFree().
@param[in] JsonObj The provided JSON object.
@param[in] Key The key of the JSON value to be set.
@param[in] Json The JSON value to set to this JSON object mapped by key.
@retval EFI_ABORTED Some error occur and operation aborted.
@retval EFI_SUCCESS The JSON value has been set to this JSON object.
**/
EFI_STATUS
EFIAPI
JsonObjectSetValue (
IN EDKII_JSON_OBJECT JsonObj,
IN CONST CHAR8 *Key,
IN EDKII_JSON_VALUE Json
);
/**
The function is used to get the number of elements in a JSON array. Returns or 0 if JsonArray
is NULL or not a JSON array.
@param[in] JsonArray The provided JSON array.
@retval Return the number of elements in this JSON array or 0.
**/
UINTN
EFIAPI
JsonArrayCount (
IN EDKII_JSON_ARRAY JsonArray
);
/**
The function is used to return the JSON value in the array at position index. The valid range
for this index is from 0 to the return value of JsonArrayCount() minus 1.
It only returns a reference to this value and any changes on this value will impact the
original JSON object. If that is not expected, please call JsonValueClone() to clone it to
use.
If this array is NULL or not a JSON array, or if index is out of range, NULL will be returned.
@param[in] JsonArray The provided JSON Array.
@retval Return the JSON value located in the Index position or
NULL if JsonArray is not an array or no items in the array.
**/
EDKII_JSON_VALUE
EFIAPI
JsonArrayGetValue (
IN EDKII_JSON_ARRAY JsonArray,
IN UINTN Index
);
/**
The function is used to append a JSON value to the end of the JSON array, and grow the size of
array by 1. The reference count of this value will be increased by 1.
More details for reference count strategy can refer to the API description for JsonValueFree().
@param[in] JsonArray The provided JSON object.
@param[in] Json The JSON value to append.
@retval EFI_ABORTED Some error occur and operation aborted.
@retval EFI_SUCCESS JSON value has been appended to the end of the JSON array.
**/
EFI_STATUS
EFIAPI
JsonArrayAppendValue (
IN EDKII_JSON_ARRAY JsonArray,
IN EDKII_JSON_VALUE Json
);
/**
The function is used to remove a JSON value at position index, shifting the elements after index
one position towards the start of the array. The reference count of this value will be decreased
by 1.
More details for reference count strategy can refer to the API description for JsonValueFree().
@param[in] JsonArray The provided JSON array.
@param[in] Index The Index position before removement.
@retval EFI_ABORTED Some error occur and operation aborted.
@retval EFI_SUCCESS The JSON array has been removed at position index.
**/
EFI_STATUS
EFIAPI
JsonArrayRemoveValue (
IN EDKII_JSON_ARRAY JsonArray,
IN UINTN Index
);
/**
Dump JSON to a buffer.
@param[in] JsonValue The provided JSON value.
@param[in] Flags The Index position before removement. The value
could be the combination of below flags.
- EDKII_JSON_INDENT(n)
- EDKII_JSON_COMPACT
- EDKII_JSON_ENSURE_ASCII
- EDKII_JSON_SORT_KEYS
- EDKII_JSON_PRESERVE_ORDER
- EDKII_JSON_ENCODE_ANY
- EDKII_JSON_ESCAPE_SLASH
- EDKII_JSON_REAL_PRECISION(n)
- EDKII_JSON_EMBED
See below URI for the JSON encoding flags reference.
https://jansson.readthedocs.io/en/2.13/apiref.html#encoding
@retval CHAR8 * Dump fail if NULL returned, otherwise the buffer
contain JSON paylaod in ASCII string. The return
value must be freed by the caller FreePool().
**/
CHAR8 *
EFIAPI
JsonDumpString (
IN EDKII_JSON_VALUE JsonValue,
IN UINTN Flags
);
/**
Load JSON from a buffer.
@param[in] Buffer Bufffer to the JSON payload
@param[in] BufferLen Length of the buffer
@param[in] Flags Flag of loading JSON buffer, the value
could be the combination of below flags.
- EDKII_JSON_REJECT_DUPLICATES
- EDKII_JSON_DISABLE_EOF_CHECK
- EDKII_JSON_DECODE_ANY
- EDKII_JSON_DECODE_INT_AS_REAL
- EDKII_JSON_ALLOW_NUL
See below URI for the JSON encoding flags reference.
https://jansson.readthedocs.io/en/2.13/apiref.html?highlight=json_loadb#decoding
@param[in,out] Error Pointer EDKII_JSON_ERROR structure
@retval EDKII_JSON_VALUE NULL means fail to load JSON payload.
**/
EDKII_JSON_VALUE
EFIAPI
JsonLoadBuffer (
IN CONST CHAR8 *Buffer,
IN UINTN BufferLen,
IN UINTN Flags,
IN OUT EDKII_JSON_ERROR *Error
);
/**
The reference count is used to track whether a value is still in use or not.
When a value is created, it's reference count is set to 1.
when the value is no longer needed, the reference count is decremented.
When the reference count drops to zero, there are no references left and the
value can be destroyed.
This funciton decrement the reference count of EDKII_JSON_VALUE. As soon as
a call to json_decref() drops the reference count to zero, the value is
destroyed and it can no longer be used.
@param[in] JsonValue JSON value
**/
VOID
EFIAPI
JsonDecreaseReference (
IN EDKII_JSON_VALUE JsonValue
);
/**
The reference count is used to track whether a value is still in use or not.
When a value is created, it's reference count is set to 1.
If a reference to a value is kept (e.g. a value is stored somewhere for later use),
its reference count is incremented.
This function increment the reference count of json if it's not NULL.
Returns EDKII_JSON_VALUE.
@param[in] JsonValue JSON value
@retval EDKII_JSON_VALUE of itself
**/
EDKII_JSON_VALUE
EFIAPI
JsonIncreaseReference (
IN EDKII_JSON_VALUE JsonValue
);
/**
Returns an opaque iterator which can be used to iterate over all key-value pairs
in object, or NULL if object is empty
@param[in] JsonValue JSON value
**/
VOID *
EFIAPI
JsonObjectIterator (
IN EDKII_JSON_VALUE JsonValue
);
/**
Extract the associated value from iterator.
@param[in] Iterator Iterator pointer
**/
EDKII_JSON_VALUE
EFIAPI
JsonObjectIteratorValue (
IN VOID *Iterator
);
/**
Returns an iterator pointing to the next key-value pair in object after iter,
or NULL if the whole object has been iterated through.
@param[in] JsonValue JSON value
@param[in] Iterator Iterator pointer
@retval Iterator pointer
**/
VOID *
JsonObjectIteratorNext (
IN EDKII_JSON_VALUE JsonValue,
IN VOID *Iterator
);
/**
Returns the json type of this json value
@param[in] JsonValue JSON value
@retval JSON type returned
**/
EDKII_JSON_TYPE
EFIAPI
JsonGetType(
IN EDKII_JSON_VALUE JsonValue
);
#endif

View File

@ -0,0 +1,957 @@
/** @file
APIs for JSON operations. The fuctions provided by this library are the
wrapper to native open source jansson library. See below document for
the API reference.
https://jansson.readthedocs.io/en/2.13/apiref.html
Copyright (c) 2018 - 2019, Intel Corporation. All rights reserved.<BR>
(C) Copyright 2020 Hewlett Packard Enterprise Development LP<BR>
SPDX-License-Identifier: BSD-2-Clause-Patent
**/
#include <Uefi.h>
#include <Library/JsonLib.h>
#include <Library/BaseUcs2Utf8Lib.h>
#include <Library/MemoryAllocationLib.h>
#include "jansson.h"
/**
The function is used to initialize a JSON value which contains a new JSON array,
or NULL on error. Initially, the array is empty.
The reference count of this value will be set to 1, and caller needs to cleanup the
value by calling JsonValueFree().
More details for reference count strategy can refer to the API description for JsonValueFree().
@retval The created JSON value which contains a JSON array or NULL if intial a JSON array
is failed.
**/
EDKII_JSON_VALUE
EFIAPI
JsonValueInitArray (
VOID
)
{
return (EDKII_JSON_VALUE)json_array();
}
/**
The function is used to initialize a JSON value which contains a new JSON object,
or NULL on error. Initially, the object is empty.
The reference count of this value will be set to 1, and caller needs to cleanup the
value by calling JsonValueFree().
More details for reference count strategy can refer to the API description for JsonValueFree().
@retval The created JSON value which contains a JSON object or NULL if intial a JSON object
is failed.
**/
EDKII_JSON_VALUE
EFIAPI
JsonValueInitObject (
VOID
)
{
return (EDKII_JSON_VALUE)json_object();
}
/**
The function is used to initialize a JSON value which contains a new JSON string,
or NULL on error.
The input string must be NULL terminated Ascii format, non-Ascii characters will
be processed as an error. Unicode characters can also be represented by Ascii string
as the format: \u + 4 hexadecimal digits, like \u3E5A, or \u003F.
The reference count of this value will be set to 1, and caller needs to cleanup the
value by calling JsonValueFree().
More details for reference count strategy can refer to the API description for JsonValueFree().
@param[in] String The Ascii string to initialize to JSON value
@retval The created JSON value which contains a JSON string or NULL. Select a
Getter API for a specific encoding format.
**/
EDKII_JSON_VALUE
EFIAPI
JsonValueInitAsciiString (
IN CONST CHAR8 *String
)
{
UINTN Index;
if (String == NULL) {
return NULL;
}
Index = 0;
while (*(String + Index) != '\0') {
if (((*(String + Index)) & 0x80) != 0x00) {
return NULL;
}
Index++;
}
return (EDKII_JSON_VALUE)json_string (String);
}
/**
The function is used to initialize a JSON value which contains a new JSON string,
or NULL on error.
The input must be a NULL terminated UCS2 format Unicode string.
The reference count of this value will be set to 1, and caller needs to cleanup the
value by calling JsonValueFree().
More details for reference count strategy can refer to the API description for JsonValueFree().
@param[in] String The Unicode string to initialize to JSON value
@retval The created JSON value which contains a JSON string or NULL. Select a
Getter API for a specific encoding format.
**/
EDKII_JSON_VALUE
EFIAPI
JsonValueInitUnicodeString (
IN CHAR16 *String
)
{
EFI_STATUS Status;
CHAR8 *Utf8Str;
if (String == NULL) {
return NULL;
}
Utf8Str = NULL;
Status = UCS2StrToUTF8 (String, &Utf8Str);
if (EFI_ERROR (Status)) {
return NULL;
}
return (EDKII_JSON_VALUE)json_string (Utf8Str);
}
/**
The function is used to initialize a JSON value which contains a new JSON integer,
or NULL on error.
The reference count of this value will be set to 1, and caller needs to cleanup the
value by calling JsonValueFree().
More details for reference count strategy can refer to the API description for JsonValueFree().
@param[in] Value The integer to initialize to JSON value
@retval The created JSON value which contains a JSON number or NULL.
**/
EDKII_JSON_VALUE
EFIAPI
JsonValueInitNumber (
IN INT64 Value
)
{
return (EDKII_JSON_VALUE)json_integer (Value);
}
/**
The function is used to initialize a JSON value which contains a new JSON boolean,
or NULL on error.
Boolean JSON value is kept as static value, and no need to do any cleanup work.
@param[in] Value The boolean value to initialize.
@retval The created JSON value which contains a JSON boolean or NULL.
**/
EDKII_JSON_VALUE
EFIAPI
JsonValueInitBoolean (
IN BOOLEAN Value
)
{
return (EDKII_JSON_VALUE)json_boolean (Value);
}
/**
The function is used to initialize a JSON value which contains a new JSON NULL,
or NULL on error.
NULL JSON value is kept as static value, and no need to do any cleanup work.
@retval The created NULL JSON value.
**/
EDKII_JSON_VALUE
EFIAPI
JsonValueInitNull (
VOID
)
{
return (EDKII_JSON_VALUE)json_null();
}
/**
The function is used to decrease the reference count of a JSON value by one, and once
this reference count drops to zero, the value is destroyed and it can no longer be used.
If this destroyed value is object type or array type, reference counts for all containing
JSON values will be decreased by 1. Boolean JSON value and NULL JSON value won't be destroyed
since they are static values kept in memory.
Reference Count Strategy: BaseJsonLib uses this strategy to track whether a value is still
in use or not. When a value is created, it's reference count is set to 1. If a reference to a
value is kept for use, its reference count is incremented, and when the value is no longer
needed, the reference count is decremented. When the reference count drops to zero, there are
no references left, and the value can be destroyed.
The given JSON value maybe NULL and not causing any problem. Just output the debug message
to inform caller the NULL value is passed in.
@param[in] Json The JSON value to be freed. json_decref may return without any
changes if Json is NULL.
**/
VOID
EFIAPI
JsonValueFree (
IN EDKII_JSON_VALUE Json
)
{
json_decref((json_t *)Json);
}
/**
The function is used to create a fresh copy of a JSON value, and all child values are deep
copied in a recursive fashion. It should be called when this JSON value might be modified
in later use, but the original still wants to be used in somewhere else.
Reference counts of the returned root JSON value and all child values will be set to 1, and
caller needs to cleanup the root value by calling JsonValueFree().
* Note: Since this function performs a copy from bottom to up, too many calls may cause some
performance issues, user should avoid unnecessary calls to this function unless it is really
needed.
@param[in] Json The JSON value to be cloned.
@retval Return the cloned JSON value, or NULL on error.
**/
EDKII_JSON_VALUE
EFIAPI
JsonValueClone (
IN EDKII_JSON_VALUE Json
)
{
return (EDKII_JSON_VALUE)json_deep_copy ((json_t *) Json);
}
/**
The function is used to return if the provided JSON value contains a JSON array.
@param[in] Json The provided JSON value.
@retval TRUE The JSON value contains a JSON array.
@retval FALSE The JSON value doesn't contain a JSON array.
**/
BOOLEAN
EFIAPI
JsonValueIsArray (
IN EDKII_JSON_VALUE Json
)
{
return json_is_array ((json_t *) Json);
}
/**
The function is used to return if the provided JSON value contains a JSON object.
@param[in] Json The provided JSON value.
@retval TRUE The JSON value contains a JSON object.
@retval FALSE The JSON value doesn't contain a JSON object.
**/
BOOLEAN
EFIAPI
JsonValueIsObject (
IN EDKII_JSON_VALUE Json
)
{
return json_is_object ((json_t *) Json);
}
/**
The function is used to return if the provided JSON Value contains a string, Ascii or
Unicode format is not differentiated.
@param[in] Json The provided JSON value.
@retval TRUE The JSON value contains a JSON string.
@retval FALSE The JSON value doesn't contain a JSON string.
**/
BOOLEAN
EFIAPI
JsonValueIsString (
IN EDKII_JSON_VALUE Json
)
{
return json_is_string ((json_t *) Json);
}
/**
The function is used to return if the provided JSON value contains a JSON number.
@param[in] Json The provided JSON value.
@retval TRUE The JSON value is contains JSON number.
@retval FALSE The JSON value doesn't contain a JSON number.
**/
BOOLEAN
EFIAPI
JsonValueIsNumber (
IN EDKII_JSON_VALUE Json
)
{
return json_is_integer ((json_t *) Json);
}
/**
The function is used to return if the provided JSON value contains a JSON boolean.
@param[in] Json The provided JSON value.
@retval TRUE The JSON value contains a JSON boolean.
@retval FALSE The JSON value doesn't contain a JSON boolean.
**/
BOOLEAN
EFIAPI
JsonValueIsBoolean (
IN EDKII_JSON_VALUE Json
)
{
return json_is_boolean ((json_t *) Json);
}
/**
The function is used to return if the provided JSON value contains a JSON NULL.
@param[in] Json The provided JSON value.
@retval TRUE The JSON value contains a JSON NULL.
@retval FALSE The JSON value doesn't contain a JSON NULL.
**/
BOOLEAN
EFIAPI
JsonValueIsNull (
IN EDKII_JSON_VALUE Json
)
{
return json_is_null ((json_t *) Json);
}
/**
The function is used to retrieve the associated array in an array type JSON value.
Any changes to the returned array will impact the original JSON value.
@param[in] Json The provided JSON value.
@retval Return the associated array in JSON value or NULL.
**/
EDKII_JSON_ARRAY
EFIAPI
JsonValueGetArray (
IN EDKII_JSON_VALUE Json
)
{
if (Json == NULL || !JsonValueIsArray (Json)) {
return NULL;
}
return (EDKII_JSON_ARRAY)Json;
}
/**
The function is used to retrieve the associated object in an object type JSON value.
Any changes to the returned object will impact the original JSON value.
@param[in] Json The provided JSON value.
@retval Return the associated object in JSON value or NULL.
**/
EDKII_JSON_OBJECT
EFIAPI
JsonValueGetObject (
IN EDKII_JSON_VALUE Json
)
{
if (Json == NULL || !JsonValueIsObject (Json)) {
return NULL;
}
return (EDKII_JSON_OBJECT)Json;
}
/**
The function is used to retrieve the associated Ascii string in a string type JSON value.
Any changes to the returned string will impact the original JSON value.
@param[in] Json The provided JSON value.
@retval Return the associated Ascii string in JSON value or NULL.
**/
CONST CHAR8 *
EFIAPI
JsonValueGetAsciiString (
IN EDKII_JSON_VALUE Json
)
{
CHAR8 *AsciiStr;
UINTN Index;
AsciiStr = (CHAR8 *) ((json_t *) Json);
if (AsciiStr == NULL) {
return NULL;
}
Index = 0;
while (*(AsciiStr + Index) != '\0') {
if (((*(AsciiStr + Index)) & 0x80) != 0x00) {
return NULL;
}
Index++;
}
return AsciiStr;
}
/**
The function is used to retrieve the associated Unicode string in a string type JSON value.
Caller can do any changes to the returned string without any impact to the original JSON
value, and caller needs to free the returned string using FreePool().
@param[in] Json The provided JSON value.
@retval Return the associated Unicode string in JSON value or NULL.
**/
CHAR16*
EFIAPI
JsonValueGetUnicodeString (
IN EDKII_JSON_VALUE Json
)
{
EFI_STATUS Status;
CONST CHAR8 *Utf8Str;
CHAR16 *Ucs2Str;
Utf8Str = json_string_value ((json_t *) Json);
if (Utf8Str == NULL) {
return NULL;
}
Status = UTF8StrToUCS2 ((CHAR8*)Utf8Str, &Ucs2Str);
if (EFI_ERROR (Status)) {
return NULL;
}
return Ucs2Str;
}
/**
The function is used to retrieve the associated integer in a number type JSON value.
The input JSON value should not be NULL or contain no JSON number, otherwise it will
ASSERT() and return 0.
@param[in] Json The provided JSON value.
@retval Return the associated number in JSON value.
**/
INT64
EFIAPI
JsonValueGetNumber (
IN EDKII_JSON_VALUE Json
)
{
ASSERT (Json != NULL && JsonValueIsNumber (Json));
if (Json == NULL || !JsonValueIsNumber (Json)) {
return 0;
}
return json_integer_value ((json_t *) Json);
}
/**
The function is used to retrieve the associated boolean in a boolean type JSON value.
The input JSON value should not be NULL or contain no JSON boolean, otherwise it will
ASSERT() and return FALSE.
@param[in] Json The provided JSON value.
@retval Return the associated value of JSON boolean.
**/
BOOLEAN
EFIAPI
JsonValueGetBoolean (
IN EDKII_JSON_VALUE Json
)
{
ASSERT (Json != NULL && JsonValueIsBoolean (Json));
if (Json == NULL || !JsonValueIsBoolean (Json)) {
return FALSE;
}
return json_is_true ((json_t *) Json);
}
/**
The function is used to retrieve the associated string in a string type JSON value.
Any changes to the returned string will impact the original JSON value.
@param[in] Json The provided JSON value.
@retval Return the associated Ascii string in JSON value or NULL on errors.
**/
CONST CHAR8*
EFIAPI
JsonValueGetString (
IN EDKII_JSON_VALUE Json
)
{
return json_string_value ((const json_t *)Json);
}
/**
The function is used to get the number of elements in a JSON object, or 0 if it is NULL or
not a JSON object.
@param[in] JsonObject The provided JSON object.
@retval Return the number of elements in this JSON object or 0.
**/
UINTN
EFIAPI
JsonObjectSize (
IN EDKII_JSON_OBJECT JsonObject
)
{
return json_object_size ((json_t *) JsonObject);
}
/**
The function is used to enumerate all keys in a JSON object.
Caller should be responsible to free the returned key array reference using
FreePool(). But contained keys are read only and must not be modified or freed.
@param[in] JsonObj The provided JSON object for enumeration.
@param[out] KeyCount The count of keys in this JSON object.
@retval Return an array of the enumerated keys in this JSON object or NULL if
JsonObj is not an JSON object, key count is zero or on other errors.
**/
CHAR8**
JsonObjectGetKeys (
IN EDKII_JSON_OBJECT JsonObj,
OUT UINTN *KeyCount
)
{
UINTN Index;
CONST CHAR8 **KeyArray;
CONST CHAR8 *Key;
EDKII_JSON_VALUE Value;
if (JsonObj == NULL || KeyCount == NULL) {
return NULL;
}
Index = 0;
json_object_foreach(JsonObj, Key, Value) {
Index++;
}
if (Index == 0) {
*KeyCount = 0;
return NULL;
}
*KeyCount = Index;
KeyArray = (CONST CHAR8 **) AllocateZeroPool (*KeyCount * sizeof (CHAR8 *));
if (KeyArray == NULL) {
return NULL;
}
Key = NULL;
Value = NULL;
Index = 0;
json_object_foreach((json_t *) JsonObj, Key, Value) {
KeyArray[Index] = Key;
Index++;
}
return (CHAR8 **)KeyArray;
}
/**
The function is used to get a JSON value corresponding to the input key from a JSON object.
It only returns a reference to this value and any changes on this value will impact the
original JSON object. If that is not expected, please call JsonValueClone() to clone it to
use.
Input key must be a valid NULL terminated UTF8 encoded string. NULL will be returned when
Key-Value is not found in this JSON object.
@param[in] JsonObj The provided JSON object.
@param[in] Key The key of the JSON value to be retrieved.
@retval Return the corresponding JSON value to key, or NULL on error.
**/
EDKII_JSON_VALUE
EFIAPI
JsonObjectGetValue (
IN CONST EDKII_JSON_OBJECT JsonObj,
IN CONST CHAR8 *Key
)
{
return (EDKII_JSON_VALUE)json_object_get ((const json_t *)JsonObj, (const char *)Key);
}
/**
The function is used to set a JSON value corresponding to the input key from a JSON object,
and the reference count of this value will be increased by 1.
Input key must be a valid NULL terminated UTF8 encoded string. If there already is a value for
this key, this key will be assigned to the new JSON value. The old JSON value will be removed
from this object and thus its' reference count will be decreased by 1.
More details for reference count strategy can refer to the API description for JsonValueFree().
@param[in] JsonObj The provided JSON object.
@param[in] Key The key of the JSON value to be set.
@param[in] Json The JSON value to set to this JSON object mapped by key.
@retval EFI_ABORTED Some error occur and operation aborted.
@retval EFI_SUCCESS The JSON value has been set to this JSON object.
**/
EFI_STATUS
EFIAPI
JsonObjectSetValue (
IN EDKII_JSON_OBJECT JsonObj,
IN CONST CHAR8 *Key,
IN EDKII_JSON_VALUE Json
)
{
if (json_object_set ((json_t *) JsonObj, Key, (json_t *) Json) != 0) {
return EFI_ABORTED;
} else {
return EFI_SUCCESS;
}
}
/**
The function is used to get the number of elements in a JSON array. Returns or 0 if JsonArray
is NULL or not a JSON array.
@param[in] JsonArray The provided JSON array.
@retval Return the number of elements in this JSON array or 0.
**/
UINTN
EFIAPI
JsonArrayCount (
IN EDKII_JSON_ARRAY JsonArray
)
{
return json_array_size ((json_t *) JsonArray);
}
/**
The function is used to return the JSON value in the array at position index. The valid range
for this index is from 0 to the return value of JsonArrayCount() minus 1.
It only returns a reference to this value and any changes on this value will impact the
original JSON object. If that is not expected, please call JsonValueClone() to clone it to
use.
If this array is NULL or not a JSON array, or if index is out of range, NULL will be returned.
@param[in] JsonArray The provided JSON Array.
@retval Return the JSON value located in the Index position or
NULL if JsonArray is not an array or no items in the array.
**/
EDKII_JSON_VALUE
EFIAPI
JsonArrayGetValue (
IN EDKII_JSON_ARRAY JsonArray,
IN UINTN Index
)
{
return (EDKII_JSON_VALUE)json_array_get ((json_t *) JsonArray, Index);
}
/**
The function is used to append a JSON value to the end of the JSON array, and grow the size of
array by 1. The reference count of this value will be increased by 1.
More details for reference count strategy can refer to the API description for JsonValueFree().
@param[in] JsonArray The provided JSON object.
@param[in] Json The JSON value to append.
@retval EFI_ABORTED Some error occur and operation aborted.
@retval EFI_SUCCESS JSON value has been appended to the end of the JSON array.
**/
EFI_STATUS
EFIAPI
JsonArrayAppendValue (
IN EDKII_JSON_ARRAY JsonArray,
IN EDKII_JSON_VALUE Json
)
{
if (json_array_append ((json_t *) JsonArray, (json_t *) Json) != 0) {
return EFI_ABORTED;
} else {
return EFI_SUCCESS;
}
}
/**
The function is used to remove a JSON value at position index, shifting the elements after index
one position towards the start of the array. The reference count of this value will be decreased
by 1.
More details for reference count strategy can refer to the API description for JsonValueFree().
@param[in] JsonArray The provided JSON array.
@param[in] Index The Index position before removement.
@retval EFI_ABORTED Some error occur and operation aborted.
@retval EFI_SUCCESS The JSON array has been removed at position index.
**/
EFI_STATUS
EFIAPI
JsonArrayRemoveValue (
IN EDKII_JSON_ARRAY JsonArray,
IN UINTN Index
)
{
if (json_array_remove ((json_t *) JsonArray, Index) != 0) {
return EFI_ABORTED;
} else {
return EFI_SUCCESS;
}
}
/**
Dump JSON to a buffer.
@param[in] JsonValue The provided JSON value.
@param[in] Flags The Index position before removement. The value
could be the combination of below flags.
- EDKII_JSON_INDENT(n)
- EDKII_JSON_COMPACT
- EDKII_JSON_ENSURE_ASCII
- EDKII_JSON_SORT_KEYS
- EDKII_JSON_PRESERVE_ORDER
- EDKII_JSON_ENCODE_ANY
- EDKII_JSON_ESCAPE_SLASH
- EDKII_JSON_REAL_PRECISION(n)
- EDKII_JSON_EMBED
See below URI for the JSON encoding flags reference.
https://jansson.readthedocs.io/en/2.13/apiref.html#encoding
@retval CHAR8 * Dump fail if NULL returned, otherwise the buffer
contain JSON paylaod in ASCII string. The return
value must be freed by the caller using FreePool().
**/
CHAR8 *
EFIAPI
JsonDumpString (
IN EDKII_JSON_VALUE JsonValue,
IN UINTN Flags
)
{
if (JsonValue == NULL) {
return NULL;
}
return json_dumps((json_t *)JsonValue, Flags);
}
/**
Load JSON from a buffer.
@param[in] Buffer Bufffer to the JSON payload
@param[in] BufferLen Length of the buffer
@param[in] Flags Flag of loading JSON buffer, the value
could be the combination of below flags.
- EDKII_JSON_REJECT_DUPLICATES
- EDKII_JSON_DISABLE_EOF_CHECK
- EDKII_JSON_DECODE_ANY
- EDKII_JSON_DECODE_INT_AS_REAL
- EDKII_JSON_ALLOW_NUL
See below URI for the JSON encoding flags reference.
https://jansson.readthedocs.io/en/2.13/apiref.html?highlight=json_loadb#decoding
@param[in,out] Error Pointer EDKII_JSON_ERROR structure
@retval EDKII_JSON_VALUE NULL means fail to load JSON payload.
**/
EDKII_JSON_VALUE
EFIAPI
JsonLoadBuffer (
IN CONST CHAR8 *Buffer,
IN UINTN BufferLen,
IN UINTN Flags,
IN OUT EDKII_JSON_ERROR *Error
)
{
return json_loadb(Buffer, BufferLen, Flags, (json_error_t *)Error);
}
/**
The reference count is used to track whether a value is still in use or not.
When a value is created, it's reference count is set to 1.
when the value is no longer needed, the reference count is decremented.
When the reference count drops to zero, there are no references left and the
value can be destroyed.
This funciton decrement the reference count of EDKII_JSON_VALUE. As soon as
a call to json_decref() drops the reference count to zero, the value is
destroyed and it can no longer be used.
@param[in] JsonValue JSON value
**/
VOID
EFIAPI
JsonDecreaseReference (
IN EDKII_JSON_VALUE JsonValue
)
{
json_decref (JsonValue);
}
/**
The reference count is used to track whether a value is still in use or not.
When a value is created, it's reference count is set to 1.
If a reference to a value is kept (e.g. a value is stored somewhere for later use),
its reference count is incremented.
This function increment the reference count of json if it's not NULL.
Returns EDKII_JSON_VALUE.
@param[in] JsonValue JSON value
@retval EDKII_JSON_VALUE of itself
**/
EDKII_JSON_VALUE
EFIAPI
JsonIncreaseReference (
IN EDKII_JSON_VALUE JsonValue
)
{
return json_incref (JsonValue);
}
/**
Returns an opaque iterator which can be used to iterate over all key-value pairs
in object, or NULL if object is empty.
@param[in] JsonValue JSON value
@retval Iterator pointer
**/
VOID *
EFIAPI
JsonObjectIterator (
IN EDKII_JSON_VALUE JsonValue
)
{
return json_object_iter (JsonValue);
}
/**
Extract the associated value from iterator.
@param[in] Iterator Iterator pointer
@retval EDKII_JSON_VALUE
**/
EDKII_JSON_VALUE
EFIAPI
JsonObjectIteratorValue (
IN VOID *Iterator
)
{
return json_object_iter_value(Iterator);
}
/**
Returns an iterator pointing to the next key-value pair in object after iter,
or NULL if the whole object has been iterated through.
@param[in] JsonValue JSON value
@param[in] Iterator Iterator pointer
@retval Iterator pointer
**/
VOID *
JsonObjectIteratorNext (
IN EDKII_JSON_VALUE JsonValue,
IN VOID *Iterator
)
{
return json_object_iter_next(JsonValue, Iterator);
}
/**
Returns the json type of this json value.
@param[in] JsonValue JSON value
@retval JSON type returned
**/
EDKII_JSON_TYPE
EFIAPI
JsonGetType (
IN EDKII_JSON_VALUE JsonValue
)
{
return ((json_t *)JsonValue)->type;
}

View File

@ -0,0 +1,86 @@
## @file
# Thirty party Jansson library for JSON operations.
#
# Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
# (C) Copyright 2020 Hewlett Packard Enterprise Development LP<BR>
#
# SPDX-License-Identifier: BSD-2-Clause-Patent
#
##
[Defines]
INF_VERSION = 0x0001001b
BASE_NAME = JsonLib
FILE_GUID = F5E36815-305A-4C5A-9D75-4F2149E45255
MODULE_TYPE = DXE_DRIVER
VERSION_STRING = 1.0
LIBRARY_CLASS = JsonLib|DXE_DRIVER UEFI_APPLICATION UEFI_DRIVER
#
# VALID_ARCHITECTURES = IA32 X64 ARM AARCH64 RISCV64
#
[Sources]
#
# Below are the source code of third
# party jansson library.
#
jansson/src/dump.c
jansson/src/error.c
jansson/src/hashtable.c
jansson/src/hashtable_seed.c
jansson/src/memory.c
jansson/src/pack_unpack.c
jansson/src/strbuffer.c
jansson/src/strconv.c
jansson/src/utf.c
jansson/src/value.c
jansson/src/version.c
#
# Below are the source of edk2 JsonLib.
#
JsonLib.c
jansson_config.h
jansson_private_config.h
#
# Below is the source code override to fix the build issue.
# Add code in load.c to conditionally use stdin according
# to HAVE_UNISTD_H macro. The PR is submitted to jansson
# open source community.
# https://github.com/akheron/jansson/pull/558
#
load.c
[Packages]
MdePkg/MdePkg.dec
MdeModulePkg/MdeModulePkg.dec
RedfishPkg/RedfishPkg.dec
[LibraryClasses]
BaseLib
BaseMemoryLib
Ucs2Utf8Lib
RedfishCrtLib
DebugLib
MemoryAllocationLib
PrintLib
UefiRuntimeServicesTableLib
UefiLib
[BuildOptions]
#
# Disables the following Visual Studio compiler warnings
# so we do not break the build with /WX option:
# C4090: 'function' : different 'const' qualifiers
# C4244: conversion from type1 to type2, possible loss of data
# C4334: 32-bit shift implicitly converted to 64-bit
# C4204: nonstandard extension used: non-constant aggregate initializer
#
# Define macro HAVE_CONFIG_H to include jansson_private_config.h to build.
# Undefined _WIN32, WIN64, _MSC_VER macros
# On GCC, no error on the unused-function and unused-but-set-variable.
#
MSFT:*_*_X64_CC_FLAGS = /wd4204 /wd4244 /wd4090 /wd4334 /DHAVE_CONFIG_H=1 /U_WIN32 /UWIN64 /U_MSC_VER
MSFT:*_*_IA32_CC_FLAGS = /wd4204 /wd4244 /wd4090 /DHAVE_CONFIG_H=1 /U_WIN32 /UWIN64 /U_MSC_VER
GCC:*_*_*_CC_FLAGS = -Wno-unused-function -Wno-unused-but-set-variable

View File

@ -0,0 +1,35 @@
=============================================================================
Introduction
=============================================================================
Jansson is a C library for encoding, decoding and manipulating JSON data.
Its main features and design principles are:
- Simple and intuitive API and data model
- Comprehensive documentation
- No dependencies on other libraries
- Full Unicode support (UTF-8)
- Extensive test suite
Jansson is licensed under the MIT license(refer to ReadMe.rst under edk2).
It is used in production and its API is stable. It works on numerous
platforms, including numerous Unix like systems and Windows. It's suitable
for use on any system, including desktop, server, and small embedded systems.
In UEFI/EDKII environment, Redfish project consumes jansson to achieve JSON
operations.
* Jansson version on edk2: 2.13.1, API reference is on the below URL,
https://jansson.readthedocs.io/en/2.13/apiref.html
* EDKII jansson library wrapper:
- JsonLib.h:
This is the denifitions of EDKII JSON APIs which are mapped to
jannson funcitons accordingly.
*Known issue:
Build fail with jansson/src/load.c, add code in load.c to conditionally
use stdin according to HAVE_UNISTD_H macro. The PR is submitted to
jansson open source community.
https://github.com/akheron/jansson/pull/558

View File

@ -0,0 +1,41 @@
/** @file This is the configuration file for building jansson library.
(C) Copyright 2020 Hewlett Packard Enterprise Development LP<BR>
SPDX-License-Identifier: BSD-2-Clause-Patent
**/
#ifndef JANSSON_CONFIG_H_
#define JANSSON_CONFIG_H_
///
/// We don't support inline JSON on edk2
///
#define JSON_INLINE
///
/// We support long long on edk2
///
#define JSON_INTEGER_IS_LONG_LONG 1
///
/// We don't support locale on edk2
///
#define JSON_HAVE_LOCALECONV 0
///
/// We don't support atomic builtins on edk2
///
#define JSON_HAVE_ATOMIC_BUILTINS 0
///
/// We don't support sync builtins on edk2
///
#define JSON_HAVE_SYNC_BUILTINS 0
///
/// Mzximum deepth is set to 2048
///
#define JSON_PARSER_MAX_DEPTH 2048
#endif

View File

@ -0,0 +1,19 @@
/** @file
Jansson private configurations for UEFI support.
Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
(C) Copyright 2020 Hewlett Packard Enterprise Development LP<BR>
SPDX-License-Identifier: BSD-2-Clause-Patent
**/
#ifndef JANSSON_PRIVATE_CONFIG_H_
#define JANSSON_PRIVATE_CONFIG_H_
#define HAVE_SYS_TIME_H 1
#define HAVE_SYS_TYPES_H 1
#define INITIAL_HASHTABLE_ORDER 3
#endif

File diff suppressed because it is too large Load Diff

View File

@ -35,7 +35,13 @@
"PrivateInclude/Crt/string.h",
"PrivateInclude/Crt/time.h",
"PrivateInclude/Library/RedfishCrtLib.h",
"PrivateLibrary/RedfishCrtLib/RedfishCrtLib.c"
"PrivateLibrary/RedfishCrtLib/RedfishCrtLib.c",
##
## For jansson library open source
## load.c is overrided from open source.
"Library/JsonLib/load.c",
"Library/JsonLib/jansson_config.h",
"Library/JsonLib/jansson_private_config.h"
]
},
"CompilerPlugin": {

View File

@ -19,6 +19,13 @@
[Includes.Common.Private]
PrivateInclude # Private header files for C RTL.
PrivateInclude/Crt # Private header files for C RTL.
Library/JsonLib # Private header files for jansson
# configuration files.
# - jansson_config.h
# - jansson_private_config.h
# jansson.h refers to above two configuration
# files for building platform jansson library.
Library/JsonLib/jansson/src # For referring to jannson.h
[LibraryClasses]
## @libraryclass Platform Redfish Host Interface Library
@ -38,6 +45,11 @@
# This library is only intended to be used by UEFI network stack modules.
RestExLib|Include/Library/RestExLib.h
## @libraryclass Provides the library functions based on third party
# jansson library to manipulate JSON data structure.
#
JsonLib|Include/Library/JsonLib.h
[LibraryClasses.Common.Private]
## @libraryclass Provides the private C runtime library functions.
# CRT library is currently used by edk2 JsonLib (open source