summaryrefslogtreecommitdiffstats
path: root/base/tps/src/include/httpClient/httpc/Connection.h
blob: 5619d0dfff11309ea1a6902605812dba3380c69f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
 */
/** BEGIN COPYRIGHT BLOCK
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation;
 * version 2.1 of the License.
 * 
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 * 
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor,
 * Boston, MA  02110-1301  USA 
 * 
 * Copyright (C) 2007 Red Hat, Inc.
 * All rights reserved.
 * END COPYRIGHT BLOCK **/

#ifndef __CONNECTION_H
#define __CONNECTION_H

#ifdef HAVE_CONFIG_H
#ifndef AUTOTOOLS_CONFIG_H
#define AUTOTOOLS_CONFIG_H

/* Eliminate warnings when using Autotools */
#undef PACKAGE_BUGREPORT
#undef PACKAGE_NAME
#undef PACKAGE_STRING
#undef PACKAGE_TARNAME
#undef PACKAGE_VERSION

#include <config.h>
#endif /* AUTOTOOLS_CONFIG_H */
#endif /* HAVE_CONFIG_H */

/**
 * Connection.h	1.000 06/12/2002
 * 
 * Base class for all connection types. A user should extend this class 
 * and provide its protocol specific implementation
 *
 * @author  Surendra Rajam
 * @version 1.000, 06/12/2002
 */

class EXPORT_DECL Connection {
	friend class ServerConnection;
public:
	/**
	 * Constructor
	 */
	Connection();

	/**
	 * Destructor
	 */
	virtual ~Connection();

public:
	/**
	 * Initiates a connection to a specified host.
	 *
	 * @param	host	server host name
	 * @param	port	server port
	 * @return			0 on success, negative error code otherwise
	 */
	int Connect(const char* host, int port);

	/**
	 * Reads specified number of bytes from the connection. The connection 
	 * is locked for the period it is being read.
	 *
	 * @param	buf		buffer to read into
	 * @param	size	number of bytes to read
	 * @param	timeout	timeout before the read terminates
	 * @return			number of bytes actually read
	 */
	int Read(void* buf, int size, long timeout);

	/**
	 * Writes specified number of bytes to the connection.  The connection 
	 * is locked for the period it is being written.
	 *
	 * @param	buf		buffer to write from
	 * @param	size	number of bytes to write
	 * @param	timeout	timeout before the write terminates
	 * @return			number of bytes actually written
	 */
	int Write(void* buf, int size, long timeout);

	/**
	 * Gets the status of the connection
	 *
	 * @return true if closed, false otherwise
	 */
	bool IsClosed();

	/**
	 * Closes the connection
	 */
	void Close();

protected:
	Socket* m_socket;

private:
	PRLock* m_lock;
	bool m_closed;
};

#endif // __CONNECTION_H