KDE 4.3 PyKDE API Reference
  • KDE's Python API
  • Overview
  • PyKDE Home
  • Sitemap
  • Contact Us
 

KSocketFactory Namespace Reference

from PyKDE4.kdecore.KSocketFactory import *

Detailed Description

KSocketFactory provides functions for opening sockets to remote hosts

KSocketFactory is a socket-opener group of functions that must be used whenever a KDE application wants to communicate with a remote host. It will determine the necessary proxy and local KDE settings, then open the connection. The typical use-case is:

d->socket = KSocketFactory.connectToHost("www.kde.org", "http");
d->socket->setParent(this);
QObject.connect(d->socket, SIGNAL(connected()),
this, SLOT(socketConnected()));

Synchronous operation is not recommended, since it may lead to UI deadlocks. It is preferred to return to the mainloop if the socket is being created in the main GUI thread.

However, if the socket is created in an auxiliary thread, it is possible to use something equivalent to synchronous mode:

d->socket = KSocketFactory.synchronousConnectToHost("www.kde.org", "http");
d->socket->setParent(this);

All objects returned from these functions belong to the caller and must be disposed of properly. Calling QObject.setParent() or passing a parent object is the recommended way.

Author:
Thiago Macieira <thiago@kde.org>


Functions

QTcpSocket connectToHost (QString protocol, QString host, int port, QObject parent=0)
QTcpSocket connectToHost (QUrl url, QObject parent=0)
 connectToHost (QTcpSocket socket, QString protocol, QString host, int port)
 connectToHost (QTcpSocket socket, QUrl url)
QUdpSocket datagramSocket (QString protocol, QString host, QObject parent=0)
QTcpServer listen (QString protocol, QHostAddress address=QHostAddress.Any, int port=0, QObject parent=0)
QNetworkProxy proxyForConnection (QString protocol, QString host)
QNetworkProxy proxyForDatagram (QString protocol, QString host)
QNetworkProxy proxyForListening (QString protocol)
QTcpSocket synchronousConnectToHost (QString protocol, QString host, int port, int msecs=30000, QObject parent=0)
QTcpSocket synchronousConnectToHost (QUrl url, int msecs=30000, QObject parent=0)
 synchronousConnectToHost (QTcpSocket socket, QString protocol, QString host, int port, int msecs=30000)
 synchronousConnectToHost (QTcpSocket socket, QUrl url, int msecs=30000)

Function Documentation

QTcpSocket connectToHost ( QString  protocol,
QString  host,
int  port,
QObject  parent=0
)

Initiates a TCP/IP socket connection to remote node (host) @p host, using the protocol. Returns a QTcpSocket that is connecting (i.e., in a state before QAbstractSocket.Connected) in most cases, even if the target service doesn't exist or if a connection failure happens.

This function never returns 0. If the returned socket cannot connect, it will emit the QAbstractSocket.error() signal. Otherwise, the QAbstractSocket.connected() signal will be emitted eventually.

The protocol parameter must be a string representation of the protocol being attempted, like "http", "ftp" or "xmpp". It might be used to determine the proxy type -- for instance, the proxy for HTTP connections might be different from the proxy for other connections. Pass an empty QString if the connection is of no established protocol.

The port parameter can be used to specify the port number lookup if the service is not a well-known service.

Parameters:
protocol  the protocol this socket will use
host  the remote node (host) to connect to
port  the port number to connect to
parent  the parent object to be passed to the QTcpSocket constructor

@threadsafe

QTcpSocket connectToHost ( QUrl  url,
QObject  parent=0
)

connectToHost ( QTcpSocket  socket,
QString  protocol,
QString  host,
int  port
)

connectToHost ( QTcpSocket  socket,
QUrl  url
)

QUdpSocket datagramSocket ( QString  protocol,
QString  host,
QObject  parent=0
)
QTcpServer listen ( QString  protocol,
QHostAddress  address=QHostAddress.Any,
int  port=0,
QObject  parent=0
)

Opens a TCP/IP socket for listening protocol protocol, binding only at address address. The port parameter indicates the port to be opened.

This function does not return 0. If the opening of the socket failed for some reason, it will return a QTcpServer object that is not listening (QTcpServer.isListening() returns false), with a properly set error string indicating the reason).

Note that passing 0 as the default port number will cause the operating system to automatically allocate a free port for the socket.

Parameters:
protocol  the protocol this socket will accept
address  the address to listen at
port  the default port for the service
parent  the parent object to be passed to the QTcpServer constructor

QNetworkProxy proxyForConnection ( QString  protocol,
QString  host
)
QNetworkProxy proxyForDatagram ( QString  protocol,
QString  host
)
QNetworkProxy proxyForListening ( QString  protocol
)
QTcpSocket synchronousConnectToHost ( QString  protocol,
QString  host,
int  port,
int  msecs=30000,
QObject  parent=0
)

This function behaves exactly like connectToHost() above, except that the socket it returns is either in QAbstractSocket.Connected state, or it has failed connecting altogether.

This function should be used if a synchronous connection is necessary instead of calling QAbstractSocket.waitForConnected(), since that may not work on all objects returned from connectToHost().

This function does not return 0. If the connection attempt failed for some reason, the socket state will be QAbstractSocket.UnconnectedState and QAbstractSocket.isValid will return false. The socket error state and string will contain more information. @warning: This function may block.

Parameters:
protocol  the protocol this socket will use
host  the remote node (host) to connect to
port  the port number to connect to
msecs  the time (in milliseconds) to wait while attempting to connect
parent  the parent object to be passed to the QTcpSocket constructor

@threadsafe

QTcpSocket synchronousConnectToHost ( QUrl  url,
int  msecs=30000,
QObject  parent=0
)

synchronousConnectToHost ( QTcpSocket  socket,
QString  protocol,
QString  host,
int  port,
int  msecs=30000
)

synchronousConnectToHost ( QTcpSocket  socket,
QUrl  url,
int  msecs=30000
)

  • Full Index

Modules

  • akonadi
  • dnssd
  • kdecore
  • kdeui
  • khtml
  • kio
  • knewstuff
  • kparts
  • kutils
  • nepomuk
  • phonon
  • plasma
  • polkitqt
  • solid
  • soprano
This documentation is maintained by Simon Edwards.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal