PPOP3 Class Reference

A TCP/IP socket for the Post Office Protocol version 3. More...

#include <inetmail.h>

Inheritance diagram for PPOP3:

List of all members.

Public Types
	USER
	PASS
	QUIT
	RSET
	NOOP
	STATcmd
	LIST
	RETR
	DELE
	APOP
	TOP
	UIDL
	AUTH
	NumCommands
enum	Commands {   USER, PASS, QUIT, RSET,   NOOP, STATcmd, LIST, RETR,   DELE, APOP, TOP, UIDL,   AUTH, NumCommands }
Protected Member Functions
	PPOP3 ()
virtual PINDEX	ParseResponse (const PString &line)
	Parse a response line string into a response code and any extra info on the line.
Static Protected Attributes
static PString	okResponse
static PString	errResponse

---

Detailed Description

A TCP/IP socket for the Post Office Protocol version 3.

When acting as a client, the procedure is to make the connection to a remote server, then to retrieve a message using the following procedure: PPOP3Client mail("popserver"); if (mail.IsOpen()) { if (mail.LogIn("Me", "password")) { if (mail.GetMessageCount() > 0) { PUnsignedArray sizes = mail.GetMessageSizes(); for (PINDEX i = 0; i < sizes.GetSize(); i++) { if (mail.BeginMessage(i+1)) mail.Read(myMessage, sizes[i]); else PError << "Error getting mail message." << endl; } } else PError << "No mail messages." << endl; } else PError << "Mail log in failed." << endl; } else PError << "Mail conection failed." << endl;

When acting as a server, a descendant class would be created to override at least the HandleOpenMailbox(), HandleSendMessage() and HandleDeleteMessage() functions. Other functions may be overridden for further enhancement to the sockets capabilities, but these will give a basic POP3 server functionality.

The server socket thread would continuously call the ProcessMessage() function until it returns false. This will then call the appropriate virtual function on parsing the POP3 protocol.

---

Member Enumeration Documentation

enum PPOP3::Commands

Enumerator:

USER
PASS
QUIT
RSET
NOOP
STATcmd
LIST
RETR
DELE
APOP
TOP
UIDL
AUTH
NumCommands

---

Constructor & Destructor Documentation

PPOP3::PPOP3

(

)

[protected]

---

Member Function Documentation

virtual PINDEX PPOP3::ParseResponse

(

const PString &

line

)

[protected, virtual]

Parse a response line string into a response code and any extra info on the line.

Results are placed into the member variables lastResponseCode and lastResponseInfo.

The default bahaviour looks for a space or a '-' and splits the code and info either side of that character, then returns false.

Returns:

Position of continuation character in response, 0 if no continuation lines are possible.

Parameters:

line	Input response line to be parsed

Reimplemented from PInternetProtocol.

---

Member Data Documentation

PString PPOP3::errResponse [static, protected]

PString PPOP3::okResponse [static, protected]

---

The documentation for this class was generated from the following file:

• inetmail.h

---