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
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
|
/* -*- c++ -*- */
// Hey, Emacs! This is a C++ file!
// $Id$
// ============================================================================
//
// = LIBRARY
// jaws
//
// = FILENAME
// IO.h
//
// = AUTHOR
// James Hu
//
// ============================================================================
#ifndef JAWS_IO_H
#define JAWS_IO_H
class ACE_Message_Block;
class JAWS_IO_Handler;
class JAWS_IO_Acceptor;
#include "ace/ACE.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
#include "ace/Asynch_IO.h"
#include "ace/SOCK_Stream.h"
#include "ace/Singleton.h"
#include "JAWS/Export.h"
class JAWS_Export JAWS_IO
// = TITLE
//
// This class defines the abstract interface for an I/O class in
// the context of Web-likes servers
//
// = DESCRIPTION
//
// An I/O class should have the following interface. Derived
// classes will define the exactly how the I/O will take place
// (Asynchronous, Synchronous, Reactive)
{
public:
JAWS_IO (void);
virtual ~JAWS_IO (void);
// void acceptor (JAWS_IO_Acceptor *acceptor);
// void handler (JAWS_IO_Handler *handler);
// void handle (ACE_HANDLE h);
// ACE_HANDLE handle (void);
// James, please add documentation here.
virtual void accept (JAWS_IO_Handler *ioh,
ACE_Message_Block *mb = 0,
unsigned int size = 0) = 0;
// accept a passive connection
virtual void read (JAWS_IO_Handler *ioh,
ACE_Message_Block *mb,
unsigned int size) = 0;
// read from the handle size bytes into the message block.
virtual void transmit_file (JAWS_IO_Handler *ioh,
const char *filename,
const char *header,
unsigned int header_size,
const char *trailer,
unsigned int trailer_size) = 0;
// send header, filename, trailer to the handle.
virtual void receive_file (JAWS_IO_Handler *ioh,
const char *filename,
void *initial_data,
unsigned int initial_data_length,
unsigned int entire_length) = 0;
// read data from the handle and store in filename.
virtual void send_confirmation_message (JAWS_IO_Handler *ioh,
const char *buffer,
unsigned int length) = 0;
// send a confirmation message to the handle.
virtual void send_error_message (JAWS_IO_Handler *ioh,
const char *buffer,
unsigned int length) = 0;
// send an error message to the handle.
protected:
ACE_HANDLE handle_;
JAWS_IO_Handler *handler_;
ACE_INET_Addr *inet_addr_;
JAWS_IO_Acceptor *acceptor_;
};
class JAWS_Export JAWS_Synch_IO : public JAWS_IO
// = TITLE
//
// This class defines the interface for a Synchronous I/O class.
//
// = DESCRIPTION
{
public:
JAWS_Synch_IO (void);
virtual ~JAWS_Synch_IO (void);
virtual void accept (JAWS_IO_Handler *ioh,
ACE_Message_Block *mb = 0,
unsigned int size = 0);
virtual void read (JAWS_IO_Handler *ioh,
ACE_Message_Block *mb,
unsigned int size);
virtual void transmit_file (JAWS_IO_Handler *ioh,
const char *filename,
const char *header,
unsigned int header_size,
const char *trailer,
unsigned int trailer_size);
virtual void receive_file (JAWS_IO_Handler *ioh,
const char *filename,
void *initial_data,
unsigned int initial_data_length,
unsigned int entire_length);
virtual void send_confirmation_message (JAWS_IO_Handler *ioh,
const char *buffer,
unsigned int length);
virtual void send_error_message (JAWS_IO_Handler *ioh,
const char *buffer,
unsigned int length);
protected:
virtual void send_message (JAWS_IO_Handler *ioh,
const char *buffer,
unsigned int length);
};
typedef ACE_Singleton<JAWS_Synch_IO, ACE_SYNCH_MUTEX>
JAWS_Synch_IO_Singleton;
// This only works on Win32
#if defined (ACE_WIN32) || defined (ACE_HAS_AIO_CALLS)
class JAWS_Export JAWS_Asynch_IO : public JAWS_IO
// = TITLE
//
// This class defines the interface for a Asynchronous I/O class.
//
// = DESCRIPTION
{
public:
JAWS_Asynch_IO (void);
virtual ~JAWS_Asynch_IO (void);
virtual void accept (JAWS_IO_Handler *ioh,
ACE_Message_Block *mb = 0,
unsigned int size = 0);
virtual void read (JAWS_IO_Handler *ioh,
ACE_Message_Block *mb,
unsigned int size);
virtual void transmit_file (JAWS_IO_Handler *ioh,
const char *filename,
const char *header,
unsigned int header_size,
const char *trailer,
unsigned int trailer_size);
virtual void receive_file (JAWS_IO_Handler *ioh,
const char *filename,
void *initial_data,
unsigned int initial_data_length,
unsigned int entire_length);
virtual void send_confirmation_message (JAWS_IO_Handler *ioh,
const char *buffer,
unsigned int length);
virtual void send_error_message (JAWS_IO_Handler *ioh,
const char *buffer,
unsigned int length);
enum Message_Types
{
CONFORMATION,
CONFIRMATION = CONFORMATION,
ERROR_MESSAGE
};
protected:
virtual void send_message (JAWS_IO_Handler *ioh,
const char *buffer,
unsigned int length,
int act);
};
typedef ACE_Singleton<JAWS_Asynch_IO, ACE_SYNCH_MUTEX>
JAWS_Asynch_IO_Singleton;
class JAWS_Export JAWS_Asynch2_IO : public JAWS_Asynch_IO
{
// This version of Asynch_IO has a do nothing accept() implementation.
public:
virtual void accept (JAWS_IO_Handler *ioh,
ACE_Message_Block *mb = 0,
unsigned int size = 0);
// does nothing
};
typedef ACE_Singleton<JAWS_Asynch2_IO, ACE_SYNCH_MUTEX>
JAWS_Asynch2_IO_Singleton;
#endif /* ACE_WIN32 */
#endif /* JAWS_IO_H */
|
