Class AOT

java.lang.Object
   |
   +----java.awt.Component
           |
           +----java.awt.Container
                   |
                   +----java.awt.Panel
                           |
                           +----java.applet.Applet
                                   |
                                   +----AOT

public class AOT
extends Applet

Variable Index

 o access_mode
Zugriffs-Modus (siehe Applet-Parameter 3 "Access")
 o Aot
es gibt immer genau ein Applet
 o aotframe
Frame "simuliert" im Standalone-Modus den Browser
 o APPLET_NAME
 o APPLET_NAME_ABBREVIATION
 o application
optionales Frame zur "anwendungsartigen" Darstellung des Applets (resizeable, Pulldown-Menue usw.)
 o BROWSER_Navigator
 o BUFFERED_PAINTING
 o CATEGORIES_FILE_TYPE
Dateiendung "Baum"
 o clipboard
Zwischenablage (ein Extra-Baum)
 o clipboard_frame
Fenster, in dem optional das Clipboard dargestellt wird
 o config
 o COPYRIGHT
 o current_browser
interner HTML-Viewer-Kontext (nur falls external_html_viewer=false)
 o current_directory
 o DEVELOPER
 o doc_file
 o document
Baum (Modell und Darstellung)
 o dummy
einige AWT-Methoden benoetigen unter Motif immer irgendein first-level Fenster als Bezug
 o external_html_viewer
HTML-Viewer als externen Prozess oder per class jb (immer fuer Java 1.0.2!)
 o force_cntrl_swap
 o form_mode
Schalter: Formular-Modus (siehe Applet-Parameter 6 "Form")
 o frame_mode
Darstellungs-Modus (siehe Applet-Parameter 4 "Frame")
 o GUI_Windows
 o history_list
 o history_list_pos
 o host
URL des Hosts.
 o host_port
Port beim Host zur Kommunikation via communicate_with_host()
 o html_proc
 o html_viewers
(relevant wenn external_html_viewer=true) HTML-Viewer (z.B.
 o initial_height
vert.
 o initial_width
horiz.
 o INTERPRETER_Jview
 o java_102
folgende Werte sind leider sehr wichtig in einigen Situationen:
 o m_fStandAlone
 o m_param1
Baumtext-Datei, falls diese nicht in der Kommandozeile angegeben wurde
 o m_param10
 o m_param2
Selektionstext-Datei, falls diese nicht in der Kommandozeile angegeben wurde
 o m_param3
Steuerung der Zugriffsbeschraenkung, falls Parameter nicht in der Kommandozeile angegeben wurde
 o m_param4
Aufrufmodus (als Fenster(yes) oder in HTML-Seite(no)), falls Parameter nicht in der Kommandozeile angegeben wurde
 o m_param5
Datei mit Endanwender-Selektion
 o m_param6
Formularmodus (als Fenster(yes) oder in HTML-Seite(no)), falls Parameter nicht in der Kommandozeile angegeben wurde
 o m_param7
Host-Port
 o m_param8
URL von Pseudo-Host (wird nur gebraucht, wenn Cats sich nicht im Applet-Modus befindet)
 o m_param9
Erzwingt einen Windows-aehnlichen Darstellungsmodus unter Motif (noetig bei neueren Java-Builds)
 o MODIFY_MESSAGE
 o online_documentation
 o PARAM_Param1
Parameter-Schluessel:
 o PARAM_Param10
 o PARAM_Param2
 o PARAM_Param3
 o PARAM_Param4
 o PARAM_Param5
 o PARAM_Param6
 o PARAM_Param7
 o PARAM_Param8
 o PARAM_Param9
 o secure
Sicherheitsmodus: wenn true, unterbleiben einige sicherheitsrelevanten Aktionen.
 o SELECTION_FILE_TYPE
Dateiendung "Selektion"
 o SELECTION_MODIFY_MESSAGE
 o SUPERUSER
access_mode-Schluessel "voller Zugriff"
 o title
 o toggle_insertion
schaltet zwischen Embedded- und Application-Modus um im Embedded-Modus ist das Haupt-Dokument in die HTML-Seite eingebettet, andernfalls ins application-Frame
 o USER
access_mode-Schluessel "Abfrage" (Endanwender)
 o user_file_operation_LOAD_CAT
Operationstypen fuer Funktion user_file_operation()
 o user_file_operation_LOAD_SEL
 o user_file_operation_MESSAGE
 o user_file_operation_SAVE_CAT
 o user_file_operation_SAVE_SEL
 o user_selection_file
Datei fuer Endanwender-Selektionen (Parameter 5)
 o VERSION
 o wait
"Bitte warten" Dialog fuer Startup-Phase

Constructor Index

 o AOT()
dieser Konstruktor oeffnet noch kein Dokumenten-Fenster.

Method Index

 o action(Event, Object)
 o communicate_with_host(String[])
Internet Client-Server-Verbindung zum Applet-Host aufbauen und Daten uebertragen.
 o destroy()
wird nach stop() vom Browser aufgerufen
 o detach_document()
Umkehrung zu insert_document()
 o get_document()
Liefert aktuelles Hauptdokument
 o get_tree()
liefert die Textdarstellung ("Quellcode") des Baums im Hauptdokument
 o get_URL(String)
Datei zu Datei oder URL in Stringform (lokal bzw.
 o get_URL(String, boolean, boolean)
Datei zu Datei oder URL in Stringform (lokal bzw.
 o getAppletInfo()
diese Infos koennen nicht alle Browser lesen:
 o GetParameter(String, String[])
Eintrag der Parameter, die in der HTML-Seite oder der Kommandozeile (Standalone-Variante) stehen
 o getParameterInfo()
diese Tabelle kann nicht jeder Browser lesen:
 o GetParameters(String[])
 o init()
wird vom AWT und ggf.
 o inquire_filename(String, String, int)
Dateiauswahlbox anzeigen
 o inquire_filename(String, String, int, Frame)
 o inquire_filename(String, String, int, Frame, String)
type ist die Dateiendung der zu erfragenden Datei (z.B.
 o insert_document(boolean)
(re-)integriert Haupt-document in die HTML-Seite
 o is_java_102()
 o java_version()
 o load_selection(String)
 o load_tree(String)
Uebersetzung eines Und-/Oder-Baums (zeigt im Dokumentenfenster einen neuen Und-/Oder-Baum an)
 o main(String[])
nur relevant fuer Standalone-Version (sonst init())
 o on_quit(boolean)
falls warn=true, prueft on_quit(), ob das Dokument gesichert werden muss andernfalls erfolgte diese Pruefung schon in class QuitDialog
 o online_help(String)
 o online_help(String, String)
Dokumentation anzeigen bzw.
 o open(Document, String, boolean)
Laed neues Anwender-Dokument, fordert ggf.
 o paint(Graphics)
 o print_info(boolean, boolean)
 o read(String, boolean)
Liest Datei/URL-Inhalt (MIME: plain text) in einen Zwischenpuffer Relative Dateipfade beziehen sich auf current_directory.
 o save(String, String, boolean)
Speichert einen String content als Datei.
 o set_dir(String)
wechselt in das Verzeichnis der Datei filename
 o set_title(String)
 o start()
Aufruf wenn HTML-Seite mit Applet (erneut) sichtbar wird; zeitgleich startet auch der einzige Thread; vgl.
 o stop()
Webseite mit Aot wird geschlossen
 o user_file_operation(int, String, Document, boolean, boolean)
Anwender nach Dateinamen fragen und Datei speichern/laden
 o user_file_operation(int, String, Document, boolean, boolean, boolean)
Anwender nach Dateinamen fragen und Datei speichern/laden

Variables

 o APPLET_NAME_ABBREVIATION
 public static String APPLET_NAME_ABBREVIATION
 o APPLET_NAME
 public static String APPLET_NAME
 o COPYRIGHT
 public static final String COPYRIGHT
 o DEVELOPER
 public static final String DEVELOPER
 o VERSION
 public static final String VERSION
 o CATEGORIES_FILE_TYPE
 public static final String CATEGORIES_FILE_TYPE
Dateiendung "Baum"

 o SELECTION_FILE_TYPE
 public static final String SELECTION_FILE_TYPE
Dateiendung "Selektion"

 o initial_width
 private static int initial_width
horiz. Ausdehnung des Applets in der HTML-Seite (Aenderungen sind auch in deren Quelltext vorzunehmen)

 o initial_height
 private static int initial_height
vert. Ausdehnung des Applets in der HTML-Seite (Aenderungen sind auch in deren Quelltext vorzunehmen)

 o PARAM_Param1
 private static final String PARAM_Param1
Parameter-Schluessel:

 o PARAM_Param2
 private static final String PARAM_Param2
 o PARAM_Param3
 private static final String PARAM_Param3
 o PARAM_Param4
 private static final String PARAM_Param4
 o PARAM_Param5
 private static final String PARAM_Param5
 o PARAM_Param6
 private static final String PARAM_Param6
 o PARAM_Param7
 private static final String PARAM_Param7
 o PARAM_Param8
 private static final String PARAM_Param8
 o PARAM_Param9
 private static final String PARAM_Param9
 o PARAM_Param10
 private static final String PARAM_Param10
 o USER
 public static final int USER
access_mode-Schluessel "Abfrage" (Endanwender)

 o SUPERUSER
 public static final int SUPERUSER
access_mode-Schluessel "voller Zugriff"

 o user_file_operation_LOAD_CAT
 public static final int user_file_operation_LOAD_CAT
Operationstypen fuer Funktion user_file_operation()

 o user_file_operation_SAVE_CAT
 public static final int user_file_operation_SAVE_CAT
 o user_file_operation_LOAD_SEL
 public static final int user_file_operation_LOAD_SEL
 o user_file_operation_SAVE_SEL
 public static final int user_file_operation_SAVE_SEL
 o user_file_operation_MESSAGE
 public static final String user_file_operation_MESSAGE[]
 o MODIFY_MESSAGE
 public static final String MODIFY_MESSAGE
 o SELECTION_MODIFY_MESSAGE
 public static final String SELECTION_MODIFY_MESSAGE
 o online_documentation
 static String online_documentation
 o external_html_viewer
 static boolean external_html_viewer
HTML-Viewer als externen Prozess oder per class jb (immer fuer Java 1.0.2!)

 o html_viewers
 static String html_viewers[]
(relevant wenn external_html_viewer=true) HTML-Viewer (z.B. Web-Browser) zur Anzeige der Dokumentation. Fuer %s wird ueberall die URL der anzuzeigenden Seite eingesetzt:

 o title
 private static String title
 o doc_file
 static URL doc_file
 o html_proc
 private static Process html_proc
 o current_browser
 static jb current_browser
interner HTML-Viewer-Kontext (nur falls external_html_viewer=false)

 o host_port
 private static int host_port
Port beim Host zur Kommunikation via communicate_with_host()

 o host
 private static String host
URL des Hosts. Wenn nicht im Applet-Modus, wird die Vorgabe hier verwendet

 o java_102
 public static boolean java_102
folgende Werte sind leider sehr wichtig in einigen Situationen:

 o GUI_Windows
 public static boolean GUI_Windows
 o BROWSER_Navigator
 public static boolean BROWSER_Navigator
 o INTERPRETER_Jview
 public static boolean INTERPRETER_Jview
 o force_cntrl_swap
 public static boolean force_cntrl_swap
 o config
 public static int config
 o m_fStandAlone
 public boolean m_fStandAlone
 o BUFFERED_PAINTING
 public boolean BUFFERED_PAINTING
 o m_param1
 private String m_param1
Baumtext-Datei, falls diese nicht in der Kommandozeile angegeben wurde

 o m_param2
 private String m_param2
Selektionstext-Datei, falls diese nicht in der Kommandozeile angegeben wurde

 o m_param3
 private int m_param3
Steuerung der Zugriffsbeschraenkung, falls Parameter nicht in der Kommandozeile angegeben wurde

 o m_param4
 private String m_param4
Aufrufmodus (als Fenster(yes) oder in HTML-Seite(no)), falls Parameter nicht in der Kommandozeile angegeben wurde

 o m_param5
 private String m_param5
Datei mit Endanwender-Selektion

 o m_param6
 private String m_param6
Formularmodus (als Fenster(yes) oder in HTML-Seite(no)), falls Parameter nicht in der Kommandozeile angegeben wurde

 o m_param7
 private int m_param7
Host-Port

 o m_param8
 private String m_param8
URL von Pseudo-Host (wird nur gebraucht, wenn Cats sich nicht im Applet-Modus befindet)

 o m_param9
 private String m_param9
Erzwingt einen Windows-aehnlichen Darstellungsmodus unter Motif (noetig bei neueren Java-Builds)

 o m_param10
 private String m_param10
 o access_mode
 int access_mode
Zugriffs-Modus (siehe Applet-Parameter 3 "Access")

 o frame_mode
 boolean frame_mode
Darstellungs-Modus (siehe Applet-Parameter 4 "Frame")

 o form_mode
 boolean form_mode
Schalter: Formular-Modus (siehe Applet-Parameter 6 "Form")

 o user_selection_file
 String user_selection_file
Datei fuer Endanwender-Selektionen (Parameter 5)

 o current_directory
 static String current_directory
 o document
 Document document
Baum (Modell und Darstellung)

 o clipboard
 Document clipboard
Zwischenablage (ein Extra-Baum)

 o wait
 public InfoDialog wait
"Bitte warten" Dialog fuer Startup-Phase

 o history_list
 private Vector history_list
 o history_list_pos
 private int history_list_pos
 o application
 public ApplicationFrame application
optionales Frame zur "anwendungsartigen" Darstellung des Applets (resizeable, Pulldown-Menue usw.)

 o clipboard_frame
 ClipboardFrame clipboard_frame
Fenster, in dem optional das Clipboard dargestellt wird

 o aotframe
 AOTFrame aotframe
Frame "simuliert" im Standalone-Modus den Browser

 o toggle_insertion
 private Button toggle_insertion
schaltet zwischen Embedded- und Application-Modus um im Embedded-Modus ist das Haupt-Dokument in die HTML-Seite eingebettet, andernfalls ins application-Frame

 o Aot
 public static AOT Aot
es gibt immer genau ein Applet

 o dummy
 static Frame dummy
einige AWT-Methoden benoetigen unter Motif immer irgendein first-level Fenster als Bezug

 o secure
 static boolean secure
Sicherheitsmodus: wenn true, unterbleiben einige sicherheitsrelevanten Aktionen.

Constructors

 o AOT
 public AOT()
dieser Konstruktor oeffnet noch kein Dokumenten-Fenster. Dies muss mit init() bewerkstelligt werden

Methods

 o open
 public static void open(Document document,
                         String filename,
                         boolean any_input)
Laed neues Anwender-Dokument, fordert ggf. vorher zur Datensicherung auf. (= Document.open() plus Sicherheitsabfrage)

 o get_document
 public Document get_document()
Liefert aktuelles Hauptdokument

 o load_selection
 public void load_selection(String filename)
 o GetParameter
 String GetParameter(String strName,
                     String args[])
Eintrag der Parameter, die in der HTML-Seite oder der Kommandozeile (Standalone-Variante) stehen

 o GetParameters
 void GetParameters(String args[])
 o print_info
 static void print_info(boolean sysinfo,
                        boolean m_fStandAlone)
 o main
 public static void main(String args[])
nur relevant fuer Standalone-Version (sonst init())

 o is_java_102
 static boolean is_java_102()
 o java_version
 static String java_version()
 o init
 public void init()
wird vom AWT und ggf. von main() beim ersten Aufruf des Applets aufgerufen. init() erzeugt ein Dokumentenfenster aus einer Datei mit der Textdarstellung eines Und-/Oder-Baums. Vorher muss das Applet natuerlich mit dem Konstruktor AOT() eingerichtet werden. Exemplarisch ist die Verwendung von init() in main() zu sehen.

Overrides:
init in class Applet
 o getAppletInfo
 public String getAppletInfo()
diese Infos koennen nicht alle Browser lesen:

Overrides:
getAppletInfo in class Applet
 o getParameterInfo
 public String[][] getParameterInfo()
diese Tabelle kann nicht jeder Browser lesen:

Overrides:
getParameterInfo in class Applet
 o user_file_operation
 static void user_file_operation(int type,
                                 String defname,
                                 Document document,
                                 boolean flag1,
                                 boolean flag2)
Anwender nach Dateinamen fragen und Datei speichern/laden

 o user_file_operation
 static void user_file_operation(int type,
                                 String defname,
                                 Document document,
                                 boolean flag1,
                                 boolean flag2,
                                 boolean any_input)
Anwender nach Dateinamen fragen und Datei speichern/laden

 o inquire_filename
 static String inquire_filename(String message,
                                String type,
                                int operation)
Dateiauswahlbox anzeigen

 o inquire_filename
 static String inquire_filename(String message,
                                String type,
                                int operation,
                                Frame parent)
 o inquire_filename
 static String inquire_filename(String message,
                                String type,
                                int operation,
                                Frame parent,
                                String directory)
type ist die Dateiendung der zu erfragenden Datei (z.B. "*.cat") oder ein vollstaendiger, vorzugebender Dateinamen. operation ist FileDialog.SAVE oder FileDialog.LOAD

 o set_dir
 static void set_dir(String filename)
wechselt in das Verzeichnis der Datei filename

 o get_URL
 static URL get_URL(String filename)
Datei zu Datei oder URL in Stringform (lokal bzw. auf Host) oeffnen.

 o get_URL
 static URL get_URL(String filename,
                    boolean just_try,
                    boolean print_info)
Datei zu Datei oder URL in Stringform (lokal bzw. auf Host) oeffnen. just_try=true: keine Fehlermeldungen anzeigen, wenn die Datei nicht gefunden wurde

 o read
 static String read(String filename,
                    boolean per_URL)
Liest Datei/URL-Inhalt (MIME: plain text) in einen Zwischenpuffer Relative Dateipfade beziehen sich auf current_directory. Es wird nur ASCII-Zeichencode unterstuetzt, kein Unicode. change_dir=true: in das Verzeichnis von filename wird gewechselt (nur per_URL)

 o save
 static void save(String filename,
                  String content,
                  boolean per_URL)
Speichert einen String content als Datei. Relative Dateipfade beziehen sich auf current_directory. Es wird z.Zt. nur ASCII-Zeichencode unterstuetzt, kein Unicode. change_dir=true: in das Verzeichnis von filename wird gewechselt

 o communicate_with_host
 String communicate_with_host(String process[])
Internet Client-Server-Verbindung zum Applet-Host aufbauen und Daten uebertragen. Protokoll: CATTP 1.0 (siehe Quellcode-Dokumentation cats_doc.html)

 o set_title
 void set_title(String filename)
 o on_quit
 void on_quit(boolean warn)
falls warn=true, prueft on_quit(), ob das Dokument gesichert werden muss andernfalls erfolgte diese Pruefung schon in class QuitDialog

 o get_tree
 public String get_tree()
liefert die Textdarstellung ("Quellcode") des Baums im Hauptdokument

 o load_tree
 public void load_tree(String text)
Uebersetzung eines Und-/Oder-Baums (zeigt im Dokumentenfenster einen neuen Und-/Oder-Baum an)

 o destroy
 public void destroy()
wird nach stop() vom Browser aufgerufen

Overrides:
destroy in class Applet
 o paint
 public void paint(Graphics g)
Overrides:
paint in class Container
 o start
 public void start()
Aufruf wenn HTML-Seite mit Applet (erneut) sichtbar wird; zeitgleich startet auch der einzige Thread; vgl. stop()

Overrides:
start in class Applet
 o stop
 public void stop()
Webseite mit Aot wird geschlossen

Overrides:
stop in class Applet
 o action
 public boolean action(Event e,
                       Object arg)
Overrides:
action in class Component
 o insert_document
 void insert_document(boolean detached)
(re-)integriert Haupt-document in die HTML-Seite

 o detach_document
 void detach_document()
Umkehrung zu insert_document()

 o online_help
 static void online_help(String page)
 o online_help
 static void online_help(String page,
                         String content)
Dokumentation anzeigen bzw. Seite anzeigen (content!=null: statt Datei/URL page den String content anzeigen)