Axis2/C入门教程之四(仓库文件夹(Repository Folder)介绍)

仓库(Repository)是一个存储所有Axis2/C相关配置及服务和模块的文件夹。

仓库文件夹结构如下图所示:

可以为仓库文件夹指定任意名称(本例中为axis2c_repo)。它包含了3个子文件夹及axis2.xml配置文件。

各文件夹的用途如下表所示。

Axis2/C仓库目录
文件夹/文件名称 描述
lib lib文件夹包含Axis2/C引擎所需的库。虽然用户可选择Axis2/C共享库的位置,但动态加载的共享库,解析器,传输接收器及传输发送器必须位于lib文件夹中。
modules[可选]

modules文件夹包含Axis2/C发布的模块。各个已发布的模块将在modules文件夹中拥有自己的文件夹。例如,一个名为addressing的模块已被发布,则在modules文件夹下应由一个addressing文件夹。

在发布时,Axis2/C发布引擎将遍历modules文件夹并找出可用的模块。

modules文件夹是可选的,如果其中为空或者文件夹不存在,代表没有已发布模块。

services[可选]

services文件夹包含了Axis2/C发布的服务。各个已发布的服务将在services文件夹中拥有自己的文件夹,或者位于其中一个子文件夹中。

在发布时,Axis2/C发布引擎将遍历services文件夹并找出可用的服务。

services文件夹是可选的,如果其中为空或者文件夹不存在,代表没有已发布服务。

axis2.xml

axis.xml文件是Axis2/C的配置文件。

该配置文件必须存在,并且名称必须为axis2.xml。将Axis2/C仓库视为拥有axis2.xml的文件夹是安全的。

如果客户端和服务器都采用Axis2/C编写,那么它们可以使用相同的仓库。但是,可以在服务端使用一个仓库,并在客户端使用另外一个。services文件夹仅在仓库被用于服务端时被使用。当仓库被客户端使用时,将不会使用services文件夹(如果存在)。

Axis2/C二进制发布版本在提取时可视为可用的仓库文件夹。如果通过源代码构建Axis2/C,当构建源代码(包括示例)时,安装目标文件夹将视为仓库文件夹。

简单Axis服务器(即axis2_http_server),客户端示例及HTTPD模块(Axis2 Apache2模块)需要指定仓库文件夹才能正确运行。

  1. 模块文件夹
    所有模块都放置在仓库的modules文件夹内,并且每个模块在modules文件夹中都有自己的子文件夹。
    放置模块的文件夹必须与模块名称具有相同的名称。 例如,Addressing模块将被放置在名为Addressing的子文件夹中。
    在子文件夹内部,放置了实现模块的库文件及模块配置文件module.xml。两个文件必须存在于子文件夹中。module.xml文件将由发布引擎处理,以查找模块相关信息,如模块名称、处理程序集、添加处理程序的流程等。

  2. 服务文件夹
    所有服务都放置在仓库的services文件夹内,并且每个服务在services文件夹中都有自己的子文件夹。 Axis2/C有一个称为服务组的概念,服务组中可以有一个或多个服务。为了便于处理,单个独立服务会被分配一个与Axis2/C引擎的服务名称相同的服务组。因此,services文件夹中的子文件夹对应于服务组。
    服务(如果作为独立服务部署)将保存在与服务名称相同的文件夹中。例如,echo服务将被放置在名为echo的子文件夹中。实现服务的库文件和服务配置文件services.xml将放置在与服务相对应的文件夹中。考虑到引擎将文件夹视为代表服务组而不是单个服务,所以配置文件称为services.xml(复数)。但是,仍可将单个服务放在单个文件夹中,这是最常见的情况。
    services文件夹中的每个子文件夹应至少有一个实现服务的库文件和一个services.xml文件。如果它是一个服务组,则会有多个库文件,但只有一个services.xml文件可以配置所有这些服务。 services.xml文件由部署引擎处理,以找出服务组及服务相关信息,如服务组名称,服务名称,每个服务的操作集合等。

猜你喜欢

转载自blog.csdn.net/angel_lys/article/details/80297772