The .webcalls File Format
The .webcalls File Format

Files with the .webcalls extensions contain webAppOS web calls declarations in Java properties format containing name/value pairs, e.g.,

name=value
name\ with\ spaces=value with spaces
#comment

Each web call declaration must be in the form:

[modifiers] [action-name]=[web-call-adapter]:[adapter-specific-location]
Here

Comments in the Natural Docs syntax can be used to generate documentation.

Example
##
# Function: getAppPropertiesByFullName
# Returns some properties of the given app.
#
# Parameter:
# appFullName - full app name
#
# Returns:
# a JSON object... or {}, if no app corresponds to the given full app name;
public\ static\ webappos.getAppPropertiesByFullName(appFullName)=staticjava:org.webappos.webcalls.AppsActions_webcalls#getAppPropertiesByFullName
Modifiers

There are only 2 possible modifiers to specify the calling conventions:

jsoncall

(default) a string or a JSON is passed as an argument, a JSON is always returned;

webmemcall

a web memory object (or its reference) is passed as an argument, nothing is returned.

When the calling convention modifier is not specified, jsoncall is assumed.

Additional optional modifiers are:

static

denotes a web call that requires an authenticated user session, but do not require an MRAM slot;

public

(must include also static) denotes a web call that neither requires an authenticated user, nor an MRAM slot;

inline

denotes a web call that should be executed by the bridge directly, without passing it to web processors and then to a web call adapter;

single

denotes a client-side web call, which, being invoked at the server side, will be synchronized only with the user, who originated the parent web call; other users connected to the same MRAM slot will not receive the call.

If no additional optional modifiers specified, the web call will be non-static (requiring an MRAM slot), private (requiring an authenticated user), non-inline (will be passed to a web processor) and non-single (will be synchronized with all users connected to the same MRAM slot).

Location of .webcalls Files

.webcalls files are searched by webAppOS in the following directories: