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

Timestamp:

Aug 28, 2018 6:09:54 PM (7 years ago)

Author:

vboxsync

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

124656

Message:

IPRT/rest: Implemented parsing json response bodies. bugref:9167

File:

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

trunk/include/iprt/cpp/restbase.h

@@ -707 +707 @@
     int getHttpStatus() { return m_rcHttp; }
 
+    /**
+     * Getter for m_pErrInfo.
+     */
+    PCRTERRINFO  getErrIfno(void) const { return m_pErrInfo; }
+
+    /**
+     * Getter for m_strContentType.
+     */
+    RTCString const &getContentType(void) const { return m_strContentType; }
+
+
 protected:
     /** Negative numbers are IPRT errors, positive are HTTP status codes. */
-    int m_rcStatus;
+    int         m_rcStatus;
     /** The HTTP status code, VERR_NOT_AVAILABLE if not set. */
-    int m_rcHttp;
+    int         m_rcHttp;
     /** Error information. */
-    PRTERRINFO m_pErrInfo;
+    PRTERRINFO  m_pErrInfo;
     /** The value of the Content-Type header field. */
-    RTCString m_strContentType;
-
-    PRTERRINFO  allocErrInfo(void);
+    RTCString   m_strContentType;
+
+    PRTERRINFO  getErrInfo(void);
     void        deleteErrInfo(void);
     void        copyErrInfo(PCRTERRINFO pErrInfo);
+
+    /**
+     * Reports an error (or warning if a_rc non-negative).
+     *
+     * @returns a_rc
+     * @param   a_rc        The status code to report and return.  The first
+     *                      error status is assigned to m_rcStatus, subsequent
+     *                      ones as well as informational statuses are not
+     *                      recorded by m_rcStatus.
+     * @param   a_pszFormat The message format string.
+     * @param   ...         Message arguments.
+     */
+    int         addError(int a_rc, const char *a_pszFormat, ...);
 
     /**
@@ -735 +759 @@
     int extractHeaderFromBlob(const char *a_pszField, size_t a_cchField, const char *a_pchData, size_t a_cbData,
                               RTCString *a_pStrDst);
+
+    /**
+     * Helper that does the deserializing of the response body.
+     *
+     * @param   a_pDst      The destination object for the body content.
+     * @param   a_pchData   The body blob.
+     * @param   a_cbData    The size of the body blob.
+     */
+    void deserializeBody(RTCRestObjectBase *a_pDst, const char *a_pchData, size_t a_cbData);
+
+    /**
+     * Primary json cursor for parsing bodies.
+     */
+    class PrimaryJsonCursorForBody : public RTCRestJsonPrimaryCursor
+    {
+    public:
+        RTCRestClientResponseBase *m_pThat; /**< Pointer to response object. */
+        PrimaryJsonCursorForBody(RTJSONVAL hValue, const char *pszName, RTCRestClientResponseBase *a_pThat);
+        virtual int addError(RTCRestJsonCursor const &a_rCursor, int a_rc, const char *a_pszFormat, ...) RT_OVERRIDE;
+        virtual int unknownField(RTCRestJsonCursor const &a_rCursor) RT_OVERRIDE;
+    };
 };
 
@@ -821 +866 @@
     virtual void doCall(RTCRestClientRequestBase const &a_rRequest, RTHTTPMETHOD a_enmHttpMethod,
                         RTCRestClientResponseBase *a_pResponse);
+
 };