Erstellen einer Namespace-ähnlichen Organisation in einer Google Apps-Skriptbibliothek

Question

Ich habe versucht, mithilfe von Google Apps-Skript ein Toolset zu erstellen. Das Problem dabei ist, dass, soweit ich das beurteilen kann, nur eine Organisationsebene erlaubt ist. Sie können eine Bibliothek namens Stoppuhr erstellen und die Methoden Stoppuhr.start() und Stoppuhr.stop() aufrufen, was ziemlich cool ist.

Was ich im Sinn hatte, war etwas mehr wie Utils.Stopwatch(). Start() und Utils.Timer.start() usw. Ich denke, es ist sicherlich in Javascript möglich, aber immer brechen Apps Script Autocomplete Funktion muss es in einem bestimmten Format hinzugefügt werden. Unten ist ein Beispiel, das es falsch macht (gibt einen Fehler), aber vielleicht spart etwas Zeit. Es basiert auf this Artikel.

/** 
* A stopwatch object. 
* @return {Object} The stopwatch methods 
*/ 
function Stopwatch() 
{ 
    var current; 

    /** 
    * Stop the stopwatch. 
    * @param {Time} time in miliseconds 
    */ 
    function timeInSeconds_(time) 
    { 
    return time/1000; 
    } 

    return 
    { 
     /** 
     * Start the stopwatch. 
     */ 
     start: function() 
     { 
     var time = new Date().getTime(); 
     current = timeInSeconds_(time); 
     }, 

     /** 
     * Stop the stopwatch. 
     * @return {decimal} time passed since calling 
     * start (in seconds) 
     */ 
     stop: function() 
     { 
     var time = new Date().getTime(); 
     var difference = timeInSeconds_(time) - this.current; 
     return difference.toFixed(3); 
     } 
    }; 
} 

Dank

Answer 1

Sie Feature-Anfragen hier einreichen: OO

http://code.google.com/p/google-apps-script-issues/issues/list

Answer 2

Was ist mit?

Es sieht sehr gut organisiert und es ist einfach zu dokumentieren.

/** 
* A stopwatch Class. 
* 
* @constructor 
*/ 
function Stopwatch() { 
    this.current = new Date().getTime(); 
} 

/** 
* Starts the stopwatch 
*/ 
Stopwatch.prototype.start = function(){ 
    this.current = new Date().getTime(); 
}; 

/** 
* Stops the stopwatch 
* 
* @return {number} Number of seconds since Stopwatch was started 
*/ 
Stopwatch.prototype.stop = function(){ 
    return ((new Date().getTime()) - this.current)/1000; 
}; 

Beispiel. Falls Ihre Lib als Utils importiert wird.

var s = new Utils.Stopwatch(); 
s.start(); 

// (...) 

Logger.log(s.stop()); 

PS: Dies ist ungetesteter Code.

Als Nebeneffekt mehrere Stoppuhren haben könnte, die Aufrechterhaltung jeder seine eigene lokale Variable ist current

UPDATE

Obwohl dies korrekt folgende JSDoc dokumentiert ist es zur Zeit nicht die Methoden, mit Google nicht automatisch vervollständigen Apps-Skript

Answer 3

Es funktioniert noch nicht, aber das Team weiß es. Bis dahin müssen Sie Ihre Bibliotheken auf einer Website dokumentieren. Ich denke du könntest die Methoden auch in die Beschreibung einbringen. Es ist wirklich ein toller Start für den neuen Service, aber ich war mit dir etwa 5 Minuten in und wollte schon mehr. ;)

Answer 4

Bis diese Funktionalität von Google nativ unterstützt wird, können Sie leere Funktionen mit Annotationen auf derselben Ebene wie Ihre Konstruktorfunktion definieren. Sie können sogar Ihre ursprüngliche Codestruktur beibehalten. Dies würde die automatische Vervollständigung im Editor ermöglichen. Außerdem erhalten Sie automatisch generierte Dokumentation für Ihre Bibliothek, z. https://script.google.com/macros/library/versions/d/YOUR_PROJECT_KEY

Beispiel:

/** 
* Constructor. 
* @constructor 
* @param {String} apiKey Doxument API key 
* @param {String} apiToken Doxument API token 
*/  
function DoxumentApi(apiKey, apiToken) { 
    // public api 
    return { 
     get: function(id, params) { 
      var httpResponse = execute('/docs/' + id + '.json?' + buildQuery(params)); 
      return parse(httpResponse); 
     } 
    } 
} 

/** 
* Get document record. 
* @param {String} id document id 
* @param {Object=} params optional. extra get params 
* @return {Object} Document object 
*/  
function get(id, params) {}