Monatsarchive: Juni 2009

Ich hatte das eigentlich schon länger vor aber ich kam bis jetzt noch nicht dazu. Im Januar habe ich geschrieben, dass ich ein Projekt gestartet habe, womit es dem Benutzer möglich ist seine gesammten Adressen in einem Programm zu verwalten.

Der weitere Sinn hinter diesem Projekt ist es, dass ich meine Java Fertigkeiten verbessern möchte bzw neue erlernen will. In diesem Projekttagebuch werde ich in gewissen Abständen über den Status von AMS berichten. Screen´s oder auch Code Schnipsel sind nicht ausgeschloßen ^^

Fangen wir mal an… Die GUI von AMS ist beinah fertig.

Das ist der Hauptdialog von AMS. Wenn ihr das Bild genauer betrachten wollt, müsst ihr nur drauf klicken ^^ Ich habe die GUI in 5 wesentliche Teile aufgeteilt. Links oben erkennt man das Suchfeld. Mit diesem Feld soll es möglich sein, dass der Benutzer gezielt nach einer Adresse suchen kann. Unter dem Suchfeld befindet sich ein Verzeichnisbaum. Im Bild erkennt man aber nur den Wurzel Knoten. Dort kannt der Benutzer manuell nach bestimmten Adressen suchen ^^

Ganz oben erkennt man ein kleines Menü. Auf der rechten Seite befindet sich der Hauptdialog. Dieser dient lediglich dafür neue Adressen anzulegen und ist jeweils in drei Tabs unterteilt. Unter dem Hauptdialog befindet sich dann noch die Navigation des Programmes ^^

Bisher funktioniert aber noch nicht die gesammte GUI. Das Suchfeld, das Hauptmenü und die beiden Tabs “Geschäftliche Addresse und Sonstiges” müssen noch implementiert werden. Außerdem muss ich noch eine Funktion einbauen, die die Adress-Daten anzeigt, wenn der Benutzer im Baum auf ein Element klickt, eine Funktion, die Adressen löschen kann und eine, die das Bearbeiten von Adressen ermöglicht. Viel zu tun ^^ Exception handling muss ich auch noch machen. Ja gut, sollte man eigentlich direkt am Anfang machen, ja ich weiß.. Wenn das alles fertig ist, kann ich ein Beta Release bauen.

Das schwierigste bisher war das speichern von neuen Adressen und die direkte Aktualisierung des Baumes, wenn eine Adresse gespeichert worden ist.

In dem zweiten Bild, habe ich ein paar Test daten eingefügt um zu demonstrieren, dass der Baum aktualisiert wird, wenn man eine neue Adresse anlegt. Dabei habe ich mir gedacht, dass der linke Baum so aufgebaut wird, dass alle Nachnamen als oberstes Element dargestellt werden und zu jedem Nachname die verschiedenen Vornamen hinzugefügt werden. So ist es einfacher und schneller eine Adresse zu finden und sieht besser aus ^^ Der Baum ist außerdem so aufgebaut, dass er automatisch erkennt wo die Adressen hin gehören. Dafür müssen das Feld Vor und Nachname zu einem Pflichtfeld werden. Sonst klappt die Zuordnung nicht.

Die Adressen werden bis jetzt als XML Format gespeichert. Weitere Formate stehen noch offen.

Ein Beispiel:
Show ▼

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<adressen>
    <adresse nachname="Mustermann">
        <vorname>
            <city>Musterstadt</city>
            <country>Deutschland</country>
            <email>m.mustermann@muster.de</email>
            <fax_number>40344550</fax_number>
            <firstname>Max</firstname>
            <homepage>www.muster.de</homepage>
            <lastname>Mustermann</lastname>
            <mobile_number>14586869</mobile_number>
            <phone_number>53346500</phone_number>
            <plz>30580</plz>
            <state>Nordrhein-Westfalen</state>
            <street>Musterstraße</street>
        </vorname>
    </adresse>
</adressen>

An diesem Beispiel kann man deutlich erkennen wie das gesammte Datenmodell aufgebaut ist. alle Adressen werden in Vorname und Nachname unterteilt um die obige beschriebene Funktionalität zu gewährleisten.

Wird das Programm beendet und neu gestartet, wird die vorige erzeugte XML Datei automatisch eingelesen und der Baum mit dem Inhalt aktualisiert. Wobei mir da grad noch einfällt, dass ich den Pfad zu der XML Datei konfigurierbar machen muss oO naja ne Kleinigkeit ^^

Für das erzeugen der XML Datei habe ich JAXB verwendet. Hier mal die Klasse, die das bei mir regelt:
Show ▼

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

public class DialogTreeContentBuilder {
 
	static AddressList addresses = new AddressList();
 
	public static void serialize() {
 
		JAXBContext context = null;
		Writer w = null;
 
		try {
			w = new OutputStreamWriter(new FileOutputStream("addressdb.xml"), "UTF-8");
			context = JAXBContext.newInstance(AddressList.class, AddressTopic.class, Address.class);
			Marshaller m = context.createMarshaller();
			m.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, Boolean.TRUE);
 
			if(InitDialog.addresses == null)
				m.marshal(addresses, w);
			else
				m.marshal(InitDialog.addresses, w);
 
		} catch (JAXBException e) {
			System.err.println("Die Adressen konnten nicht im XML Format gespeichert werden");
			e.printStackTrace();
		} catch (IOException e) {
			System.err.println("Die generierte XML Datei konnte nicht lokal gespeichert werden");
			e.printStackTrace();
		} finally {
			try {
				w.close();
			} catch (IOException e) {
				System.err.println("Beim Schließen der XML Datei ist ein Fehler aufgetreten");
				e.printStackTrace();
			}
		}
	}
 
	public static AddressList deserialize() {
		JAXBContext context = null;
		Unmarshaller m = null;
		AddressList addresses = null;
 
		try {
			context = JAXBContext.newInstance(AddressList.class, AddressTopic.class, Address.class);
			m = context.createUnmarshaller();
			addresses = (AddressList) m.unmarshal(new FileInputStream("addressdb.xml"));
		} catch (JAXBException e) {
			System.err.println("Die XML Datei mit den jeweiligen Adressen konnten nicht gelesen werden");
			e.printStackTrace();
		} catch (FileNotFoundException e) {
			System.err.println("Die XML Datei mit den jeweiligen Adressen konnte nicht gefunden werden");
			e.printStackTrace();
		}
		return addresses;
	}
}

Sieht eigentlich ziemlich simpel aus. Nur musste ich bei der serialize Methode von der Zeile 16 bis 19 noch eine Abfrage einbauen. Dort frage ich ab, ob schon eine XML Datei mit den Adressen existiert, wenn nicht mach ne neue, wenn ja, dann benutz die alten + neuen Daten und überschreibe die vorhandene XML Datei.^^

Hier noch die Methoden, die ich geschrieben habe um das Datenmodell zu aktualisieren. Dieser Part hat irgendwie am längsten gedauert..
Show ▼

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

private static void updateAddressDataModel(Address newAddress) {
		boolean flag = true;
		//Überprüfe, ob Adressen im Datenmodell vorhanden sind
		if (InitDialog.addresses.getAddressList() != null) {
			// Ãœber alle Nachnamen iterieren
			for (int i = 0; i < InitDialog.addresses.getAddressList().size(); i++) {
				// Nachname vorhanden? Dann Speicher neue Addresse unter diesen Nachnamen
				if (InitDialog.addresses.getAddressList().get(i).getNachname().equals(newAddress.getLastname())) {
					List<address> currentAddresses = InitDialog.addresses.getAddressList().get(i).getAddressList();
					currentAddresses.add(newAddress);
					flag = true;
					break;
				} else {
					//Nachname nicht vorhanden, neuen anlegen
					flag = false;
				}
			}
			if(flag !=true) {
				createNewAddresses(newAddress, true);
			}
		} else {
			createNewAddresses(newAddress, false);
		}
	}
 
	private static void  createNewAddresses(Address newAddress, Boolean flag) {
		// Liste der nachnamen holen
		List<addressTopic> currentLastNames;
 
		if(flag == false)
			currentLastNames = new ArrayList<addressTopic>();
		else
			currentLastNames = InitDialog.addresses.getAddressList();
 
		// neuer nachname anlegen
		AddressTopic nachname = new AddressTopic();
		nachname.setNachname(newAddress.getLastname());
 
		// neue Adress Liste anlegen, da keine vorhanden
		List<address> newAddressList = new ArrayList<address>();
 
		// Adresse hinzufügen
		newAddressList.add(newAddress);
 
		// neue Liste zur oberen hinzufügen
		nachname.setAddressList(newAddressList);
 
		// nachname zur top ebene
		currentLastNames.add(nachname);
		InitDialog.addresses.setAddressList(currentLastNames);
	}

In Zeile 4 muss ich erst prüfen, ob Adressen im Datenmodell vorhanden sind. Ist das nicht der Fall wird in Zeile 22 die Methode createNewAddresses() aufgerufen um eine neue Adresse zu erzeugen. Sind Adressen vorhanden wird in Zeile 6 über alle Nachnamen iteriert. Danach wird in Zeile 8 geprüft, ob der eingebene Nachname bereits im Datenmodell vorhanden ist. Ist dieser vorhanden wird in den Zeilen bis zum else Zweig die neue Adresse unter diesem Nachnamen erzeugt.

Sollte der Nachname aber nicht vorhanden sein, muss ein neuer erzeugt werden wo anschließend die neue Adresse gespeichert werden kann. Dies erfolgt von der Zeile 18 bis 20. Wieder wird die Methode createNewAddresses() in Zeile 19 aufgerufen.

Ich Übergebe der Methode createNewAddresses() einen boolean Parameter. Dies hat den folgenden Grund. Ich hatte beim aktualisieren des Datenmodelles das Problem, dass alle Einträge doppelt erschienen sind. Ich muss beim aktualiseren des Modelles immer prüfen, ob schon Nachnamen vorhanden sind. Sind keine vorhanden werden in Zeile 31 einfach neue angelegt. Sind welche vorhanden werden in Zeile 33 die aktuellen Nachnamen geholt und damit weiter gearbeitet ^^

So, ich denke, dass für den ersten Projekttagebuch Eintrag genug Informationen sind. Ich freue mich schon auf den nächsten Eintrag und auf den ersten Release von AMS, der in paar Wochen erfolgen wird

Vielen Dank fürs durch lesen. Kommentare sind gerne gesehen ^^