DuperAgent is a QML clone of the fantastic SuperAgent library from VisionMedia.
The library is implemented in Qt/C++ and designed as an alternative to QML's builtin implementation of XmlHttpRequest.
#Features
- Modern API in comparison to XmlHttpRequest
- Support for multipart/form uploads
- Automatic parsing of response bodies with known content-types
#Limitations
- DuperAgent does not implement the XML API of XmlHttpRequest
#Docs
At the point in time, the API should be almost identical to that of SuperAgent so that documentation is recommended.
That being said, the following API additions are also available:
A function for setting global configuration options for the agent. This function should be called
once before any requests are made. It is good practice to call this from a Component.onCompleted
signal. For example:
Component.onCompleted: {
Http.request.config({
cache: false
});
}
The following is a list of supported configuration options:
This option controls the cache behavior of the agent. The default is to create a QNetworkDiskCache with
a sensible path for the platform. If you wish to disable this behavior, for example because you have your
own cache, you can set this property to false. The property can be further customized by passing an object.
Http.request.config({
cache: {
maxSize: 20000
}
});
maxSize: The maximum size of the cache
#Usage
First install the library via qpm:
qpm install com.cutehacks.duperagent
Next register the types in your main.cpp (qpm will automate this in the future):
#include "com/cutehacks/duperagent/duperagent.h"
using namespace com::cutehacks;
...
qmlRegisterSingletonType<duperagent::Request>(
"com.cutehacks.duperagent",
1, 0,
"request",
duperagent::request_provider);
Finally, import the module and start using it inside your .qml files:
import com.cutehacks.duperagent 1.0 as Http
...
Http.request
.get("http://httpbin.org/get")
.timeout(5000)
.end(function(err, res) {
console.log(res.status);
console.log(JSON.stringify(res.header, null, 4));
console.log(JSON.stringify(res.body, null, 4));
});