guacamole-client/guacamole/src/main/webapp/scripts/history.js

/**
 * Set of thumbnails for each connection, indexed by ID.
 */
GuacamoleHistory = new (function() {

    /**
     * Reference to this GuacamoleHistory.
     */
    var guac_history = this;

    /**
     * The number of entries to allow before removing old entries based on the
     * cutoff.
     */
    var IDEAL_LENGTH = 6;

    /**
     * The maximum age of a history entry before it is removed, in
     * milliseconds.
     */
    var CUTOFF_AGE = 900000;

    var history = {};

    function truncate() {

        // Build list of entries
        var entries = [];
        for (var old_id in history)
            entries.push(history[old_id]);

        // Avoid history growth beyond defined number of entries
        if (entries.length > IDEAL_LENGTH) {

            // Sort list
            entries.sort(GuacamoleHistory.Entry.compare);

            // Remove entries until length is ideal or all are recent
            var now = new Date().getTime();
            while (entries.length > IDEAL_LENGTH 
                    && now - entries[0].accessed > CUTOFF_AGE) {

                // Remove entry
                var removed = entries.shift();
                delete history[removed.id];

            }

        }

    }


    /**
     * Returns the URL for the thumbnail of the connection with the given ID,
     * or undefined if no thumbnail is associated with that connection.
     */
    this.get = function(id) {
        return history[id] || new GuacamoleHistory.Entry();
    };

    /**
     * Updates the thumbnail and access time of the history entry for the
     * connection with the given ID.
     */
    this.update = function(id, thumbnail) {

        // Create updated entry
        var entry = new GuacamoleHistory.Entry(
            id,
            thumbnail,
            new Date().getTime()
        );

        // Store entry in history
        history[id] = entry;
        truncate();

        // Save updated history
        localStorage.setItem("GUAC_HISTORY", JSON.stringify(history));

    };

    /**
     * Reloads all history data.
     */
    this.reload = function() {

        // Get old and new for comparison
        var old_history = history;
        var new_history = JSON.parse(localStorage.getItem("GUAC_HISTORY") || "{}");

        // Update history
        history = new_history;

        // Call onchange handler as necessary
        if (guac_history.onchange) {

            // Produce union of all known IDs
            var known_ids = {};
            for (var new_id in new_history) known_ids[new_id] = true;
            for (var old_id in old_history) known_ids[old_id] = true;

            // For each known ID
            for (var id in known_ids) {

                // Get entries
                var old_entry = old_history[id];    
                var new_entry = new_history[id];    

                // Call handler for all changed 
                if (!old_entry || !new_entry
                        || old_entry.accessed != new_entry.accessed)
                    guac_history.onchange(id, old_entry, new_entry);

            }

        } // end onchange

    };

    /**
     * Event handler called whenever a history entry is changed.
     * 
     * @event
     * @param {String} id The ID of the connection whose history entry is
     *                    changing.
     * @param {GuacamoleHistory.Entry} old_entry The old value of the entry, if
     *                                           any.
     * @param {GuacamoleHistory.Entry} new_entry The new value of the entry, if
     *                                           any.
     */
    this.onchange = null;

    // Reload when modified
    window.addEventListener("storage", guac_history.reload, false);

    // Initial load
    guac_history.reload();

})();

/**
 * A single entry in the indexed connection usage history.
 * 
 * @constructor
 * @param {String} id The ID of this connection.
 * @param {String} thumbnail The URL of the thumbnail to use to represent this
 *                           connection.
 * @param {Number} last_access The time this connection was last accessed, in
 *                             seconds.
 */
GuacamoleHistory.Entry = function(id, thumbnail, last_access) {

    /**
     * The ID of the connection associated with this history entry.
     */
    this.id = id;

    /**
     * The thumbnail associated with the connection associated with this history
     * entry.
     */
    this.thumbnail = thumbnail;

    /**
     * The time the connection associated with this entry was last accessed.
     */
    this.accessed = last_access;

};
 
GuacamoleHistory.Entry.compare = function(a, b) {
    return a.accessed - b.accessed;
};