App-MFILE-WWW
view release on metacpan or search on metacpan
lib/App/MFILE/WWW.pm view on Meta::CPAN
The L<App::MFILE::WWW> codebase has two parts, or "sides": the "Perl side"
and the "JavaScript side". The Perl side implements the embedded web server
and the JavaScript side implements the front-end application served to
browsers by the Perl side.
Control passes from the Perl side to the JavaScript side
=over
=item * B<synchronously> whenever the user (re)loads the page
=item * B<asynchronously> whenever the user triggers an AJAX call
=back
=head2 Perl side
The HTTP request-response cycle implemented by the Perl side is designed to
work approximately like this:
=over
lib/App/MFILE/WWW.pm view on Meta::CPAN
=item * if the session is expired or invalid, any incoming GET request will
cause the login dialog to be displayed.
=item * well-formed POST requests are directed to the C<process_post> routine
in L<App::MFILE::WWW::Dispatch>. In derived-distro mode, the derived distro
must provide its own dispatch module.
=item * under ordinary operation, the user will spend 99% of her time
interacting with the JavaScript code running in her browser, which will
communicate asynchronously as needed with the back-end (which must be
implemented separately) via AJAX calls.
=back
=head2 JavaScript side
The JavaScript side provides a toolkit for building web applications that
=over
lib/App/MFILE/WWW.pm view on Meta::CPAN
=item do not require the use of a mouse; and
=item look and feel very much like text terminal applications from the 1980s
=back
Developing a front-end application with L<App::MFILE::WWW> currently assumes
that you, the developer, will want to use RequireJS, jQuery, and QUnit.
The JavaScript code is modular. Each code module has its own file and
modules are loaded asynchronously by L<RequireJS|http://requirejs.org/>.
Also, jQuery and QUnit L<http://qunitjs.com/> are loaded automatically.
In addition to the above, L<App::MFILE::WWW> provides a number of primitives,
also referred to as "targets", that can be used to quickly slap together a web
application. The next chapter explains what these widgets are and how to use
them.
=head1 FRONT-END PRIMITIVES
share/js/core/populate.js view on Meta::CPAN
// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
// POSSIBILITY OF SUCH DAMAGE.
// *************************************************************************
//
// populate.js
//
// non-interactive, asynchronous population of dform entries
//
"use strict";
define ([
'jquery',
'lib',
], function (
$,
lib,
) {
share/js/core/qunit-2.4.0.js view on Meta::CPAN
if (config.blocking) {
internalRecover(this);
}
}
function runTest(test) {
promise = test.callback.call(test.testEnvironment, test.assert);
test.resolvePromise(promise);
// If the test has a "lock" on it, but the timeout is 0, then we push a
// failure as the test should be synchronous.
if (test.timeout === 0 && test.semaphore !== 0) {
pushFailure("Test did not finish synchronously even though assert.timeout( 0 ) was used.", sourceFromStacktrace(2));
}
}
},
after: function after() {
checkPollution();
},
queueHook: function queueHook(hook, hookName, hookOwner) {
var _this = this;
share/js/core/qunit.js view on Meta::CPAN
if (config.blocking) {
internalRecover(this);
}
}
function runTest(test) {
promise = test.callback.call(test.testEnvironment, test.assert);
test.resolvePromise(promise);
// If the test has a "lock" on it, but the timeout is 0, then we push a
// failure as the test should be synchronous.
if (test.timeout === 0 && test.semaphore !== 0) {
pushFailure("Test did not finish synchronously even though assert.timeout( 0 ) was used.", sourceFromStacktrace(2));
}
}
},
after: function after() {
checkPollution();
},
queueHook: function queueHook(hook, hookName, hookOwner) {
var _this = this;
share/js/core/require-2.3.5.js view on Meta::CPAN
*/
enable: function (depMap) {
var mod = getOwn(registry, depMap.id);
if (mod) {
getModule(depMap).enable();
}
},
/**
* Internal method used by environment adapters to complete a load event.
* A load event could be a script load or just a load pass from a synchronous
* load call.
* @param {String} moduleName the name of the module to potentially complete.
*/
completeLoad: function (moduleName) {
var found, args, mod,
shim = getOwn(config.shim, moduleName) || {},
shExports = shim.exports;
takeGlobalQueue();
share/js/core/require.js view on Meta::CPAN
*/
enable: function (depMap) {
var mod = getOwn(registry, depMap.id);
if (mod) {
getModule(depMap).enable();
}
},
/**
* Internal method used by environment adapters to complete a load event.
* A load event could be a script load or just a load pass from a synchronous
* load call.
* @param {String} moduleName the name of the module to potentially complete.
*/
completeLoad: function (moduleName) {
var found, args, mod,
shim = getOwn(config.shim, moduleName) || {},
shExports = shim.exports;
takeGlobalQueue();
share/js/core/start.js view on Meta::CPAN
if (entry.hasOwnProperty("populate")) {
if (typeof entry.populate === 'function') {
populateArray.push(entry.populate);
} else {
msg = "CRITICAL ERROR: bad populate property in entry " + entry.name;
throw msg;
}
}
}
// call first populate function to trigger sequential,
// asynchronous population of all entries with "populate" property
coreLib.displayResult(opts.resultLine);
if (opts.populate && populateArray.length > 0) {
populate.bootstrap(populateArray);
}
// listen for user input in form
dformListen(dfn, state, opts.inputId);
};
}, // dform
dmenu: function (dmn) {
( run in 0.636 second using v1.01-cache-2.11-cpan-0d8aa00de5b )