TCPSlaveBase Class Reference

from PyKDE4.kio import *

Detailed Description

There are two classes that specifies the protocol between application (job) and kioslave. SlaveInterface is the class to use on the application end, SlaveBase is the one to use on the slave end.

Slave implementations should simply inherit SlaveBase

A call to foo() results in a call to slotFoo() on the other end.

Enumerations
SslResultDetail	{ ResultOk, ResultOverridden, ResultFailed, ResultFailedEarly }
Methods
	__init__ (self, QByteArray protocol, QByteArray poolSocket, QByteArray appSocket, bool autoSsl=0)
	__init__ (self, KIO.TCPSlaveBase other)
bool	atEnd (self)
bool	connectToHost (self, QString protocol, QString host, int port)
int	connectToHost (self, QString host, int port, QString errorString=0)
	disconnectFromHost (self)
bool	isAutoSsl (self)
bool	isConnected (self)
bool	isUsingSsl (self)
int	port (self)
int	read (self, QString data, int len)
int	readLine (self, QString data, int len)
	setBlocking (self, bool b)
QIODevice	socket (self)
bool	startSsl (self)
bool	waitForResponse (self, int t)
int	write (self, QString data, int len)

Method Documentation

__init__	(	self,
		QByteArray	protocol,
		QByteArray	poolSocket,
		QByteArray	appSocket,
		bool	autoSsl=0
	)

Constructor.

Parameters:

autoSsl

if true, will automatically invoke startSsl() right after connecting. In the absence of errors the use of SSL will therefore be transparent to higher layers.

__init__	(	self,
		KIO.TCPSlaveBase	other
	)

bool atEnd ( self )

Returns true when end of data is reached.

bool connectToHost	(	self,
		QString	protocol,
		QString	host,
		int	port
	)

Connects to the specified host and port.

Parameters:

	host	host name
	port	port number
	errorString	if not NULL, this string will contain error information on why the connection request failed.

Returns:: on success, 0 is returned. on failure, a KIO.Error code is returned.

errorString, if not NULL, will contain the appropriate error message that can be sent back to the client.

Since:: 4.7.2

int connectToHost	(	self,
		QString	host,
		int	port,
		QString	errorString=0
	)

Connects to the specified host and port.

Parameters:

	host	host name
	port	port number
	errorString	if not NULL, this string will contain error information on why the connection request failed.

Returns:: on success, 0 is returned. on failure, a KIO.Error code is returned.

errorString, if not NULL, will contain the appropriate error message that can be sent back to the client.

Since:: 4.7.2

disconnectFromHost ( self )

Close the connection and forget non-permanent data like the peer host.

bool isAutoSsl ( self )

Will start SSL after connecting?

Returns:: if so, true is returned. if not, false is returned.

bool isConnected ( self )

Determines whether or not we are still connected to the remote machine.

return true if the socket is still active or false otherwise.

bool isUsingSsl ( self )

Is the current connection using SSL?

Returns:: if so, true is returned. if not, false is returned.

int port ( self )

the current port for this service

int read	(	self,
		QString	data,
		int	len
	)

Read incoming data from the remote host.

Parameters:

	data	storage for the data read from server
	len	length of the data (in bytes) to read from the server

Returns:: the actual size of data that was obtained

int readLine	(	self,
		QString	data,
		int	len
	)

Same as read() except it reads data one line at a time.

setBlocking	(	self,
		bool	b
	)

Sets the mode of the connection to blocking or non-blocking.

Be sure to call this function before calling connectToHost. Otherwise, this setting will not have any effect until the next connectToHost.

Parameters:

true to make the connection a blocking one, false otherwise.

QIODevice socket ( self )

Return the socket object, if the class ever needs to do anything to it

bool startSsl ( self )

Start using SSL on the connection. You can use it right after connecting for classic, transparent to the protocol SSL. Calling it later can be used to implement e.g. SMTP's STARTTLS feature.

Returns:: on success, true is returned. on failure, false is returned.

bool waitForResponse	(	self,
		int	t
	)

Wait for incoming data on the socket for the period specified by t.

Parameters:

length of time in seconds that we should monitor the socket before timing out.

Returns:: true if any data arrived on the socket before the timeout value was reached, false otherwise.

int write	(	self,
		QString	data,
		int	len
	)

Send data to the remote host.

Parameters:

	data	data to be sent to remote machine
	len	the length (in bytes) of the data to be sent

Returns:: the actual size of the data that was sent

Enumeration Documentation

SslResultDetail

Enumerator:

ResultOk = 1
ResultOverridden = 2
ResultFailed = 4
ResultFailedEarly = 8

TCPSlaveBase Class Reference

Detailed Description

Enumerations

Methods

Method Documentation

Enumeration Documentation

Modules