PS Software Engineering WS 2000/01 README Datei fuer den Prototyp erstellt von Gruppe 5 (Bartha, Edtmayr, Huskic, Wolacewicz) im WS 2000/01. Der Prototyp wurde in Java geschrieben. Er besteht aus drei Teile: - Client - Java Applet - Server - Java Applikation - Datenbank - mySQL Da das ganze in Java implementiert ist, die Zielplatformen sind alle die Java VM unterstuetzen. Es sind jedoch einige Details zu beachten. Im Folgenden wird die Beschreibung gegeben wie man Client zum Laufen bringt. CLIENT ====== Client Prototyp ist ein Java Applet, welches Socket Verbindung mit dem Server aufbauen muss damit die eingegebenen Daten in Datenbank gespeichert werden koennen. Es ist schon bekannt dass die Java Applets einige Einschraenkungen im Vergleich zu Java Applikationen haben. Diese Einschraenkungen sind eingefuehrt um Applets so sicher wie moeglich zu machen (z.B. ein Applet hat normalerweise keine Moeglichkeit auf die Festplatte zu schreiben oder eine Socket Verbindung aufzubauen). Es gibt jedoch Moeglichkeiten diese Einschraenkungen zu umgehen. Grundsaetzlich existieren zwei Methoden: - Java Laufzeit Policy anpassen - Applet certifizieren Wir haben uns fuer die erste Methode entschieden. Diese Methode setzt voraus dass man die Moeglichkeit hat java.security Datei zu editieren. Wie kann man java.security Datei editieren? Man muss die folgenden Schritte durchfuehren (Beschreibung ist jedoch nur fuer Windows Rechner, sonst ist die Prozedure dasselbe fuer anderen Rechner, wobei sich java.security Datei wo anders befindet): 1. Starten Sie einen Text-Editor 2. Oeffnen Sie die java.security Datei, die sich normalerwiese in C:\Program Files\JavaSoft\JRE\1.3\lib\security Verzeichnis befindet. Falls nicht, suchen Sie java.securtiy Datei mittels Suchen Utility auf Ihrem Rechner. 3. Suchen Sie den folgenden Text, der sich in java.security Datei befindet: # The default is to have a single system-wide policy file, # and a policy file in the user's home directory. policy.url.1=file:${java.home}/lib/security/java.policy policy.url.2=file:${user.home}/.java.policy (es kann sein, dass Sie noch einige url Eintraege haben, aber dies macht nichts) 4. Fuegen Sie den URL welcher auf policy Datei zeigt: policy.url.3=URL der Datei Damit ist alles bereit um Applet zu starten. Noch eine Sache ist zu beachten: Bevor man Applet startet bitte alle Browser Fenster schliessen und noch einmal starten, sonst erkennen die Browser neue Einstellungen in Java Runtime Enviroment nicht. SERVER ====== Um den Server zum laufen zu bringen, muss man einfach von Command Line die Klasse mServer aufrufen. Es sind keine besondere Aufrufparameter noetig. $ java mServer & Vorher sind aber folgende Einstellungen zu machen: Damit der Server ueber JDBC auf die MYSQL-Datenbank zugreifen kann muss ein geeigneter JDBC-Driver fuer die MYSQL-Datenbank installiert werden, und z.B. im File .bashrc der CLASSPATH entsprechend gesetzt werden. Gundsaetzlich kann der Driver in einem beliebigen Verzeichnis installiert werden, entscheidend ist das Setzen des CLASSPATH. z.B. export CLASSPATH=/path/to/Driver:$CLASSPATH in .bashrc Es stehen eine Reihe von JDBC-Drivers fuer MYSQL zur Verfuegung. Wir haben den Driver MM.MYSQL (verfuegbar auf www.mysql.com) verwendet. Damit der mServer auf die Datenbank nun tatsaechlich zugreifen kann muss jetzt noch das File "SelectResources.properties" das mit den mServer mitgeliefert wurde editiert werden. Aus diesem File holt sich der mServer die URL der Datenbank und den Namen des Drivers, weiters Benutzernamen und Passwort fuer den Datenbankzugriff. Hier muessen also die gueltigen Werte gesetzt werden. DATENBANK ========= Um Datenbank zu starten muss man (falls noch nicht vorhanden) MYSQL installieren und den Datenbank Server mit $ save_mysqld & starten. Fuer den Prototypen muss folgende Tabelle in der Datenbank vorhanden sein. ----------------------------------------------- | artefakt | ----------------------------------------------- | art_id | artname | farbe | material | jahr | ----------------------------------------------- END OF README FILE (letzte Aenderung: 30.01.2001)