Changeset 73978 in vbox for trunk/include/iprt/cpp

Timestamp:

Aug 30, 2018 1:19:36 PM (7 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

124714

Message:

IPRT/rest: Fixed empty array & map handling by making the begin iteration functions return VERR_JSON_IS_EMPTY rather than letter the query method do that. Made query parameter processing table driven and made it use the right escapeing. bugref:9167

File:

• trunk/include/iprt/cpp/restbase.h (modified) (3 diffs)

trunk/include/iprt/cpp/restbase.h

@@ -303 +303 @@
         kCollectionFormat_tsv,              /**< Tab-separated list. */
         kCollectionFormat_pipes,            /**< Pipe-separated list. */
+        kCollectionFormat_multi,            /**< Special collection type that must be handled by caller of toString. */
         kCollectionFormat_Mask = 7,         /**< Collection type mask. */
 
@@ -1370 +1371 @@
 
     /**
+     * Do path parameters.
      *
      * @returns IPRT status code
@@ -1380 +1382 @@
     int doPathParameters(RTCString *a_pStrPath, const char *a_pszPathTemplate, size_t a_cchPathTemplate,
                          PATHREPLACEENTRY *a_paPathParams, size_t a_cPathParams) const;
+
+    /** Query parameter descriptor. */
+    typedef struct
+    {
+        const char                 *pszName;    /**< The parameter name. */
+        uint32_t                    fFlags;     /**< The toString flags. */
+        bool                        fRequired;  /**< Required or not. */
+    } QUERYPARAMDESC;
+
+    /**
+     * Do query parameters.
+     *
+     * @returns IPRT status code
+     * @param   a_pStrQuery         The destination string.
+     * @param   a_paQueryParams     The query parameter descriptors.
+     * @param   a_papQueryParamObjs The query parameter objects, parallel to @a a_paQueryParams.
+     * @param   a_cQueryParams      Number of query parameters.
+     */
+    int doQueryParameters(RTCString *a_pStrQuery, QUERYPARAMDESC const *a_paQueryParams,
+                          RTCRestObjectBase const **a_papQueryParamObjs, size_t a_cQueryParams) const;
 };