LaSSiE ActionScript-Referenz

Die LaSSiE ActionScript-Referenz wird momentan komplett für die Version 3.0.2 überarbeitet. Wir bitten um etwas Geduld. Zwischenzeitlich stehen wir für Fragen zur Verwendung von LaSSiE gerne zur Verfügung.

Allgemeine Informationen zur Verwendung von LaSSiE v3.0.2

Lesen und schreiben von Dateien erfordert bei Verwendung von Sonderzeichen in Textdateien die nicht im Unicode Format gespeichert sind mit Adobe® Flash die Systemeinstellung System.useCodePage=true; zum Beispiel mit Dateien im UTF-8 Format. Auf eine allgemeine Voreinstellung wurde aber verzichtet, um Dateien mit der herkömmlichen Codepage des Betriebssystems verwenden zu können.

Die benötigten LaSSiE Server Scripte stehen als Einzeldateien (Pakete) zur Verfügung, um Funktionen je nach Anforderung verwenden zu können, insbesondere Funktionen die dem Sicherheitsaspekt unterliegen, wie das Löschen von Dateien, oder starten von Anwendungen (voreingestellt nur mit einem lokalen Webserver).

LaSSiE v3.0.2 wurde den Programmiermethoden von ActionScript 3 angeglichen, und verwendet für alle Methoden, die ein Server Ergebnis erhalten, die Event-Klasse LaSSiEDataEvent mit dem Ereignis comlete. Eine Ausnahme bildet die Klasse LocalDatabase, die keine Serververbindung benötigt. Der Rückgabewert einer LaSSiE Anweisung kann mit der Ereignisfunktion über die Eigenschaft result vom Objekt data ermittelt werden. Wir sehen das am Beispiel zum lesen und schreiben einer einfachen Textdatei.

Lesen einer Textdatei

import flash.api.*;
myLaSSiE.system.readTextFile("info.txt");
myLaSSiE.system.loaderInfo.addEventListener(LaSSiEDataEvent.COMPLETE, completeHandler);
function completeHandler(event:LaSSiEDataEvent):void {
   trace(event.data.result);
}

Der Bezeichner der Ereignisfunktion completeHandler der Methode readTextFile ist frei wählbar. Der Inhalt der Datei info.txt wird hier in der Eigenschaft result empfangen, und im Beispiel anschließend als Rückgabewert mit trace(event.data.result); ausgegeben.

Schreiben einer Textdatei

import flash.api.*;
myLaSSiE.system.writeTextFile("LaSSiE Version 3.0.2 ist fertig!", "info.txt");
myLaSSiE.system.loaderInfo.addEventListener(LaSSiEDataEvent.COMPLETE, completeHandler);
function completeHandler(event:LaSSiEDataEvent):void {
   trace("Die Datei wurde geschrieben!");
}

Mass der EventListener COMPLETE für das LaSSiEDataEvent mit der Ergebnisfunktion completeHandler später nicht wieder entfernt werden, kann der EventListener auch dem Objekt mit hinzugefügt werden.

import flash.api.*;
myLaSSiE.system.writeTextFile("LaSSiE Version 3.0.2 ist fertig!", "info.txt");
myLaSSiE.system.addEventListener(LaSSiEDataEvent.COMPLETE, completeHandler);
function completeHandler(event:LaSSiEDataEvent):void {
   trace("Die Datei wurde geschrieben!");
}

Die Verwendung der Ergebnisfunktionder Methode writeTextFile ist darüber hinaus optional und muss nicht verwendet werden. Diese dient im Beispiel mit trace("Die Dateit wurde geschrieben!"); zur Kontrolle, wann die Datei info.txt geschrieben wurde.

import flash.api.*;
myLaSSiE.system.writeTextFile("info.txt", "LaSSiE Version 3.0.2 ist fertig!");

LaSSiE-Komponente

Alle Eigenschaften, Methoden und Objekte der LaSSiE-Klassen stehen der LaSSiE-Komponente direkt zur Verfügung, und können über den Instanznamen die LaSSiE-Instanz erreicht werden, nachdem die Komponente auf die Bühne gezogen, und der Instanzname im Fenster Eigenschaften eingetragen wurde. Weitere Informationen zur Einrichtung und Verwendung der LaSSiE-Komponente finden Sie unter LaSSiE-Komponente einrichten oder LaSSiE-Komponente verwenden.

flash.api

Das Paket flash.api wird zusammen mit der LaSSiE-Komponente bereitgestellt und benötigt keine externen Klassendateien. Darin befindet sich die Basisklasse LaSSiE, sowie alle Methoden, Eigenschaften, Konstanten und Ereignisse, die LaSSiE v3.0.2 zur Verfügung stehen, wie die Funktionen für die Serververbindung in der Klasse flash.api.LaSSiE_server. Das flash.api-Paket ethält weitere Klassen, dazu gehören:

 •  Die ActionScript 3.0-Komponentenklassen (flash.api.LaSSiE_cookie, flash.api.LaSSiE_database,
flash.api.LaSSiE_local, flash.api.LaSSiE_mail, flash.api.LaSSiE_security, flash.api.LaSSiE_system)
 •  Eine ActionScript 3.0-Klasse für die lokale Datenbanverarbeitung (flash.api.LocalDatabase)

Um mit der LasSiE-Komponente arbeiten zu können ist es ausreichend das Paket mit import flash.api.*; bereitzustellen. Jede Klasse im flash.api-Paket kann einzeln verwendet werden, das sollte aber nur von erfahrenen Entwicklern genutzt werden, die mit der objektorientierten Programmierung vertraut sind. Es wird empfohlen mit den Objekten der Komponenten-Instanz zu arbeiten. Eine Ausnahme bildet auch hier die Klasse LocalDatabase, bei der für die Arbeit mehrere Objekte mit new LocalDatabase(); benötigt werden können. Die oberste Ebene (Top-Level) enthält alle ActionScript-Hauptklassen.

  Klasse (Basisklasse) Beschreibung
  LaSSiE Die LaSSiE-Basisklasse für die Implementierung der LaSSiE-Komponente enthält zusätzlich Objekte aller LaSSiE Server und Local Script Klassen.
  LaSSiEData Die LaSSiE-Basisklasse, die für die Arbeit mit verschiedenen Datentypen und Datenbanken verwendet wird.
  LaSSiEDataEvent Der Adobe® Flash Player sendet ein LaSSiEDataEvent-Objekt, nachdem eine Server Aktion ausgeführt oder Daten vollständig geladen wurden.
  Klassen (Server Script) Beschreibung
  LaSSiE_cookie Die LaSSiE-Hauptklasse für die Verwendung von serverseitigen Cookies.
  LaSSiE_database Die LaSSiE-Hauptklasse für die Verwendung von LaSSiE-Datenbanken.
  LaSSiE_mail Die LaSSiE-Hauptklasse zum Versenden einer E-Mail.
  LaSSiE_security Die LaSSiE-Hauptklasse für die Datensicherheit.
  LaSSiE_system Die LaSSiE-Hauptklasse für die Verwendung von Systemfunktionen.
  Klassen (Local Script) Beschreibung
  LaSSiE_local Die LaSSiE-Hauptklasse für die Verwendung von LaSSiE-Datenbanken bei denen keine serverseitige Programmierung benötigt wird (nur lesen).
  LocalDatabase Die LaSSiE-Hauptklasse für die lokale Verarbeitung von LaSSiE-Datenbanken.

Allgemeines

Bedienung

 


LaSSiE wird weiterentwickelt
und verbessert. Unterstützen
Sie unsere Arbeit für Ihren
eigenen Vorteil!