Building ACE Development Enviromen

Build ACE Development Enviroment

 

Many documents and the http://www.cs.wustl.edu/~schmidt/ACE-install.html have very detailed introduction of how to build ace package.

 

I will give a guidline of building ace development enviroment in this file.

My own development enviroment is using Windows XP and Vstudio7.0 (2003)

 

(1) Download ace package to the local machine.

Available download url: http://download.dre.vanderbilt.edu/

(2) Uncompress the ACE distribution into a directory, where it will create a ACE_wrappers directory containing the distribution. ACE_ROOT is the path of ACE_wrappers directory.

e.g I uncompress the ACE package to the root of D disk. So set the ACE_ROOT enviromental variable equal to D:/ ACE_wrappers. ACE_ROOT = D:/ ACE_wrappers.

(3) Create a file called config.h in the ACE_ROOT/ace directory that contains

#include "ace/config-win32.h"

(4) The static, DLL and MFC library builds are kept in different workspaces. Files with names *_Static contain project files for static builds. Workspaces for static and DLL builds will be available through the stock release at DOC group's website. The workspaces for MFC are not available and have to be generated using MPC. Please see MPC's README for details.(As the workspaces for MFC is a little complicated, so there I will focus on the static and dll libraries building and use these libraries to develop C++ program)

(5) Load ACE_ROOT/ACE.sln

(6) Building the ACE.

(7) Static version of ACE libraries are built with ACE_AS_STATIC_LIBS defined. This macro should also be used in application projects that link to static ACE libraries.Optionally you can also add the line

#define ACE_NO_INLINE

before the #include statement in ACE_ROOT/ace/config.h to disable inline function and reduce the size of static libraries (and your executables.)

(8) ACE DLL and LIB naming scheme:We use the following rules to name the DLL and LIB files in ACE when using MSVC.

"Library/DLL name" + (Is static library ? "s" : "") + (Is Debugging enable ? "d" : "") + {".dll"|".lib"}

 

Create a test project using ACE.

Brief description of this test project:

An Acceptor creates listening port, and accepts a connection. Use local url: “127.0.0.1”.

A Connector connects to acceptor and it will get some words from the acceptor.

(9) Create 2 Win32 console project using VS7.1 in one solution workspace. Refer to the source code at the end of this file.

(10) Set projects’ properties.

General	Character Set: Use Mult-Byte Character set
C/C++
General	Additional Include Directories : D:/ACE_wrappers
Code Generation	Basic Runtime Checks: Both(/RTC1, equiv. to /RTCsu) Runtime Library: Multi-threaded Debug DLL(/MDd) Buffer Security Check: yes Enable Function-Level Linking: yes
Linker
General	Additional Library Directories: D:/ACE_wrappers/lib
Input:	Additional Dependencies: ACEd.lib

 

testAcceptor.h

#pragma once #include <iostream> #include <cstring> #include <string.h> #include "ace/Auto_Ptr.h" #include "ace/INET_Addr.h" #include "ace/Log_Msg.h" #include "ace/SOCK_Acceptor.h" #include "ace/SOCK_Stream.h" #include "ace/Mem_Map.h"

 

testAcceptor.cpp

#include "testAcceptor.h" int main(int argc, char* argv[]) { ACE_INET_Addr server_addr; ACE_SOCK_Stream peer; ACE_SOCK_Acceptor acceptor; char buf[] = "hello client!"; if(server_addr.set(8890,"127.0.0.1") == -1) //port number is 8890, url: 127.0.0.1 { std::cout<<"Wrong port num/n"; exit(1); } if(acceptor.open(server_addr) == -1) { std::cout<<"Failure in open/n"; return 1; } for(;;) { if (acceptor.accept(peer) == -1) return 1; ACE_INET_Addr client_addr; if(peer.send_n(buf,sizeof(buf)) == -1){ std::cout<<"Send failure/n"; return 1; } peer.close(); } return acceptor.close() == -1 ? 1 : 0 ; }

testConnector.h

#pragma once #include <iostream> #include <tchar.h> #include "ace/INET_Addr.h" #include "ace/SOCK_Connector.h" #include "ace/SOCK_Stream.h"

 

testConnector.cpp

#include "testConnector.h" int main(int argc, char *argv[]) { const char *server_hostname = argc > 2 ? argv[2] : "127.0.0.1"; ACE_SOCK_Connector connector; ACE_SOCK_Stream peer; ACE_INET_Addr peer_addr; if(peer_addr.set(8890, server_hostname) == -1) { std::cout<<"addr set failure/n"; return 1; } if(connector.connect(peer, peer_addr) == -1){ std::cout<<"connect failure/n"; return 1; } char buf[BUFSIZ]; for(; ; ) { ssize_t n; n = peer.recv(buf,sizeof(buf)); if(n>0) ACE::write_n(ACE_STDOUT,buf,n); } peer.close(); return 0; }