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
|
/* -*- c++ -*- */
// Hey, Emacs! This is a C++ file!
// $Id$
// ============================================================================
//
// = LIBRARY
// jaws
//
// = FILENAME
// IO.h
//
// = AUTHOR
// James Hu
//
// ============================================================================
#if !defined (JAWS_IO_H)
#define JAWS_IO_H
class ACE_Message_Block;
class JAWS_IO_Handler;
class JAWS_IO_Acceptor;
#include "ace/ACE.h"
#include "ace/Asynch_IO.h"
#include "ace/SOCK_Stream.h"
class 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 handler (JAWS_IO_Handler *handler);
void acceptor (JAWS_IO_Acceptor *acceptor);
void handle (ACE_HANDLE h);
ACE_HANDLE handle (void);
// James, please add documentation here.
virtual void accept (ACE_SOCK_Stream &new_stream) = 0;
// accept a passive connection
virtual void read (ACE_Message_Block& mb, int size) = 0;
// read from the handle size bytes into the message block.
virtual void transmit_file (const char *filename,
const char *header,
int header_size,
const char *trailer,
int trailer_size) = 0;
// send header, filename, trailer to the handle.
virtual void receive_file (const char *filename,
void *initial_data,
int initial_data_length,
int entire_length) = 0;
// read data from the handle and store in filename.
virtual void send_confirmation_message (const char *buffer, int length) = 0;
// send a confirmation message to the handle.
virtual void send_error_message (const char *buffer, int length) = 0;
// send an error message to the handle.
protected:
ACE_HANDLE handle_;
JAWS_IO_Handler *handler_;
JAWS_IO_Acceptor *acceptor_;
};
class JAWS_Synch_IO : public JAWS_IO
// = TITLE
//
// This class defines the interface for a Synchronous I/O class.
//
// = DESCRIPTION
{
public:
JAWS_Synch_IO (void);
~JAWS_Synch_IO (void);
virtual void accept (ACE_SOCK_Stream &new_stream);
void read (ACE_Message_Block& mb, int size);
void transmit_file (const char *filename,
const char *header,
int header_size,
const char *trailer,
int trailer_size);
void receive_file (const char *filename,
void *initial_data,
int initial_data_length,
int entire_length);
void send_confirmation_message (const char *buffer,
int length);
void send_error_message (const char *buffer,
int length);
protected:
virtual void send_message (const char *buffer,
int length);
};
// This only works on Win32
#if defined (ACE_WIN32)
class JAWS_Asynch_IO : public JAWS_IO, public ACE_Handler
// = TITLE
//
// This class defines the interface for a Asynchronous I/O class.
//
// = DESCRIPTION
{
public:
JAWS_Asynch_IO (void);
~JAWS_Asynch_IO (void);
void read (ACE_Message_Block& mb, int size);
void transmit_file (const char *filename,
const char *header,
int header_size,
const char *trailer,
int trailer_size);
void receive_file (const char *filename,
void *initial_data,
int initial_data_length,
int entire_length);
void send_confirmation_message (const char *buffer,
int length);
void send_error_message (const char *buffer,
int length);
protected:
enum Message_Types
{
CONFORMATION,
ERROR_MESSAGE
};
virtual void send_message (const char *buffer,
int length,
int act);
virtual void handle_read_stream (const ACE_Asynch_Read_Stream::Result &result);
// This method will be called when an asynchronous read completes on
// a stream.
virtual void handle_write_stream (const ACE_Asynch_Write_Stream::Result &result);
// This method will be called when an asynchronous write completes
// on a stream.
virtual void handle_transmit_file (const ACE_Asynch_Transmit_File::Result &result);
// This method will be called when an asynchronous transmit file
// completes.
};
#endif /* ACE_WIN32 */
#endif /* JAWS_IO_H */
|
