git.saurik.com Git - wxWidgets.git/blame_incremental - interface/wx/protocol/protocol.h

0 / 97 ( 0%)

Commit	Line	Data
	1	/////////////////////////////////////////////////////////////////////////////
	2	// Name: protocol/protocol.h
	3	// Purpose: interface of wxProtocol
	4	// Author: wxWidgets team
	5	// RCS-ID: $Id$
	6	// Licence: wxWindows license
	7	/////////////////////////////////////////////////////////////////////////////
	8
	9	/**
	10	Error values returned by wxProtocol.
	11	*/
	12	enum wxProtocolError
	13	{
	14	wxPROTO_NOERR = 0, //!< No error.
	15	wxPROTO_NETERR, //!< A generic network error occurred.
	16	wxPROTO_PROTERR, //!< An error occurred during negotiation.
	17	wxPROTO_CONNERR, //!< The client failed to connect the server.
	18	wxPROTO_INVVAL, //!< Invalid value.
	19	wxPROTO_NOHNDLR, //!< Not currently used.
	20	wxPROTO_NOFILE, //!< The remote file doesn't exist.
	21	wxPROTO_ABRT, //!< Last action aborted.
	22	wxPROTO_RCNCT, //!< An error occurred during reconnection.
	23	wxPROTO_STREAMING //!< Someone tried to send a command during a transfer.
	24	};
	25
	26	/**
	27	@class wxProtocol
	28
	29	Represents a protocol for use with wxURL.
	30
	31	@library{wxnet}
	32	@category{net}
	33
	34	@see wxSocketBase, wxURL
	35	*/
	36	class wxProtocol : public wxSocketClient
	37	{
	38	public:
	39	/**
	40	Abort the current stream.
	41
	42	@warning
	43	It is advised to destroy the input stream instead of aborting the stream
	44	this way.
	45
	46	@return Returns @true, if successful, else @false.
	47	*/
	48	virtual bool Abort() = 0;
	49
	50	/**
	51	Returns the type of the content of the last opened stream. It is a mime-type.
	52	*/
	53	virtual wxString GetContentType();
	54
	55	/**
	56	Returns the last occurred error.
	57
	58	@see wxProtocolError
	59	*/
	60	virtual wxProtocolError GetError() = 0;
	61
	62	/**
	63	Creates a new input stream on the specified path.
	64
	65	You can use all but seek() functionality of wxStream.
	66	Seek() isn't available on all streams. For example, HTTP or FTP streams
	67	don't deal with it. Other functions like StreamSize() and Tell() aren't
	68	available for the moment for this sort of stream.
	69	You will be notified when the EOF is reached by an error.
	70
	71	@return Returns the initialized stream. You will have to delete it
	72	yourself once you don't use it anymore. The destructor
	73	closes the network connection.
	74
	75	@see wxInputStream
	76	*/
	77	virtual wxInputStream* GetInputStream(const wxString& path) = 0;
	78
	79	/**
	80	Tries to reestablish a previous opened connection (close and renegotiate
	81	connection).
	82
	83	@return @true, if the connection is established, else @false.
	84	*/
	85	bool Reconnect();
	86
	87	/**
	88	Sets the authentication password. It is mainly useful when FTP is used.
	89	*/
	90	virtual void SetPassword(const wxString& user);
	91
	92	/**
	93	Sets the authentication user. It is mainly useful when FTP is used.
	94	*/
	95	virtual void SetUser(const wxString& user);
	96	};
	97