summaryrefslogtreecommitdiff
path: root/docs/tutorials/003/page01.html
blob: cbb0a47c8bc454890457f1232d51aba18d0b1455 (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
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
<HTML>
<HEAD>
   <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
   <META NAME="GENERATOR" CONTENT="Mozilla/4.04 [en] (X11; I; Linux 2.0.32 i486) [Netscape]">
   <META NAME="Author" CONTENT="James CE Johnson">
   <META NAME="Description" CONTENT="A first step towards using ACE productively">
   <TITLE>ACE Tutorial 003</TITLE>
</HEAD>
<BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#000FFF" VLINK="#FF0F0F">

<CENTER><B><FONT SIZE=+2>ACE Tutorial 003</FONT></B></CENTER>

<CENTER><B><FONT SIZE=+2>Creating a Simple Client</FONT></B></CENTER>


<P>
<HR WIDTH="100%">

<P>Now that we've seen how to create servers, let's spend just a moment
making a client. Since this is so easy, I'm going to do all of it in this
one page.

<P>
<HR WIDTH="100%">
<PRE>/*
  To establish a socket connection to a server, we'll need an ACE_SOCK_Connector.
 */
#include "ace/SOCK_Connector.h"

/*
  Unlike the previous two Tutorials, we're going to allow the user to provide
  command line options this time.  Still, we need defaults in case that isn't
  done.
 */
static u_short SERVER_PORT = ACE_DEFAULT_SERVER_PORT;
static const char *const SERVER_HOST = ACE_DEFAULT_SERVER_HOST;
static const int MAX_ITERATIONS = 4;

int main (int argc, char *argv[])
{
  /*
    Accept the users's choice of hosts or use the default.  Then do the same
    for the TCP/IP port at which the server is listening as well as the
    number of iterations to perform.
   */
  const char *server_host = argc > 1 ? argv[1]                : SERVER_HOST;
  u_short server_port     = argc > 2 ? ACE_OS::atoi (argv[2]) : SERVER_PORT;
  int max_iterations      = argc > 3 ? ACE_OS::atoi (argv[3]) : MAX_ITERATIONS;

  /*
    Build ourselves a Stream socket. This is a connected socket that provides
    reliable end-to-end communications. We will use the server object to send
    data to the server we connect to.
   */
  ACE_SOCK_Stream server;

  /*
    And we need a connector object to establish that connection. The ACE_SOCK_Connector
    object provides all of the tools we need to establish a connection once we know the
    server's network address... 
   */
  ACE_SOCK_Connector connector;

  /*
    Which we create with an ACE_INET_Addr object. This object is given the TCP/IP port
    and hostname of the server we want to connect to.
   */
  ACE_INET_Addr addr (server_port, server_host);

  /*
    So, we feed the Addr object and the Stream object to the connector's connect() member
    function. Given this information, it will establish the network connection to the
    server and attacht that connection to the server object. 
   */
  if (connector.connect (server, addr) == -1)
  {
    ACE_ERROR_RETURN ((LM_ERROR, "%p\n", "open"), -1);
  }
  
  /*
    Just for grins, we'll send the server several messages.
   */
  for (int i = 0; i &lt; max_iterations; i++)
  {
    char buf[BUFSIZ];

    /*
      Create our message with the message number
     */
    ACE_OS::sprintf (buf, "message = %d\n", i + 1);

    /*
      Send the message to the server.  We use the server object's send_n() function to
      send all of the data at once. There is also a send() function but it may not send
      all of the data. That is due to network buffer availability and such. If the send()
      doesn't send all of the data, it is up to you to program things such that it will
      keep trying until all of the data is sent or simply give up. The send_n() function
      already does the "keep tyring" option for us, so we use it. 
     */
    if (server.send_n ( buf, strlen(buf) ) == -1)
    {
      ACE_ERROR_RETURN ((LM_ERROR, "%p\n", "send"), -1);
    }
    else
    {
      /*
        Pause for a second.
       */
      ACE_OS::sleep (1);
    }
  }

  /*
    Close the connection to the server.  The servers we've created so far all are based
    on the ACE_Reactor.  When we close(), the server's reactor will see activity for
    the registered event handler and invoke handle_input().  That, in turn, will try
    to read from the socket but get back zero bytes.  At that point, the server will know
    that we've closed from our side.
   */
  if (server.close () == -1)
  {
    ACE_ERROR_RETURN ((LM_ERROR, "%p\n", "close"), -1);
  }

  return 0;
}</PRE>

<HR WIDTH="100%">

<P>Ok, so that was pretty easy. What would be even easier would be to wrap
all of the connection mess up in an object and overload a couple of basic
operators to make things less network-centric. Perhaps we'll see that in
another tutorial.

<P>If you want to compile it yourself, here's the <A HREF="client.cpp">source</A>,
the <A HREF="Makefile">Makefile</A>,
and <A HREF="00SetEnv">Environment
settings</A>.

<P>
<HR WIDTH="100%">
<CENTER>[<A HREF="..">Tutorial
Index</A>]</CENTER>

</BODY>
</HTML>