rwmtse
commented
12 years ago The Invocation Framework takes the following attributes in an invoke target request, none of the attributes are required:
- source: Identifier of invocation target to which the receiver can send results. Omitting the source attribute implies that the sender does NOT support results
- target: Identifier of target to which invocation should be delivered. Required for bound invocation.
- action: Identifier of action to be performed by target. Required for bound invocation (as a matter of convention).
- type: MIME type of data to be acted on. If the mime type is not specified then invocation framework would attempt to infer the mime type from the given URI. If the mime type can not be inferred or URI field is empty then invocation will be rejected. Unbound invocations must provide either a MIME type or a URI or both.
- uri: URI pointing to invocation data. If no URI is provided then this implies the data://local URI indicating that the invocation data is provided in-band in the data field of the invocation message. Unbound invocations must provide either a MIME type or a URI or both.
- data: Data to be acted upon, can be binary data or a string. (WebWorks client code would encode the field into base64 string before sending XHR to server side)
Bound Invocation - example 1
blackberry.invoke.invoke({
target: "sys.browser", // in order to know what target & action to specify, the developer needs to first call blackberry.invoke.queryTargets() to find out the possible targets * actions (to be designed)
action: "bb.action.VIEW",
uri: "http://www.rim.com"
}, function (error) {
if (error) {
console.log(error);
}
});Unbound Invocation - example 1
blackberry.invoke.invoke({
uri: "http://www.rim.com"
}, function (error) {
if (error) {
console.log(error);
}
});Unbound Invocation - example 2
blackberry.invoke.invoke({
uri: "file://accounts/1000/shared/camera/IMG_000000001.jpg",
action: "bb.action.OPEN"
}, function (error) {
if (error) {
console.log(error);
}
});Unbound Invocation - example 3
blackberry.invoke.invoke({
type: "image/png"
data: <blob>
}, function (error) {
if (error) {
console.log(error);
}
});Unbound Invocation - example 4
blackberry.invoke.invoke({
type: "text/plain"
data: "a string"
}, function (error) {
if (error) {
console.log(error);
}
});
nukulb
EricLeiLi
kwallis
ronalag
dansilivestru
tohman
@kwallis @nukulb @cdelcol @EricLeiLi @tohman Please take a look at this client API design for bound and unbound invocation: http://wikis.rim.net/display/bbxwebworks/Client+API+to+allow+WebWorks+app+to+invoke+other+apps