來源：http://www.blogbus.com/blogbus/blog/index.php?blogid=13010
ACE的源碼劃分和library subsetting
前幾篇文章也提到過，ACE的所有源文件和頭文件都雜亂堆在了ACE_wrappers/ace目錄下。這樣的代碼組織方式給學(xué)習(xí)ACE帶來了很大的困難，很多朋友在看到ace目錄下龐大的代碼的時候，幾乎就失去了學(xué)習(xí)ACE的信心^_^。因此，我們有必要對ACE的代碼進(jìn)行重新組織，以降低學(xué)習(xí)曲線。下面，我將給出我對ACE源碼的劃分方法。其實，我也是剛學(xué)習(xí)ACE沒有多久，對ACE的了解還甚少，所以，我的源碼劃方式法不一定十分正確，這里共享出來，僅供大家參考。
其實，在ACE的幫助文檔里，ACE-subsets.html和ACE-categories.html，這兩個文檔對指導(dǎo)ACE的源碼劃分起到了很大的作用，否則，我剛剛接觸ACE，就想對其進(jìn)行源碼劃分，是不可能完成的。
ACE-subsets.html，這個文檔主要介紹了ACE的library subsetting。正常情況下，在編譯完ACE后，只會產(chǎn)生一個ACE的庫。我們可以根據(jù)該文檔的介紹，簡單的修改一下Makefile，就可以對ACE的庫進(jìn)行子集化，我們可以編譯出OS、Thread等這樣的子庫。
ACE-categories.html，這個文檔對ACE中的代碼進(jìn)行了一些功能上的分類。具體大家可以詳細(xì)的參考一下這兩個文檔，這兩個文檔對學(xué)習(xí)ACE還是有一定的幫助的。
在ACE的源代碼目錄ace下，我將建立很多子目錄，來對ACE的代碼進(jìn)行按功能分類：
ACE_OS：該目錄里包含的代碼是OS的API的wrapper，也就是ACE的OS適配層；
包含代碼： ARGV.cpp???????? OS_Memory.cpp
? Argv_Type_Converter.cpp??? OS_QoS.cpp
? Base_Thread_Adapter.cpp??? OS_String.cpp
? Basic_Types.cpp??????????? OS_TLI.cpp
? Copy_Disabled.cpp????????? OS_Thread_Adapter.cpp
? Env_Value_T.cpp??????????? Sched_Params.cpp
? Handle_Set.cpp??????? Template_Instantiations.cpp
? Makefile?????????????????? Thread_Hook.cpp
? OS.cpp???????????????????? Time_Value.cpp
? OS_Dirent.cpp????????????????
? OS_Errno.cpp?????????????????
? OS_Log_Msg_Attributes.cpp
ACE_Codec：該目錄包含的是ACE的各種編碼類型的處理代碼，目前只包含了BASE64編碼的處理；
??? 包含代碼：Codecs.cpp?? Makefile
ACE_Connection：該目錄包含的是ACE中的Acceptor-Connector框架代碼和異步通訊類代碼；
? 包含代碼：Acceptor.cpp?????????? Connector.cpp
?? Asynch_Acceptor.cpp???????????? Makefile
?? Asynch_Connector.cpp??????? POSIX_Asynch_IO.cpp
?? Asynch_IO.cpp?????????????????? Strategies_T.cpp
?? Asynch_IO_Impl.cpp????????????? Svc_Handler.cpp
?? Asynch_Pseudo_Task.cpp????? WIN32_Asynch_IO.cpp
?? Cached_Connect_Strategy_T.cpp??
?? Caching_Strategies_T.cpp???????
ACE_Demux：該目錄包含的是ACE中的Reactor和Proactor框架代碼；
??? 包含代碼：Dev_Poll_Reactor.cpp???? Priority_Reactor.cpp????? TP_Reactor.cpp??????? Event_Handler.cpp???????? Proactor.cpp????????????? TkReactor.cpp
? Event_Handler_T.cpp?????? QtReactor.cpp???????????? WFMO_Reactor.cpp
? FlReactor.cpp??????????? Reactor.cpp?????????????? WIN32_Proactor.cpp
? Makefile????????????????? SUN_Proactor.cpp????????? XtReactor.cpp
? Msg_WFMO_Reactor.cpp????? Select_Reactor.cpp???????
? POSIX_CB_Proactor.cpp???? Select_Reactor_Base.cpp??
? POSIX_Proactor.cpp??????? Select_Reactor_T.cpp
ACE_IPC：該目錄包含的是ACE中進(jìn)程間通訊的一些封裝代碼：
? 包含代碼：ATM_Acceptor.cpp???????????? Makefile
? ATM_Addr.cpp???????????????? Pipe.cpp
? ATM_Connector.cpp??????????? SPIPE.cpp
? ATM_Params.cpp?????????????? SPIPE_Acceptor.cpp
? ATM_QoS.cpp????????????????? SPIPE_Addr.cpp
? ATM_Stream.cpp?????????????? SPIPE_Connector.cpp
? DEV.cpp????????????????????? SPIPE_Stream.cpp
? DEV_Addr.cpp???????????????? SV_Message.cpp
? DEV_Connector.cpp??????????? SV_Message_Queue.cpp
? DEV_IO.cpp?????????????????? SV_Semaphore_Complex.cpp
? FIFO.cpp???????????????????? SV_Semaphore_Simple.cpp
? FIFO_Recv.cpp??????????????? SV_Shared_Memory.cpp
? FIFO_Recv_Msg.cpp??????????? Signal.cpp
? FIFO_Send.cpp??????????????? TLI.cpp
? FIFO_Send_Msg.cpp??????????? TLI_Acceptor.cpp
? FILE.cpp???????????????????? TLI_Connector.cpp
? FILE_Addr.cpp??????????????? TLI_Stream.cpp
? FILE_Connector.cpp?????????? TTY_IO.cpp
? FILE_IO.cpp????????????????? Typed_SV_Message.cpp
? IOStream.cpp???????????????? Typed_SV_Message_Queue.cpp
? IOStream_T.cpp?????????????? UNIX_Addr.cpp
? IO_SAP.cpp?????????????????? UPIPE_Acceptor.cpp
? MEM_Acceptor.cpp???????????? UPIPE_Connector.cpp
? MEM_Addr.cpp???????????????? UPIPE_Stream.cpp
? MEM_Connector.cpp??????????? XTI_ATM_Mcast.cpp
? MEM_IO.cpp??????????????????
? MEM_SAP.cpp?????????????????
? MEM_Stream.cpp
ACE_LIB：該目錄將包含ACE編譯好的各個子庫；
ACE_Logging：該目錄包含ACE中的日志處理相關(guān)代碼；
?????? 包含代碼：Dump.cpp?????????????????? Log_Msg_UNIX_Syslog.cpp
? Dump_T.cpp???????????????? Log_Record.cpp
? Log_Msg.cpp??????????????? Logging_Strategy.cpp
? Log_Msg_Backend.cpp??????? Makefile
? Log_Msg_Callback.cpp?????? Trace.cpp
? Log_Msg_IPC.cpp???????????
? Log_Msg_NT_Event_Log.cpp??
ACE_Memory：該目錄包含了ACE內(nèi)存處理相關(guān)代碼；
???? 包含代碼：Based_Pointer_Repository.cpp?? Obstack.cpp
? Based_Pointer_T.cpp??????????? Obstack_T.cpp
? Makefile?????????????????????? PI_Malloc.cpp
? Malloc.cpp???????????????????? Read_Buffer.cpp
? Malloc_Allocator.cpp?????????? Shared_Memory.cpp
? Malloc_Instantiations.cpp????? Shared_Memory_MM.cpp
? Malloc_T.cpp?????????????????? Shared_Memory_SV.cpp
? Mem_Map.cpp???????????????????
? Memory_Pool.cpp???????????????
? Obchunk.cpp
ACE_Misc：ACE中一些沒有明確功能分類的代碼，屬于雜項；
?? 包含代碼：CE_Screen_Output.cpp?? NT_Service.cpp
? Makefile?????????????? gethrtime.cpp
ACE_Nameservices：該目錄包含了ACE中名字服務(wù)相關(guān)代碼；
??? 包含代碼： Name_Space.cpp
?? Local_Name_Space.cpp?????????? Naming_Context.cpp
?? Local_Name_Space_T.cpp???????? Registry_Name_Space.cpp
?? Makefile?????????????????????? Remote_Name_Space.cpp
?? Name_Proxy.cpp????????????????
?? Name_Request_Reply.cpp????????
ACE_Sockets：該目錄包含的是ACE的socket封裝代碼；
????? 包含代碼：Addr.cpp?????????????????????? SOCK_CODgram.cpp
? INET_Addr.cpp????????????????? SOCK_Connector.cpp
? IPC_SAP.cpp??????????????????? SOCK_Dgram.cpp
? LOCK_SOCK_Acceptor.cpp???????? SOCK_Dgram_Bcast.cpp
? LSOCK.cpp????????????????????? SOCK_Dgram_Mcast.cpp
? LSOCK_Acceptor.cpp???????????? SOCK_IO.cpp
? LSOCK_CODgram.cpp????????????? SOCK_SEQPACK_Acceptor.cpp
? LSOCK_Connector.cpp??????????? SOCK_SEQPACK_Association.cpp
? LSOCK_Dgram.cpp??????????????? SOCK_SEQPACK_Connector.cpp
? LSOCK_Stream.cpp?????????????? SOCK_Stream.cpp
? Makefile?????????????????????? Sock_Connect.cpp
? Multihomed_INET_Addr.cpp??????
? SOCK.cpp??????????????????????
? SOCK_Acceptor.cpp
ACE_Streams：該目錄包含了ACE中的Streams和Task框架代碼；
????? 包含代碼：CDR_Base.cpp??????????????????????? Module.cpp
? CDR_Stream.cpp????????????????????? Multiplexor.cpp
? Codeset_IBM1047.cpp???????????????? Reactor_Notification_Strategy.cpp
? Codeset_Registry.cpp??????????????? Stream.cpp
? Codeset_Registry_db.cpp???????????? Stream_Modules.cpp
? IO_Cntl_Msg.cpp???????????????????? Task.cpp
? Makefile??????????????????????????? Task_T.cpp
? Message_Queue.cpp??????????????????
? Message_Queue_T.cpp???
ACE_Svcconf：該目錄包含了ACE中的Service Configurator框架代碼；
????? 包含代碼：DLL.cpp??????????????????? Service_Types.cpp
? DLL_Manager.cpp??????????? Shared_Object.cpp
? Dynamic_Service.cpp??????? Svc_Conf.l
? Dynamic_Service_Base.cpp?? Svc_Conf.y
? Makefile?????????????????? Svc_Conf_Lexer_Guard.cpp
? Parse_Node.cpp???????????? Svc_Conf_l.cpp
? Service_Config.cpp???????? Svc_Conf_y.cpp
? Service_Manager.cpp??????? XML_Svc_Conf.cpp
? Service_Object.cpp????????
? Service_Repository.cpp????
? Service_Templates.cpp
ACE_Threads：該目錄包含了ACE中的線程和同步機(jī)制相關(guān)代碼，例如：thread manager;
????? 包含代碼：Activation_Queue.cpp????? Process_Manager.cpp?????? Thread.cpp
? Atomic_Op.cpp???????????? Process_Mutex.cpp???????? Thread_Adapter.cpp
? Atomic_Op_T.cpp?????????? Process_Semaphore.cpp???? Thread_Control.cpp
? File_Lock.cpp???????????? RW_Process_Mutex.cpp????? Thread_Exit.cpp
? Future.cpp??????????????? Synch.cpp???????????????? Thread_Manager.cpp
? Future_Set.cpp??????????? Synch_Options.cpp???????? Token.cpp
? Makefile????????????????? Synch_T.cpp??????????????
? Process.cpp?????????????? Test_and_Set.cpp?????????
ACE_Timer：該目錄包含ACE中和時間相關(guān)的代碼；
???? 包含代碼：Timer_Heap.cpp
? Basic_Stats.cpp??????????? Timer_Heap_T.cpp
? High_Res_Timer.cpp???????? Timer_List.cpp
? Makefile?????????????????? Timer_List_T.cpp
? Profile_Timer.cpp????????? Timer_Queue.cpp
? System_Time.cpp??????????? Timer_Queue_Adapters.cpp
? Time_Request_Reply.cpp???? Timer_Queue_T.cpp
? Timeprobe.cpp????????????? Timer_Wheel.cpp
? Timeprobe_T.cpp??????????? Timer_Wheel_T.cpp
? Timer_Hash.cpp????????????
? Timer_Hash_T.cpp??????????
ACE_Token：Token是ACE中實現(xiàn)的一種同步機(jī)制，保證嚴(yán)格的FIFO或LIFO策略來獲得鎖。ACE通過Token機(jī)制實現(xiàn)了分布式同步機(jī)制。
???? 包含代碼：Local_Tokens.cpp????????? Token_Collection.cpp????? Token_Request_Reply.cpp
? Makefile????????????????? Token_Invariants.cpp?????
? Remote_Tokens.cpp???????? Token_Manager.cpp????????
ACE_Utils：ACE中的一些基礎(chǔ)數(shù)據(jù)結(jié)構(gòu)和算法的工具類代碼；
??? 包含代碼：ACE.cpp???????????????????????????? Init_ACE.cpp
? Active_Map_Manager.cpp????????????? Intrusive_List.cpp
? Active_Map_Manager_T.cpp??????????? Intrusive_List_Node.cpp
? Arg_Shifter.cpp???????????????????? Lib_Find.cpp
? Array_Base.cpp????????????????????? Makefile
? Auto_IncDec_T.cpp?????????????????? Managed_Object.cpp
? Auto_Ptr.cpp??????????????????????? Map.cpp
? Cache_Map_Manager_T.cpp???????????? Map_Manager.cpp
? Caching_Utility_T.cpp?????????????? Map_T.cpp
? Capabilities.cpp??????????????????? Message_Block.cpp
? Cleanup_Strategies_T.cpp??????????? Message_Block_T.cpp
? Configuration.cpp?????????????????? Method_Request.cpp
? Configuration_Import_Export.cpp???? Node.cpp
? Connection_Recycling_Strategy.cpp?? Notification_Strategy.cpp
? Containers.cpp????????????????????? Object_Manager.cpp
? Containers_T.cpp??????????????????? Pair.cpp
? Date_Time.cpp?????????????????????? Pair_T.cpp
? Dirent.cpp????????????????????????? RB_Tree.cpp
? Dirent_Selector.cpp???????????????? Recyclable.cpp
? Dynamic.cpp???????????????????????? Refcountable.cpp
? Filecache.cpp?????????????????????? Registry.cpp
? Flag_Manip.cpp????????????????????? SString.cpp
? Framework_Component.cpp???????????? Sample_History.cpp
? Framework_Component_T.cpp?????????? Singleton.cpp
? Free_List.cpp?????????????????????? Stats.cpp
? Functor.cpp???????????????????????? String_Base.cpp
? Functor_T.cpp?????????????????????? String_Base_Const.cpp
? Get_Opt.cpp???????????????????????? Swap.cpp
? Handle_Ops.cpp????????????????????? Unbounded_Queue.cpp
? Hash_Cache_Map_Manager_T.cpp??????? Unbounded_Set.cpp
? Hash_Map_Manager.cpp??????????????? Unbounded_Set_Ex.cpp
? Hash_Map_Manager_T.cpp????????????? Vector_T.cpp
? Hash_Map_With_Allocator_T.cpp??????
? Hashable.cpp???????????????????????
include：該目錄又包含子目錄ace，也就是說include/ace/目錄下，包含了ACE的所有頭文件和.i文件，之所以這樣組織，是因為ACE中的源 文件和頭文件的包含文件的方式為：#include "ace/OS.h"，所以采用這種目錄結(jié)構(gòu)方式來存放頭文件和.i文件。這里，對頭文件和.i? 文件，沒有進(jìn)一步按照功能劃分，就是因為#include "ace/OS.h"這種包含方式，如果頭文件和.i文件也按照功能劃分，那么代碼修改 量相當(dāng)大；
????????????
通過上面給出的目錄結(jié)構(gòu)和源文件功能劃分及頭文件組織方式，相信讀者以可以自行對ACE代碼進(jìn)行整理了。在實際整理和編譯代碼的過程中，需要修改Makefile和ACE頭文件中以_T方式為后綴的頭文件，例如：Obstack_T.h，需要修改里面模板源文件包含路徑。我將在下一篇文章中進(jìn)行描述。
我再次強(qiáng)調(diào)，上面ACE源碼劃分方式，不一定十分正確^_^，隨著我們ACE學(xué)習(xí)和理解的深入，我們可能會進(jìn)行更改。其實，在我們整理ACE源文件的時候，我們可以進(jìn)一步了解ACE的各個源文件大致功能，對我們以后更深入的學(xué)習(xí)大有裨益。