前幾篇文章也提到過(guò),ACE的所有源文件和頭文件都雜亂堆在了ACE_wrappers/ace目錄下。這樣的代碼組織方式給學(xué)習(xí)ACE帶來(lái)了很大的困難,很多朋友在看到ace目錄下龐大的代碼的時(shí)候,幾乎就失去了學(xué)習(xí)ACE的信心^_^。因此,我們有必要對(duì)ACE的代碼進(jìn)行重新組織,以降低學(xué)習(xí)曲線。下面,我將給出我對(duì)ACE源碼的劃分方法。其實(shí),我也是剛學(xué)習(xí)ACE沒(méi)有多久,對(duì)ACE的了解還甚少,所以,我的源碼劃方式法不一定十分正確,這里共享出來(lái),僅供大家參考。
其實(shí),在ACE的幫助文檔里,ACE-subsets.html和ACE-categories.html,這兩個(gè)文檔對(duì)指導(dǎo)ACE的源碼劃分起到了很大的作用,否則,我剛剛接觸ACE,就想對(duì)其進(jìn)行源碼劃分,是不可能完成的。ACE-subsets.html,這個(gè)文檔主要介紹了ACE的library subsetting。正常情況下,在編譯完ACE后,只會(huì)產(chǎn)生一個(gè)ACE的庫(kù)。我們可以根據(jù)該文檔的介紹,簡(jiǎn)單的修改一下Makefile,就可以對(duì)ACE的庫(kù)進(jìn)行子集化,我們可以編譯出OS、Thread等這樣的子庫(kù)。ACE-categories.html,這個(gè)文檔對(duì)ACE中的代碼進(jìn)行了一些功能上的分類。具體大家可以詳細(xì)的參考一下這兩個(gè)文檔,這兩個(gè)文檔對(duì)學(xué)習(xí)ACE還是有一定的幫助的。
在ACE的源代碼目錄ace下,我將建立很多子目錄,來(lái)對(duì)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編譯好的各個(gè)子庫(kù);
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中一些沒(méi)有明確功能分類的代碼,屬于雜項(xiàng);
包含代碼: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中和時(shí)間相關(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中實(shí)現(xiàn)的一種同步機(jī)制,保證嚴(yán)格的FIFO或LIFO策略來(lái)獲得鎖。ACE通過(guò)Token機(jī)制實(shí)現(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,也就是說(shuō)include/ace/目錄下,包含了ACE的所有頭文件和.i文件,之所以這樣組織,是因?yàn)?A class=keyword ace/OS.h",所以采用這種目錄結(jié)構(gòu)方式來(lái)存放頭文件和.i文件。這里,對(duì)頭文件和.i 文件,沒(méi)有進(jìn)一步按照功能劃分,就是因?yàn)?include "ace/OS.h"這種包含方式,如果頭文件和.i文件也按照功能劃分,那么代碼修改 量相當(dāng)大;
通過(guò)上面給出的目錄結(jié)構(gòu)和源文件功能劃分及頭文件組織方式,相信讀者以可以自行對(duì)ACE代碼進(jìn)行整理了。在實(shí)際整理和編譯代碼的過(guò)程中,需要修改Makefile和ACE頭文件中以_T方式為后綴的頭文件,例如:Obstack_T.h,需要修改里面模板源文件包含路徑。我將在下一篇文章中進(jìn)行描述。
我再次強(qiáng)調(diào),上面ACE源碼劃分方式,不一定十分正確^_^,隨著我們ACE學(xué)習(xí)和理解的深入,我們可能會(huì)進(jìn)行更改。其實(shí),在我們整理ACE源文件的時(shí)候,我們可以進(jìn)一步了解ACE的各個(gè)源文件大致功能,對(duì)我們以后更深入的學(xué)習(xí)大有裨益。