Quellcodevorbearbeitung - Garados007/IlarosLauncher GitHub Wiki

Inhalt

Allgemeines
Dokumentation von $

Allgemeines

Im Webserver des Launchers ist ein Bearbeitungsschritt eingebaut, der bestimmte Dateiformate nochmal extra nachbearbeitet bevor diese an die Oberfläche geschickt werden. Hier werden alle Dateien mit der Endung .js.html, .js.htm oder .jsh diesem Bearbeitungsschritt unterzogen.

Hier wird, ähnlich wie bei PHP, an bestimmten Stellen JavaScript Code ausgeführt, der die Ausgabe in vielfältiger Weise bearbeiten kann. Dieser JavaScript Code wird zwischen <?JS und ?> eingebaut. Eine Ausgabe sieht dann zum Beispiel so aus:

<!DOCTYPE html>
<html>
<body>
  <?JS
    $.w("Summe aus 1 und 2 ist " + (1 + 2));
  ?>
</body>
</html>

Dem JavaScript Code stehen alle Standardfunktionen nach dem ECMA 5.1 Standard zur Verfügung. Zusätzlich steht noch ein Objekt $ bereit, der einem weitere Funktionen zur Verarbeitung bereitstellt.

Der JavaScript Code kann auch dazu dienen um bestimmte Codeausschnitte nur unter bestimmten Bedingungen auszugeben, wie hier zu sehen ist:

<div class="login-area">
  <?JS if (userLogin) { ?>
    <div class="logout">Logout</div>
  <? } else { ?>
    <div class="login">Login</div>
  <? } ?>
</div>

Man kann sich das so vorstellen, als ob der HTML Code als spezieller JS Syntax an die jeweiligen Stellen im JavaScript Code eingebettet und nur dann ausgegeben wird, wenn die jeweilige Stelle in der Ausführung erreicht wurde.

Dokumentation von $

$.GetParam : Dictionary

$.GetParam liefert einem die Liste aller Parameter, die per GET beim Aufruf übertragen wurden. Diese Liste ist ein Dictionary<string, string> und enthält alle Methoden nach .NET.

if ($.GetParam.ContainsKey("mode"))
    $.w($.GetParam["mode"]);

$.lget(url: String) : String

Kurzschreibweise zu $.LocalGet.

$.LocalGet(url: String) : String

$.WebGet ruft die relative Url auf den aktuellen Server mittels GET auf. Der Quellcode wird hier direkt zurückgegeben. Der Aufruf erfolgt aber abgekapselt vom diesen Aufruf, so ist ein Einbinden von anderen Bibliotheken nicht möglich. Diese Methode ist schneller als $.WebGet, da die Serverklasse direkt angesprochen wird.

$.w($.LoalGet("/html/footer.js.html"));

$.Now : Date

$.Now liefert einem ein Datumsobjekt mit dem aktuellen Datum und Uhrzeit zurück.

$.w($.Now);

$.w(text: String)

Kurzschreibweise zu $.Write.

$.WebGet(url: String) : String

$.w($.WebGet("/html/footer.js.html"));

$.WebPost(url: String, value: JsObject) : String

$.WebPost ruft die relative Url auf den aktuellen Server mittels POST auf. Die Parameter werden als Objekt an value übergeben. Ist value kein Objekt, so wird $.WebGet aufgerufen. Der Quellcode wird hier direkt zurückgegeben. Der Aufruf erfolgt aber abgekapselt vom diesen Aufruf, so ist ein Einbinden von anderen Bibliotheken nicht möglich.

$.w($.WebPost("/account/", { username: "funny", password: "name" }));

$.wget(url: String) : String

Kurzschreibweise zu $.WebGet.

$.wpost(url: String, value: JsObject) : String

Kurzschreibweise zu $.WebPost.

$.Write(text: String)

$.Write schreibt den angegebenen Text direkt in den Ausgabestrom.

$.Write("Hallo Welt");

$.LauncherVersion : String

Liefert einem die aktuelle Versionsnummer des Launchers im Format x.x.x.x.

$.PackageVersion : String

Liefert einem die aktuelle Versionsnummer des gesamten Pakets im Format x.x.x.