Poco

namespace Net

Overview

Classes: AbstractHTTPRequestHandler, AcceptCertificateHandler, CertificateHandlerFactory, CertificateHandlerFactoryImpl, CertificateHandlerFactoryMgr, CertificateHandlerFactoryRegistrar, CertificateValidationException, ConnectionAbortedException, ConnectionRefusedException, ConnectionResetException, ConsoleCertificateHandler, Context, DNS, DNSException, DatagramSocket, DatagramSocketImpl, DialogSocket, ErrorNotification, FTPClientSession, FTPException, FTPPasswordProvider, FTPStreamFactory, FilePartSource, HTMLForm, HTMLFormException, HTTPAuthenticationParams, HTTPBasicCredentials, HTTPBufferAllocator, HTTPChunkedIOS, HTTPChunkedInputStream, HTTPChunkedOutputStream, HTTPChunkedStreamBuf, HTTPClientSession, HTTPCookie, HTTPCredentials, HTTPDigestCredentials, HTTPException, HTTPFixedLengthIOS, HTTPFixedLengthInputStream, HTTPFixedLengthOutputStream, HTTPFixedLengthStreamBuf, HTTPHeaderIOS, HTTPHeaderInputStream, HTTPHeaderOutputStream, HTTPHeaderStreamBuf, HTTPIOS, HTTPInputStream, HTTPMessage, HTTPOutputStream, HTTPRequest, HTTPRequestHandler, HTTPRequestHandlerFactory, HTTPResponse, HTTPResponseIOS, HTTPResponseStream, HTTPResponseStreamBuf, HTTPSClientSession, HTTPSSessionInstantiator, HTTPSStreamFactory, HTTPServer, HTTPServerConnection, HTTPServerConnectionFactory, HTTPServerParams, HTTPServerRequest, HTTPServerRequestImpl, HTTPServerResponse, HTTPServerResponseImpl, HTTPServerSession, HTTPSession, HTTPSessionFactory, HTTPSessionInstantiator, HTTPStreamBuf, HTTPStreamFactory, HostEntry, HostNotFoundException, ICMPClient, ICMPEventArgs, ICMPException, ICMPPacket, ICMPPacketImpl, ICMPSocket, ICMPSocketImpl, ICMPv4PacketImpl, IPAddress, IdleNotification, InterfaceNotFoundException, InvalidAddressException, InvalidCertificateException, InvalidCertificateHandler, InvalidSocketException, KeyConsoleHandler, KeyFileHandler, MailIOS, MailInputStream, MailMessage, MailOutputStream, MailRecipient, MailStreamBuf, MediaType, MessageException, MessageHeader, MulticastSocket, MultipartException, MultipartIOS, MultipartInputStream, MultipartReader, MultipartStreamBuf, MultipartWriter, NameValueCollection, NetException, NetworkInterface, NoAddressFoundException, NoMessageException, NotAuthenticatedException, NullPartHandler, POP3ClientSession, POP3Exception, ParallelSocketAcceptor, ParallelSocketReactor, PartHandler, PartSource, PrivateKeyFactory, PrivateKeyFactoryImpl, PrivateKeyFactoryMgr, PrivateKeyFactoryRegistrar, PrivateKeyPassphraseHandler, QuotedPrintableDecoder, QuotedPrintableDecoderBuf, QuotedPrintableDecoderIOS, QuotedPrintableEncoder, QuotedPrintableEncoderBuf, QuotedPrintableEncoderIOS, RawSocket, RawSocketImpl, ReadableNotification, RejectCertificateHandler, RemoteSyslogChannel, RemoteSyslogListener, SMTPChannel, SMTPClientSession, SMTPException, SSLConnectionUnexpectedlyClosedException, SSLContextException, SSLException, SSLManager, SecureSMTPClientSession, SecureServerSocket, SecureServerSocketImpl, SecureSocketImpl, SecureStreamSocket, SecureStreamSocketImpl, ServerSocket, ServerSocketImpl, ServiceNotFoundException, Session, ShutdownNotification, Socket, SocketAcceptor, SocketAddress, SocketConnector, SocketIOS, SocketImpl, SocketInputStream, SocketNotification, SocketNotifier, SocketOutputStream, SocketReactor, SocketStream, SocketStreamBuf, StreamSocket, StreamSocketImpl, StringPartSource, TCPServer, TCPServerConnection, TCPServerConnectionFactory, TCPServerConnectionFactoryImpl, TCPServerDispatcher, TCPServerParams, TimeoutNotification, UnsupportedFamilyException, UnsupportedRedirectException, Utility, VerificationErrorArgs, WebSocket, WebSocketException, WebSocketImpl, WritableNotification, X509Certificate

Types: HTTPBasicStreamBuf

Functions: initializeNetwork, initializeSSL, operator <<, operator >>, swap, uninitializeNetwork, uninitializeSSL

Classes

class AbstractHTTPRequestHandler

The abstract base class for AbstractHTTPRequestHandlers created by HTTPServermore...

class AcceptCertificateHandler

A AcceptCertificateHandler is invoked whenever an error occurs verifying the certificate. more...

class CertificateHandlerFactory

A CertificateHandlerFactory is responsible for creating InvalidCertificateHandlers. more...

class CertificateHandlerFactoryImpl

 more...

class CertificateHandlerFactoryMgr

A CertificateHandlerFactoryMgr manages all existing CertificateHandlerFactories. more...

class CertificateHandlerFactoryRegistrar

Registrar class which automatically registers CertificateHandlerFactory at the CertificateHandlerFactoryMgrmore...

class CertificateValidationException

 more...

class ConnectionAbortedException

 more...

class ConnectionRefusedException

 more...

class ConnectionResetException

 more...

class ConsoleCertificateHandler

A ConsoleCertificateHandler is invoked whenever an error occurs verifying the certificate. more...

class Context

This class encapsulates context information for an SSL server or client, such as the certificate verification mode and the location of certificates and private key files, as well as the list of supported ciphers. more...

class DNS

This class provides an interface to the domain name service. more...

class DNSException

 more...

class DatagramSocket

This class provides an interface to an UDP stream socket. more...

class DatagramSocketImpl

This class implements an UDP socket. more...

class DialogSocket

DialogSocket is a subclass of StreamSocket that can be used for implementing request-response based client server connections. more...

class ErrorNotification

This notification is sent if a socket has signalled an error. more...

class FTPClientSession

This class implements an File Transfer Protocol (FTP, RFC 959) client. more...

class FTPException

 more...

class FTPPasswordProvider

The base class for all password providers. more...

class FTPStreamFactory

An implementation of the URIStreamFactory interface that handles File Transfer Protocol (ftp) URIs. more...

class FilePartSource

An implementation of PartSource for plain files. more...

class HTMLForm

HTMLForm is a helper class for working with HTML forms, both on the client and on the server side. more...

class HTMLFormException

 more...

class HTTPAuthenticationParams

Collection of name-value pairs of HTTP authentication header (i. more...

class HTTPBasicCredentials

This is a utility class for working with HTTP Basic Authentication in HTTPRequest objects. more...

class HTTPBufferAllocator

A BufferAllocator for HTTP streams. more...

class HTTPChunkedIOS

The base class for HTTPInputStreammore...

class HTTPChunkedInputStream

This class is for internal use by HTTPSession only. more...

class HTTPChunkedOutputStream

This class is for internal use by HTTPSession only. more...

class HTTPChunkedStreamBuf

This is the streambuf class used for reading and writing HTTP message bodies in chunked transfer coding. more...

class HTTPClientSession

This class implements the client-side of a HTTP session. more...

class HTTPCookie

This class represents a HTTP Cookie. more...

class HTTPCredentials

This is a utility class for working with HTTP authentication (basic or digest) in HTTPRequest objects. more...

class HTTPDigestCredentials

This is a utility class for working with HTTP Digest Authentication in HTTPRequest objects. more...

class HTTPException

 more...

class HTTPFixedLengthIOS

The base class for HTTPFixedLengthInputStreammore...

class HTTPFixedLengthInputStream

This class is for internal use by HTTPSession only. more...

class HTTPFixedLengthOutputStream

This class is for internal use by HTTPSession only. more...

class HTTPFixedLengthStreamBuf

This is the streambuf class used for reading and writing fixed-size HTTP message bodies. more...

class HTTPHeaderIOS

The base class for HTTPHeaderInputStreammore...

class HTTPHeaderInputStream

This class is for internal use by HTTPSession only. more...

class HTTPHeaderOutputStream

This class is for internal use by HTTPSession only. more...

class HTTPHeaderStreamBuf

This is the streambuf class used for reading from a HTTP header in a HTTPSessionmore...

class HTTPIOS

The base class for HTTPInputStreammore...

class HTTPInputStream

This class is for internal use by HTTPSession only. more...

class HTTPMessage

The base class for HTTPRequest and HTTPResponsemore...

class HTTPOutputStream

This class is for internal use by HTTPSession only. more...

class HTTPRequest

This class encapsulates an HTTP request message. more...

class HTTPRequestHandler

The abstract base class for HTTPRequestHandlers created by HTTPServermore...

class HTTPRequestHandlerFactory

A factory for HTTPRequestHandler objects. more...

class HTTPResponse

This class encapsulates an HTTP response message. more...

class HTTPResponseIOS

 more...

class HTTPResponseStream

 more...

class HTTPResponseStreamBuf

 more...

class HTTPSClientSession

This class implements the client-side of a HTTPS session. more...

class HTTPSSessionInstantiator

The HTTPSessionInstantiator for HTTPSClientSessionmore...

class HTTPSStreamFactory

An implementation of the URIStreamFactory interface that handles secure Hyper-Text Transfer Protocol (https) URIs. more...

class HTTPServer

A subclass of TCPServer that implements a full-featured multithreaded HTTP server. more...

class HTTPServerConnection

This subclass of TCPServerConnection handles HTTP connections. more...

class HTTPServerConnectionFactory

This implementation of a TCPServerConnectionFactory is used by HTTPServer to create HTTPServerConnection objects. more...

class HTTPServerParams

This class is used to specify parameters to both the HTTPServer, as well as to HTTPRequestHandler objects. more...

class HTTPServerRequest

This abstract subclass of HTTPRequest is used for representing server-side HTTP requests. more...

class HTTPServerRequestImpl

This subclass of HTTPServerRequest is used for representing server-side HTTP requests. more...

class HTTPServerResponse

This subclass of HTTPResponse is used for representing server-side HTTP responses. more...

class HTTPServerResponseImpl

This subclass of HTTPServerResponse is used for representing server-side HTTP responses. more...

class HTTPServerSession

This class handles the server side of a HTTP session. more...

class HTTPSession

HTTPSession implements basic HTTP session management for both HTTP clients and HTTP servers. more...

class HTTPSessionFactory

A factory for HTTPClientSession objects. more...

class HTTPSessionInstantiator

A factory for HTTPClientSession objects. more...

class HTTPStreamBuf

This is the streambuf class used for reading and writing HTTP message bodies. more...

class HTTPStreamFactory

An implementation of the URIStreamFactory interface that handles Hyper-Text Transfer Protocol (http) URIs. more...

class HostEntry

This class stores information about a host such as host name, alias names and a list of IP addresses. more...

class HostNotFoundException

 more...

class ICMPClient

This class provides ICMP Ping functionality. more...

class ICMPEventArgs

The purpose of the ICMPEventArgs class is to be used as template parameter to instantiate event members in ICMPClient class. more...

class ICMPException

 more...

class ICMPPacket

This class is the ICMP packet abstraction. more...

class ICMPPacketImpl

This is the abstract class for ICMP packet implementations. more...

class ICMPSocket

This class provides an interface to an ICMP client socket. more...

class ICMPSocketImpl

This class implements an ICMP socket. more...

class ICMPv4PacketImpl

This class implements the ICMPv4 packet. more...

class IPAddress

This class represents an internet (IP) host address. more...

class IdleNotification

This notification is sent when the SocketReactor does not have any sockets to react to. more...

class InterfaceNotFoundException

 more...

class InvalidAddressException

 more...

class InvalidCertificateException

 more...

class InvalidCertificateHandler

A InvalidCertificateHandler is invoked whenever an error occurs verifying the certificate. more...

class InvalidSocketException

 more...

class KeyConsoleHandler

An implementation of PrivateKeyPassphraseHandler that reads the key for a certificate from the console. more...

class KeyFileHandler

An implementation of PrivateKeyPassphraseHandler that reads the key for a certificate from a configuration file under the path "openSSL. more...

class MailIOS

The base class for MailInputStream and MailOutputStreammore...

class MailInputStream

This class is used for reading E-Mail messages from a POP3 server. more...

class MailMessage

This class represents an e-mail message for use with the SMTPClientSession and POPClientSession classes. more...

class MailOutputStream

This class is used for writing E-Mail messages to a SMTP server. more...

class MailRecipient

The recipient of an e-mail message. more...

class MailStreamBuf

The sole purpose of this stream buffer is to replace a "\r\n. more...

class MediaType

This class represents a MIME media type, consisting of a top-level type, a subtype and an optional set of parameters. more...

class MessageException

 more...

class MessageHeader

A collection of name-value pairs that are used in various internet protocols like HTTP and SMTP. more...

class MulticastSocket

A MulticastSocket is a special DatagramSocket that can be used to send packets to and receive packets from multicast groups. more...

class MultipartException

 more...

class MultipartIOS

The base class for MultipartInputStreammore...

class MultipartInputStream

This class is for internal use by MultipartReader only. more...

class MultipartReader

This class is used to split a MIME multipart message into its single parts. more...

class MultipartStreamBuf

This is the streambuf class used for reading from a multipart message stream. more...

class MultipartWriter

This class is used to write MIME multipart messages to an output stream. more...

class NameValueCollection

A collection of name-value pairs that are used in various internet protocols like HTTP and SMTP. more...

class NetException

 more...

class NetworkInterface

This class represents a network interface. more...

class NoAddressFoundException

 more...

class NoMessageException

 more...

class NotAuthenticatedException

 more...

class NullPartHandler

A very special PartHandler that simply discards all data. more...

class POP3ClientSession

This class implements an Post Office Protocol Version 3 (POP3, RFC 1939) client for receiving e-mail messages. more...

class POP3Exception

 more...

class ParallelSocketAcceptor

This class implements the Acceptor part of the Acceptor-Connector design pattern. more...

class ParallelSocketReactor

 more...

class PartHandler

The base class for all part or attachment handlers. more...

class PartSource

This abstract class is used for adding parts or attachments to mail messages, as well as for uploading files as part of a HTML form. more...

class PrivateKeyFactory

A PrivateKeyFactory is responsible for creating PrivateKeyPassphraseHandlers. more...

class PrivateKeyFactoryImpl

 more...

class PrivateKeyFactoryMgr

A PrivateKeyFactoryMgr manages all existing PrivateKeyFactories. more...

class PrivateKeyFactoryRegistrar

Registrar class which automatically registers PrivateKeyFactories at the PrivateKeyFactoryMgrmore...

class PrivateKeyPassphraseHandler

A passphrase handler is needed whenever the private key of a certificate is loaded and the certificate is protected by a passphrase. more...

class QuotedPrintableDecoder

This istream decodes all quoted-printable (see RFC 2045) encoded data read from the istream connected to it. more...

class QuotedPrintableDecoderBuf

This streambuf decodes all quoted-printable (see RFC 2045) encoded data read from the istream connected to it. more...

class QuotedPrintableDecoderIOS

The base class for QuotedPrintableDecodermore...

class QuotedPrintableEncoder

This ostream encodes all data written to it in quoted-printable encoding (see RFC 2045) and forwards it to a connected ostream. more...

class QuotedPrintableEncoderBuf

This streambuf encodes all data written to it in quoted-printable encoding (see RFC 2045) and forwards it to a connected ostream. more...

class QuotedPrintableEncoderIOS

The base class for QuotedPrintableEncodermore...

class RawSocket

This class provides an interface to a raw IP socket. more...

class RawSocketImpl

This class implements a raw socket. more...

class ReadableNotification

This notification is sent if a socket has become readable. more...

class RejectCertificateHandler

A RejectCertificateHandler is invoked whenever an error occurs verifying the certificate. more...

class RemoteSyslogChannel

This Channel implements remote syslog logging over UDP according to RFC 5424 "The Syslog Protocol" and RFC 5426 "Transmission of syslog messages over UDP". more...

class RemoteSyslogListener

RemoteSyslogListener implents listening for syslog messages sent over UDP, according to RFC 5424 "The Syslog Protocol" and RFC 5426 "Transmission of syslog messages over UDP". more...

class SMTPChannel

This Channel implements SMTP (email) logging. more...

class SMTPClientSession

This class implements an Simple Mail Transfer Procotol (SMTP, RFC 2821) client for sending e-mail messages. more...

class SMTPException

 more...

class SSLConnectionUnexpectedlyClosedException

 more...

class SSLContextException

 more...

class SSLException

 more...

class SSLManager

SSLManager is a singleton for holding the default server/client Context and handling callbacks for certificate verification errors and private key passphrases. more...

class SecureSMTPClientSession

This class implements an Simple Mail Transfer Procotol (SMTP, RFC 2821) client for sending e-mail messages that supports the STARTTLS command for secure connections. more...

class SecureServerSocket

A server socket for secure SSL connections. more...

class SecureServerSocketImpl

The SocketImpl class for SecureServerSocketmore...

class SecureSocketImpl

The SocketImpl for SecureStreamSocketmore...

class SecureStreamSocket

A subclass of StreamSocket for secure SSL sockets. more...

class SecureStreamSocketImpl

This class implements a SSL stream socket. more...

class ServerSocket

This class provides an interface to a TCP server socket. more...

class ServerSocketImpl

This class implements a TCP server socket. more...

class ServiceNotFoundException

 more...

class Session

This class encapsulates a SSL session object used with session caching on the client side. more...

class ShutdownNotification

This notification is sent when the SocketReactor is about to shut down. more...

class Socket

Socket is the common base class for StreamSocket, ServerSocket, DatagramSocket and other socket classes. more...

class SocketAcceptor

This class implements the Acceptor part of the Acceptor-Connector design pattern. more...

class SocketAddress

This class represents an internet (IP) endpoint/socket address. more...

class SocketConnector

This class implements the Connector part of the Acceptor-Connector design pattern. more...

class SocketIOS

The base class for SocketStream, SocketInputStream and SocketOutputStreammore...

class SocketImpl

This class encapsulates the Berkeley sockets API. more...

class SocketInputStream

An input stream for reading from a socket. more...

class SocketNotification

The base class for all notifications generated by the SocketReactormore...

class SocketNotifier

This class is used internally by SocketReactor to notify registered event handlers of socket events. more...

class SocketOutputStream

An output stream for writing to a socket. more...

class SocketReactor

This class, which is part of the Reactor pattern, implements the "Initiation Dispatcher". more...

class SocketStream

An bidirectional stream for reading from and writing to a socket. more...

class SocketStreamBuf

This is the streambuf class used for reading from and writing to a socket. more...

class StreamSocket

This class provides an interface to a TCP stream socket. more...

class StreamSocketImpl

This class implements a TCP socket. more...

class StringPartSource

An implementation of PartSource for strings. more...

class TCPServer

This class implements a multithreaded TCP server. more...

class TCPServerConnection

The abstract base class for TCP server connections created by TCPServermore...

class TCPServerConnectionFactory

A factory for TCPServerConnection objects. more...

class TCPServerConnectionFactoryImpl

This template provides a basic implementation of TCPServerConnectionFactorymore...

class TCPServerDispatcher

A helper class for TCPServer that dispatches connections to server connection threads. more...

class TCPServerParams

This class is used to specify parameters to both the TCPServer, as well as to TCPServerDispatcher objects. more...

class TimeoutNotification

This notification is sent if no other event has occured for a specified time. more...

class UnsupportedFamilyException

 more...

class UnsupportedRedirectException

 more...

class Utility

This class provides various helper functions for working with the OpenSSL library. more...

class VerificationErrorArgs

A utility class for certificate error handling. more...

class WebSocket

This class implements a WebSocket according to the WebSocket protocol specification in RFC 6455more...

class WebSocketException

 more...

class WebSocketImpl

This class implements a WebSocket, according to the WebSocket protocol described in RFC 6455more...

class WritableNotification

This notification is sent if a socket has become writable. more...

class X509Certificate

This class extends Poco::Crypto::X509Certificate with the feature to validate a certificate. more...

Types

HTTPBasicStreamBuf

typedef Poco::BasicBufferedStreamBuf < char, std::char_traits < char >, HTTPBufferAllocator > HTTPBasicStreamBuf;

Functions

initializeNetwork inline

inline void initializeNetwork();

Initialize the network subsystem.

initializeSSL

void initializeSSL();

Initialize the NetSSL library, as well as the underlying OpenSSL libraries, by calling Poco::Crypto::OpenSSLInitializer::initialize().

Should be called before using any class from the NetSSL library. The NetSSL will be initialized automatically, through Poco::Crypto::OpenSSLInitializer instances or similar mechanisms when creating Context or SSLManager instances. However, it is recommended to call initializeSSL() in any case at application startup.

Can be called multiple times; however, for every call to initializeSSL(), a matching call to uninitializeSSL() must be performed.

operator <<

BinaryWriter & operator << (
    BinaryWriter & writer,
    const IPAddress & value
);

operator >>

BinaryReader & operator >> (
    BinaryReader & reader,
    IPAddress & value
);

swap inline

inline void swap(
    HostEntry & h1,
    HostEntry & h2
);

swap inline

inline void swap(
    IPAddress & addr1,
    IPAddress & addr2
);

swap inline

inline void swap(
    MailRecipient & r1,
    MailRecipient & r2
);

swap inline

inline void swap(
    MediaType & m1,
    MediaType & m2
);

swap inline

inline void swap(
    NameValueCollection & nvc1,
    NameValueCollection & nvc2
);

swap inline

inline void swap(
    SocketAddress & a1,
    SocketAddress & a2
);

uninitializeNetwork inline

inline void uninitializeNetwork();

Uninitialize the network subsystem.

uninitializeSSL

void uninitializeSSL();

Uninitializes the NetSSL library by calling Poco::Crypto::OpenSSLInitializer::uninitialize() and shutting down the SSLManager.