ACE的源码划分

前几篇文章也提到过,ACE的所有源文件和头文件都杂乱堆在了ACE_wrappers/ace目录下。这样的代码组织方式给学习ACE带来了很大的困难,很多朋友在看到ace目录下庞大的代码的时候,几乎就失去了学习ACE的信心^_^。因此,我们有必要对ACE的代码进行重新组织,以降低学习曲线。下面,我将给出我对ACE源码的划分方法。其实,我也是刚学习ACE没有多久,对ACE的了解还甚少,所以,我的源码划方式法不一定十分正确,这里共享出来,仅供大家参考。

其实,在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的各个源文件大致功能,对我们以后更深入的学习大有裨益。

时间: 2024-08-25 14:38:33

ACE的源码划分的相关文章

Nginx 源码结构分析

Nginx 源码基本结构 学习 Nginx 的构架之前,对 Nginx 源码结构进行简单的分析,可以了解 Nginx 模块结构以及模块之间的关系.充分理解 Nginx 的基本构架.解压源码到相应的文件后,我们可以看到有一个存放源码的目录文件 src,该目录文件存储 Nginx 所有的源代码.首先,我们通过命令查看源码的组织结构: $ tree -L 1 . ├── core ├── event ├── http ├── mail ├── misc └── os 6 directories, 0

Spark源码阅读(1): Stage划分

Spark中job由action动作生成,那么stage是如何划分的呢?一般的解答是根据宽窄依赖划分.那么我们深入源码看看吧 一个action 例如count,会在多次runJob中传递,最终会到一个函数 dagScheduler.runJob(rdd, cleanedFunc, partitions, callSite, resultHandler, localProperties.get)dagScheduler是DAGScheduler的一个实例,因此,后面的工作都交给DAGSchedul

[Spark传奇行动] 第34课:Stage划分和Task最佳位置算法源码彻底解密

本課主題 Job Stage 划分算法解密 Task 最佳位置算法實現解密 引言 作业调度的划分算法以及 Task 的最佳位置的算法,因为 Stage 的划分是DAGScheduler 工作的核心,这也是关系到整个作业有集群中该怎么运行:其次就是数据本地性,Spark 一舨的代码都是链式表达的,这就让一个任务什么时候划分成 Stage,在大数据世界要追求最大化的数据本地性,所有最大化的数据本地性就是在数据计算的时候,数据就在内存中.最后就是 Spark 的实现算法时候的略的怎么样.希望这篇文章能

Spark技术内幕:Stage划分及提交源码分析

当触发一个RDD的action后,以count为例,调用关系如下: org.apache.spark.rdd.RDD#count org.apache.spark.SparkContext#runJob org.apache.spark.scheduler.DAGScheduler#runJob org.apache.spark.scheduler.DAGScheduler#submitJob org.apache.spark.scheduler.DAGSchedulerEventProcess

ACE - Reactor模式源码剖析及具体实现(大量源码慎入)

原文出自http://www.cnblogs.com/binchen-china,禁止转载. 在之前的文章中提到过Reactor模式和Preactor模式,现在利用ACE的Reactor来实现一个基于Reactor框架的服务器. 首先回顾下Reactor模式和Preactor模式. Reactor模式: Reactor模式实现非常简单,使用同步IO模型,即业务线程处理数据需要主动等待或询问,主要特点是利用epoll监听listen描述符是否有响应,及时将客户连接信息放于一个队列,epoll和队列

Ace 1.3.1 网站管理后台源码 Bootstrap响应式模板主题

Ace 响应式管理后台模板最新版本v1.3.1同步升级,欢迎下载使用,注意:本站提供为官网购买压缩源码版,在官网上用18$买来,现只售20元,可以帮亲省3/4的额外开销哦,需要的亲可以到本博的淘宝小店购买,包升级(免费!). Ace简介: Ace (v1.3.1)是一个轻量.功能丰富.HTML5.响应式.支持手机及平板电脑上浏览的管理后台模板,基于CSS框架Bootstrap制作,Bootstrap版本更新至 3.0,Ace – Responsive Admin Template当前最新版! 淘

Spark源码剖析(八):stage划分原理与源码剖析

引言 对于Spark开发人员来说,了解stage的划分算法可以让你知道自己编写的spark application被划分为几个job,每个job被划分为几个stage,每个stage包括了你的哪些代码,只有知道了这些之后,碰到某个stage执行特别慢或者报错,你才能快速定位到对应的代码,对其进行性能优化和排错. stage划分原理与源码 接着上期内核源码(五)的最后,每个action操作最终会调用SparkContext初始化时创建的DAGSchedule的runJob方法创建一个job: 那么

2016年最牛逼的分类Android项目源码免费一次性打包下载!

之前发过一个帖子,但是那个帖子有点问题我就重新发一个吧,下面的源码是我从今年开始不断整理源码区和其他网站上的安卓例子源码,目前总共有810套左右,根据实现的功能被我分成了100多个类,总共接近2.5G,还在不断更新.初学者可以快速方便的找到自己想要的例子,大神也可以看一下别人的方法实现.虽然的例子都是我一个人辛辛苦苦花了很多时间和精力整理的,但是既然这些例子是来自于社区那就让他们免费回归社区吧,(是的!特么的不要一分钱!最看不起那些挂羊头卖狗的)你可以在本帖里面按Ctrl+F查找你需要的关键字,

Chrome自带恐龙小游戏的源码研究(完)

在上一篇<Chrome自带恐龙小游戏的源码研究(七)>中研究了恐龙与障碍物的碰撞检测,这一篇主要研究组成游戏的其它要素. 游戏分数记录 如图所示,分数及最高分记录显示在游戏界面的右上角,每达到100分就会出现闪烁特效,游戏第一次gameover时显示历史最高分.分数记录器由DistanceMeter构造函数实现,以下是它的全部代码: 1 DistanceMeter.dimensions = { 2 WIDTH: 10, //每个字符的宽度 3 HEIGHT: 13, //每个字符的高 4 DE