其实,在ACE的帮助文档里,ACE-subsets.html和ACE-categories.html,这两个文档对指导ACE的源码划分起到了很大的作用,否则,我刚刚接触ACE,就想对其进行源码划分,是不可能完成的。
ACE-subsets.html,这个文档主要介绍了ACE的library subsetting。正常情况下,在编译完ACE后,只会产生一个ACE的库。我们可以根据该文档的介绍,简单的修改一下Makefile,就可以对ACE的库进行子集化,我们可以编译出OS、Thread等这样的子库。
ACE-categories.html,这个文档对ACE中的代码进行了一些功能上的分类。具体大家可以详细的参考一下这两个文档,这两个文档对学习ACE还是有一定的帮助的。
在ACE的源代码目录ace下,我将建立很多子目录,来对ACE的代码进行按功能分类:
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中进程间通讯的一些封装代码: 包含代码: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中的日志处理相关代码; 包含代码: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内存处理相关代码; 包含代码: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中名字服务相关代码; 包含代码: 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中的线程和同步机制相关代码,例如: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中和时间相关的代码; 包含代码: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中实现的一种同步机制,保证严格的FIFO或LIFO策略来获得锁。ACE通过Token机制实现了分布式同步机制。 包含代码:Local_Tokens.cpp Token_Collection.cpp Token_Request_Reply.cpp Makefile Token_Invariants.cpp Remote_Tokens.cpp Token_Manager.cpp
ACE_Utils:ACE中的一些基础数据结构和算法的工具类代码; 包含代码: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",所以采用这种目录结构方式来存放头文件和.i文件。这里,对头文件和.i 文件,没有进一步按照功能划分,就是因为#include "ace/OS.h"这种包含方式,如果头文件和.i文件也按照功能划分,那么代码修改 量相当大;
通过上面给出的目录结构和源文件功能划分及头文件组织方式,相信读者以可以自行对ACE代码进行整理了。在实际整理和编译代码的过程中,需要修改Makefile和ACE头文件中以_T方式为后缀的头文件,例如:Obstack_T.h,需要修改里面模板源文件包含路径。我将在下一篇文章中进行描述。
我再次强调,上面ACE源码划分方式,不一定十分正确^_^,随着我们ACE学习和理解的深入,我们可能会进行更改。其实,在我们整理ACE源文件的时候,我们可以进一步了解ACE的各个源文件大致功能,对我们以后更深入的学习大有裨益。