Benutzer-Werkzeuge

Webseiten-Werkzeuge


Seitenleiste

Kommunikation und Netzwerk

k24:k24.5:start

24.5.0 Komponente gb.net.pop3

Die Komponente POP3Client (gb.net.pop3) stellt Ihnen über ihre Eigenschaften und Methoden alles zur Verfügung, um im Online-Modus

  • unter Berücksichtigung der geforderten Verbindungssicherheit und Authentifikationsmethode eine Verbindung zu einem POP3-Server aufzubauen und zu halten,
  • sich Status-Meldungen zur Verbindung anzufordern,
  • die Anzahl der im Postfach vorhandenen EMails abzurufen,
  • eine Übersicht der im Postfach vorhandenen EMails abzurufen,
  • EMails aus dem Postfach auf dem POP3-Server herunterzuladen,
  • EMails im Postfach auf dem POP3-Server zu löschen oder
  • eine bestehende TCP/IP-Verbindung zu einem POP3-Server zu trennen.

Beachten Sie:

Die Komponente stellt Ihnen keinen Parser für den Inhalt einer herunter geladenen EMail zur Verfügung, um den Inhalt einer EMail – eingeschlossen deren Anhänge – anzuzeigen!

24.5.0.1 Eigenschaften

Die Klasse POP3Client verfügt über diese Eigenschaften:

EigenschaftDatentypBeschreibung
HostStringSetzt den POP3-Server oder gibt den Server zurück.
PortStringSetzt den Port, der beim Verbinden zum POP3-Server verwendet wird oder gibt den verwendeten Port zurück. Wird kein Port angegeben, so wird dieser in Abhängigkeit von der gesetzten Verbindungssicherheit automatisch gesetzt. Für eine SSL-Verbindung ist der Port 995 und für eine Plain-Text-Verbindung 110.
UserStringSetzt den Benutzernamen, der zur Identifizierung verwendet wird oder gibt diesen Benutzernamen zurück.
PasswordStringGibt das Passwort zurück, das zur Authentifizierung verwendet wird oder setzt das Passwort. Es kann nicht mehr verändert werden, wenn eine Verbindung zum POP3-Server besteht.
StatusIntegerGibt den Status der POP3Client-Verbindung zum POP3-Server zurück. Ein Fehler bei der Authentifizierung wird mit Net.CannotAuthenticate (-16) quittiert. Konnte eine POP3Client-Verbindung zum POP3-Server fehlerfrei hergestellt werden, so wird der Status Net.Connected (7) zurückgegeben und der Server wartet auf Befehle nach dem POP3-Protokoll oder schließt nach einem TimeOut die Verbindung.
EncryptIntegerMit Net.None (0) wird keine Verschlüsselung der Verbindung zwischen POP3-Client und POP3-Server verwendet. Eine Verschlüsselung der Verbindung (SSL-Tunnel) zwischen POP3-Client und POP3-Server wird mit der Konstanten Net.SSL (1) signalisiert.
CountIntegerGibt die Anzahl der EMails im Postfach des POP3-Servers zurück.
SizeIntegerGibt die Größe aller EMails im Postfach des POP3-Servers zurück (Einheit: Byte).
DebugBooleanSetzt den Debug-Modus oder gibt den Modus zurück. Für den Wert 'True' können alle Anfragen an den Server und die Server-Antworten in einem eigenen Format angezeigt werden.
WelcomeStringGibt eine spezielle Nachricht zurück, die der POP3-Server nach der erfolgreichen Verbindungsaufnahme an den POP3-Client sendet.

Tabelle 24.5.0.1.1 : Eigenschaften der Klasse Pop3Client

Ausschnitt der Ausgaben in der Konsole der Gambas-IDE für den Wert Pop3Client.Debug = True:

gb.net.pop3: Connecting to 195.004.092.211
gb.net.pop3: Authenticating...
gb.net.pop3: Sending: USER meinUsername ' Bei FREENET gilt: Username = komplette EMail-Adresse
gb.net.pop3: +OK user ok
gb.net.pop3: Sending: PASS *****************
gb.net.pop3: +OK 4 messages (23445 octets).
gb.net.pop3: OK

24.5.0.2 Methoden

Die Klasse POP3Client besitzt diese Methoden:

1x1MethodeRückgabetypBeschreibung
Open( )BooleanVerbindet den PO3-Client mit dem POP3-Server und authentifiziert den Client. Die Funktion gibt True zurück, wenn die Verbindung erfolgreich hergestellt werden konnte und die Authentifizierung erfolgreich war.
Close( ) BooleanAbmeldung vom POP3-Server und trennen der Verbindung zwischen Client und Server.
Abort( )-Abbruch der Verbindung und Trennung vom POP3-Server. Das Postfach wird unberührt gelassen. Bereits zum Löschen markierte EMails werden wiederhergestellt (Rollback).
List( )String[ ]Die Funktion gibt ein String-Array zurück, das mit List()[0]) die aktuelle Nummer und mit List()[1] die Größe jeder EMail im Postfach enthält.
ListUniqueID( )String[ ]Die Funktion gibt ein String-Array zurück, das die eindeutige Kennung (UID) jeder Nachricht auf dem Server enthält. Eine eindeutige UID identifiziert eine Nachricht eindeutig und bleibt über mehrere Sitzungen erhalten. Die UID ist eine server-definierte Zeichenfolge und der RFC (https://tools.ietf.org/html/rfc1939#page-12) gibt kein Format für sie an. Verlassen Sie sich nicht auf ein Muster für die UID, dem Sie auf einem bestimmten Server begegnen.
Ping( )BooleanDie Funktion sendet den Befehl NOOP (no operation) an den POP3-Server, um den Status der Verbindung zu prüfen und aufrecht zu halten. Sie sollten einen Zeitgeber verwenden, um eine plötzliche Unterbrechung zu vermeiden.
Remove ( Index As Integer )-Löscht die über das Argument 'Index' ausgewählte EMail im Postfach, wobei die EMail jedoch nur als zu löschende EMail markiert wird. Das Argument 'Index' ist der (fortlaufend nummerierte) Index einer EMail. Nach der Abmeldung vom POP3-Server und dem Trennen der Verbindung zwischen POP3-Client und POP3-Server werden die zum Löschen markierten EMails im Postfach endgültig gelöscht.
Reset( )-Setzt das Postfach in den originalen Zustand wie zu Beginn der Sitzung zurück. Bereits zum Löschen markierte EMails werden wiederhergestellt (Rollback).
Stat( ) Integer[ ]Gibt ein Integer-Array zurück, das die Anzahl der Nachrichten im Postfach (Stat()[0]) und deren Gesamtgröße (Stat()[1]) (Einheit Byte) enthält.

Tabelle 24.5.0.2.1 : Methoden der Klasse POP3Client

Die Klasse können Sie erzeugen. Hier ein Beispiel:

Public hPop3Client As Pop3Client 
hPop3Client = New Pop3Client() 

Um die einzelnen EMails online zu verwalten, benötigen Sie eine sogenannte Nachrichten-Instanz:

Public hPop3Client As New Pop3Client 
Dim hPop3ClientMessage As _Pop3Client_Message 
hPop3ClientMessage = hPop3Client [ Index As Integer ] 

Mit den folgenden Anweisungen durchlaufen Sie online das Postfach. Es wird jeweils ein Message-Objekt für die einzelnen Nachrichten vom Typ MimeMessage zurückgegeben.

Public hPop3Client As New Pop3Client 
Dim hPop3ClientMessage As _Pop3Client_Message 

For Each hPop3ClientMessage In hPop3Client 
  ... 
Next

Wenn Sie sich zum POP3-Protokoll informieren wollen, dann sollten Sie mindestens diesen Links folgen:

Die Erfahrungen des Autors betätigen: Nur wenn Sie die Grundlagen hinreichend genau kennen, wie das POP3-Protokoll funktioniert, werden Sie die implementierten Eigenschaften und Methoden der Klasse POP3Client erfolgreich einsetzen können. Bevor Sie in Ihren POP3-Projekten mit der Klasse POP3Client → Kapitel 24.5.3 arbeiten, sollten Sie deshalb die folgenden zwei Kapitel zur praktischen Umsetzung des POP3-Protokolls lesen und die Beispiele auf der Konsole mit den Daten eines eigenen EMail-Kontos nachvollziehen.

Download

Die Website verwendet zwei temporäre Session-Cookies. Diese technisch notwendigen Cookies werden gelöscht, wenn der Web-Browser geschlossen wird! Informationen zu Cookies erhalten Sie in der Datenschutzerklärung.
k24/k24.5/start.txt · Zuletzt geändert: 20.06.2016 (Externe Bearbeitung)

Seiten-Werkzeuge