Projekt:2021/MyMail: Unterschied zwischen den Versionen
Jneug (Diskussion | Beiträge) Keine Bearbeitungszusammenfassung |
Jneug (Diskussion | Beiträge) |
||
| Zeile 37: | Zeile 37: | ||
| <code>void close()</code> | | <code>void close()</code> | ||
| Die Verbindung wird getrennt und kann nicht mehr verwendet werden. | | Die Verbindung wird getrennt und kann nicht mehr verwendet werden. | ||
|} | |||
=== Die Klasse MyMailGUI === | |||
MyMailGUI ist die Haupt-View des Programms. Beim Start des Programms wird eine GUI erstellt und mit der Hauptklasse des Programms verknüpft. Das Programm kann die GUI über diese Methoden verändern: | |||
{| class="wikitable" | |||
| <code>setStatus( String pStatus )</code> | |||
| Zeigt den Text in der Statusleiste am unteren Rand an. | |||
|- | |||
| <code>setError( String pStatus )</code> | |||
| Zeigt den Fehlertext in der Statusleiste am unteren Rand an. | |||
|- | |||
| <code>addMailToList( Mail pMail )</code> | |||
| Fügt ein Mail-Objekt der GUI hinzu. | |||
|- | |||
| <code>addMailsToList( Mail[] pMails )</code> | |||
| Fügt alle Mails im Array der GUI hinzu. | |||
|- | |||
| <code>addMailsToList( List<Mail> pMails )</code> | |||
| Fügt alle Mails der Liste der GUI hinzu. | |||
|- | |||
| <code>removeMailFromList( Mail pMail )</code> | |||
| Entfernt die übergebene Mail aus der GUI, falls sie vorher hinzugefügt wurde. | |||
|- | |||
| <code>clearAllMails()</code> | |||
| Entfernt alle Mails aus der GUI. | |||
|} | |} | ||
Version vom 17. Januar 2022, 00:41 Uhr
Seite zum Projekt MyMail des Informatik LK im Schuljahr 2021/22.
Projekt MyMail
Implementiere einen POP3 Mail-Client.
Links
- MyMail Git-Repository
- Adresse zum Klonen:
https://git.ngb.schule/IF-LK-2020/mymail.git
- Adresse zum Klonen:
- rfc1939: Post Office Protocol - Version 3
- rfc2822: Internet Message Format
Dokumentationen
Die Klasse Connection
Objekte der Klasse Connection ermöglichen eine Netzwerkverbindung mit dem TCP/IP-Protokoll. Es können nach Verbindungsaufbau zu einem Server Zeichenketten (Strings) gesendet und empfangen werden. Zur Vereinfachung geschieht dies zeilenweise, das bedeutet, beim Senden einer Zeichenkette wird ein Zeilentrenner (NL, "new line") ergänzt und beim Empfangen wird er wieder entfernt.
Eine Fehlerbehandlung, zum Beispiel ein Zugriff auf eine bereits geschlossene Verbindung, ist in dieser Klasse aus Gründen der Vereinfachung nicht vorgesehen.
Connection(String pServerIP, int pServerPort)
|
Es wird eine Verbindung zum durch IP-Adresse und Portnummer angegebenen Server aufgebaut, so dass Daten gesendet und empfangen werden können. |
void send(String pMessage)
|
Die angegebene Nachricht pMessage wird - um einen Zeilentrenner (NL) erweitert - an den Server versandt.
|
String receive()
|
Es wird auf eine eingehende Nachricht vom Server gewartet und diese Nachricht zurückgegeben, wobei der vom Server angehängte Zeilentrenner entfernt wird. Während des Wartens ist der ausführende Prozess blockiert. Das bedeutet, es werden erst weitere Befehle ausgeführt, wenn eine vollständige Zeile empfangen wurde. |
void close()
|
Die Verbindung wird getrennt und kann nicht mehr verwendet werden. |
Die Klasse MyMailGUI
MyMailGUI ist die Haupt-View des Programms. Beim Start des Programms wird eine GUI erstellt und mit der Hauptklasse des Programms verknüpft. Das Programm kann die GUI über diese Methoden verändern:
setStatus( String pStatus )
|
Zeigt den Text in der Statusleiste am unteren Rand an. |
setError( String pStatus )
|
Zeigt den Fehlertext in der Statusleiste am unteren Rand an. |
addMailToList( Mail pMail )
|
Fügt ein Mail-Objekt der GUI hinzu. |
addMailsToList( Mail[] pMails )
|
Fügt alle Mails im Array der GUI hinzu. |
addMailsToList( List<Mail> pMails )
|
Fügt alle Mails der Liste der GUI hinzu. |
removeMailFromList( Mail pMail )
|
Entfernt die übergebene Mail aus der GUI, falls sie vorher hinzugefügt wurde. |
clearAllMails()
|
Entfernt alle Mails aus der GUI. |