Banana-Coding.com - Java Knuddels Emulator

Ich möchte euch ein wenig erklären, wie ihr den Banana-Chat Emulator bearbeitet, erstellt und verwendet.

Voraussetzungen:
- Banana-Chat Server (Download)
- Banana-Chat Client (Download )
- Java Runtime Environment (Download)
- Java Development Kit + NetBeans IDE (Download)
- XAMPP (Download)

1. Java JRE und JDK + NetBeans
Ihr müsst hier eigentlich nichts anderes machen, als JRE (Java Runtime Evironment) und JDK (Java Development Kit) + NetBeans (obiger Download-Link ist ein Paket aus beiden Anwendungen!) herunterzuladen und zu installieren, dann ist dieser Schritt auch schon erledigt und wir können mit dem nächsten weiter machen.

2. XAMPP
XAMPP ist ein Web-Server für Windows (sowie Linux), welcher die Pakete apache, MySQL und PHP bereits vorinstalliert hat, sodass diese direkt nach der Installation verwendet werden können.
Die Installation von XAMPP ist eigentlich relativ simple, ihr müsst zu allererst Eure Sprache auswählen, anschliessend werdet ihr gefragt, welche Zusatzpakete ihr Installieren möchtet, hier müsst ihr einen Haken bei "Apache" und "MySQL" setzen und könnt dann direkt mit der Installation fortfahren.
Diese wird einige Minuten dauern, es öffnen sich zwischendurch CMD-Konsolen, welche Apache2 und MySQL richtig installieren.
Sobald die Installation abgeschlossen ist, startet ihr das "XAMPP Control Panel", falls es noch nicht gestartet wurde und setzt einen Haken bei "Apache" und bei "MySQL", falls noch keiner dort gesetzt ist. Danach müsst ihr auf Start klicken, falls dort noch nicht in Grün "Running" steht. Hier kann es ein wenig dauern, bis der Dienst gestartet wurde.
Nun solltet ihr auf http://127.0.0.1/ in eurem Browser kommen, beim ersten Aufrufen müsst ihr eure Sprache auswählen, danach findet ihr links im Menü die Links zu phpMyAdmin, welches wir später noch gebrauchen werden.

Geht nun in den Installationsordner (nachfolgend XAMPP_WEBFOLDER genannt) und wählt htdocs aus sodass ihr euch im Ordner XAMPP_FOLDER\htdocs befindet. Nun entpackt ihr den aus den Voraussetzungen gedownloadeten Banana-Chat Client in eurem XAMPP_FOLDER\htdocs Ordner, sodass dort ein neuer Ordner mit dem Namen "bananachat" existiert.
Beachtet, wenn ihr den Ordnernamen verändert, müsst ihr in der "index.html" vom Banana-Emulator im Applet-Bereich bei codebase den Link ebenfalls verändern.

Geht nun auf euren Desktop und erstellt dort einen neuen Ordner mit dem Namen "bananachat" (nachfolgend BC_FOLDER genannt).

3. Banana-Emulator Datenbanktechnisch einrichten
Damit der Banana-Emulator auch läuft, müssen wir eine Datenbank einrichten, dass geht, indem ihr in eurem Browser auf "http://127.0.0.1/phpmyadmin" geht und Euch einloggt. Als Benutzername verwendet ihr "root", das Passwort-Feld lasst ihr leer, weil wir keines gesetzt haben, lokal ist dies auch nicht von nöten.
Nun sind wir eingeloggt und sehen eine Übersicht der Datenbanken (links) und darüber ein kleines Menü mit einem Häuschen, EXIT, SQL, ?-Help und SQL-Help - klickt hier nun auf den dritten Menüpunkt, also dem weißem Schild mit dem "SQL".
Es öffnet sich direkt ein neues Fenster, mit einem weiteren Menü, aus diesem wählt ihr oben links "Dateiimport" dort wiederrum wählt ihr "Durchsuchen" und geht in eurem BC_FOLDER Ordner, wo euch direkt eine database.sql ins Auge sticht, diese müsst ihr auswählen. Ist dies erledigt, klickt ihr auf OK (Zeichensatz kann so bleiben).
Nun wird im vorher geöffneten phpMyAdmin der Status des Vorganges ausgegeben, es sollte ohne Probleme ausgeführt werden und links solltet ihr nun die Datenbank "bananachat" finden, wählt diese aus mit einem Klick darauf.

Für die nachfolgenden Beschreobungen in diesem Punkt müsst ihr wieder oben links in phpMyAdmin "SQL" mit dem weißen Schild auswählen, dieses mal allerdings im geöffneten Fenster auf dem Tab "SQL" lassen. Ausserdem MÜSST ihr die Datenbank "bananachat" ausgewählt haben.

Account erstellen (NICKNAME und PASSWORT bitte ersetzen mit euren Wunsch-Daten!) Code:
Rang ändern (NICKNAME ersetzen!) Code:Erklärung: Es gibt im Banana-Emulator insgesamt 4 voreingebaute Ränge, unteranderem 0 = Mitglied, 1 = VIP, 2 = Moderator und 3 = Administrator. Im Beispiel wird der Rang 3, also für Administrator gesetzt.

Geschlecht ändern (NICKNAME ersetzen!) Code:Erklärung: Wie auch im normalen Leben gibt es hier keine Angabe, männlich und weiblich. Um das Geschlecht auf "keine Angabe" zu ändern, tragt bei "gender" eine 0 ein, um es auf männlich zu setzten eine 1, für weiblich eine 2.

Registrationsdatum ändern (NICKNAME ersetzen!) Code:Erklärung: Um die Registrationszeit zu verändern, musst du das Datum im Format "YYYY-mm-dd HH:ii:confused:s" angeben, also steht die 1970 für das jeweilige Jahr, die 01 für den Monat, die 02 für den Tag, 03 für die Stunde, 04 für die Minute und 05 für die Sekunden. Ein Beispiel wäre z.B. für den 01.02.2012 um 22:40:30 -> "2012-02-01 22:40:30"

Statistiken ändern (NICKNAME ersetzen!) Code:Erklärung: Um die Werte von einem gewünschten Nicknamen zu verändern, musst du statt dem "`kisses`" deinen gewünschten Wert einsetzen, es gibt hier unteranderem "`knuddels`" und "`onlineTime`" (biitte die Minutenzahl * 60 nehmen), um den Wert auf einen beliebigen zu setzen, einfach die 100 mit deinem Wunsch-Wert ersetzen.

Channel erstellen (Wunsch-Daten ersetzen!) Code: Erklärung: Um dem Channel einen eigenen Namen zu geben, füge diesen bei NAME ein, um die maximale Channelgröße festzulegen, füge diese bei SIZE ebenfalls ein. Um ein Channel-TOPIC zu setzen, mache dies bei TOPIC. Auf die Einstellung eines Channel-Styles oder Hintergrundes gehe ich erst einmal nicht ein, dies wird später eventuell folgen.

Smileys erstellen (Wunsch-Daten ersetzen!) Code: Erklärung: Um einen eigenen Smiley in den Chat einzufügen, musst du erst einmal die Bild-Datei in XAMPP_FOLDER\htdocs\bananachat\pics einfügen, damit diese gefunden wird. Um eine eigene Zeichenfolge für den zu erstellenden Smiley zu setzen, schreibe diesen bei CODE hin. Bei IMAGE musst du den Pfad zur Bilddatei eingeben, dies ist ungefähr "pics/BILD.gif".

WICHTIG: Damit diese Änderungen auch im Chat übernommen werden, muss der Server neugestartet werden. Es kann durchaus sein, dass der Server beim Verändern von Statistiken aus sein muss, da bei jedem Logout eines Mitgliedes die Statistiken mit denen überschrieben werden, die während des im Chat eingeloggt sein gesammelt wurden (die Daten werden immer erst nach einem Logout richtig in der Datenbank gespeichert, vorher werden sie im Server zwischengespeichert!) Also um Datenverluste zu vermeiden, immer den Server vorher ausschalten.
Flav hat hier auch schon einen netten Befehl eingebaut, nämlich "/shutdown". Dieser Befehl hat die Wirkung, dass die gesammelten Daten im Server vor dem Ausschalten des Servers noch in der Datenbank gespeichert werden. Dies vermeidet Datenverluste, wenn man den Server direkt so schliesst.

4. Die "database.properties"
Diese Datei befindet sich im BC_FOLDER Ordner. In dieser Datei werden die Datenbank-Verbindungsinformationen gespeichert. Damit der Server läuft, müsst ihr diese mit euren Daten anpassen. Bei einer normalen XAMPP-Installation ohne gesetztes Passwort für MySQL muss hier soweit nichts verändert werden. Sollte ihr jedoch einen anderen Datenbank-Namen gewählt habem, so erkläre ich euch diese Datei nochmal ein wenig.
Wenn ihr einen anderen Datenbanknamen gewählt habt, müsst ihr in dieser Datei unter "url" das "bananachat" mit eurem Datenbank-Namen ersetzen. Unter "user" müsst ihr euren MySQL-Benutzernamen eintragen, dies ist bei uns "root". Unter "password" müsst ihr euer MySQL-Passwort eintragen, wir haben keines gesetzt, also bleibt dieses Feld leer.

5. NetBeans IDE - Source laden
Nach der Installation von NetBeans startet ihr dieses Programm, klickt oben links auf "File", wählt dort "New Project". Anschliessend öffnet sich ein neues Fenster, dort müsst ihr bei Categories "Java" und bei Projects dann "Java Project with Existing Sources", klickt dann auf "Next". Bei Project Name schreibt ihr "bananachat" hinein. Bei Project Folder euer Verzeichnis, wo ihr das Projekt speichern wollt, nun wieder auf "Next" klicken.
Nun kommen wir zum Schritt, wo wir den Source des Banana-Emulators auswählen müssen, klicke dazu im oberen Feld auf "Add Folder" und wähle aus dem XAMPP_FOLDER\htdocs\bananachat bananachat den Ordner "src" aus, klickt auf "Öffnen" und danach auf "Finish".
Das Projekt ist nun geladen worden, und ihr könnt es links im Menü auswählen, die Sources sind alle unter "Source Packages" in 4 Kategorien aufgeteilt. Wählt eure gewünschte aus, anschliessend seht ihr die darin enthaltenen .java-Dateien, welche ihr direkt bearbeiten könnt.

6. NetBeans IDE - Source kompilieren
Nachdem der Source geladen wurde könnt ihr euren Source kompilieren, dies gilt ebenfalls, wenn ihr Änderungen vorgenommen habt und diese übernehmen wollt. Hierzu geht ihr in NetBeans oben im Menü auf "Run" und anschliessend auf "Build Project (F11)" oder "Clean and Build Project (Umschalt + F11)", den genauen Unterschied weiß ich auch nicht. Ist ja auch egal.
Im Projektordner den ihr beim Source laden definiert habt befindet sich ein Ordner mit dem Namen "dist", in diesem befindet sich ebenfalls der Server, den ihr zum Starten benötigt. Kopiert den Ordner "dist" in euren BC_FOLDER, wo sich die "start.bat" befindet und startet diese. Der Server sollte nun ohne Probleme laufen und ihr könnt euch einloggen!