📚 课程目录第4章 SOA服务发现与元数据获取

4. SOA服务发现与元数据获取

在Teamcenter SOA开发中，客户端要调用一个服务，第一步并不是写代码，而是先回答三个问题：有哪些服务可用、这个服务长什么样、我该怎么把它变成可调用的客户端代理。这三个问题分别对应Teamcenter SOA体系中的三个核心概念：Service Registry（服务注册表）、Service Data（服务数据）和Service Metadata（服务元数据）。理解它们之间的层次关系，是后续所有接口开发的基础。

一、三个概念的分工

Service Registry是服务的“总目录”。它回答的是“系统里注册了哪些服务”。在Teamcenter中，服务注册信息通常以服务定义文件的形式存在，客户端通过注册表可以枚举出当前可用的服务名称、所属模块以及服务的基本标识。可以把Registry理解成图书馆的索引卡片柜——它告诉你有哪些书，但不告诉你书里写了什么。

Service Data是服务的“内容描述”。它回答的是“这个服务具体做什么、需要什么输入、返回什么输出”。Service Data通常以WSDL（Web Services Description Language）或等价的服务描述文档形式提供，里面包含操作名（operation）、输入消息（input message）、输出消息（output message）、绑定方式（binding）以及端点地址（endpoint address）。WSDL是SOA服务契约的标准载体，也是生成客户端代理的直接依据。

Service Metadata是服务的“附加说明”。它回答的是“这个服务有哪些额外约束和属性”。元数据可能包括服务的版本号、命名空间、所属业务对象类型、权限要求、是否支持事务、超时策略等。元数据不直接参与代理生成，但它决定了调用时的行为配置和兼容性判断。

三者的关系可以用下面的结构图表示：Registry提供入口，Data提供契约，Metadata提供约束，三者共同支撑客户端代理的生成。

二、通过Service Registry查询可用服务

在Teamcenter SOA客户端中，获取服务注册信息通常有两种途径。第一种是通过ServiceRegistry接口在运行时动态查询，第二种是直接读取Teamcenter安装目录下的服务定义文件。运行时查询的典型代码结构如下：

// 示例：通过 ServiceRegistry 枚举可用服务（示意代码）
ServiceRegistry registry = ServiceRegistryFactory.getInstance();
String[] serviceNames = registry.getServiceNames();
for (String name : serviceNames) {
    ServiceInfo info = registry.getServiceInfo(name);
    System.out.println("服务名: " + info.getName()
        + " | 命名空间: " + info.getNamespace()
        + " | 版本: " + info.getVersion());
}

这段代码的输出会列出当前环境注册的所有服务。实际开发中，服务数量可能达到数百个，因此通常需要按命名空间或关键字过滤。例如，只关注Teamcenter.Services.Strong或Teamcenter.Services.Loose下的服务。Registry返回的ServiceInfo对象中，getNamespace()和getVersion()就是元数据的一部分，它们决定了后续WSDL的获取路径。

三、解析WSDL与服务描述

拿到服务名称后，下一步是获取该服务的WSDL。Teamcenter SOA服务的WSDL通常通过HTTP端点暴露，格式为：

http://<tc-server>:<port>/tc/services/<ServiceName>?wsdl

例如，查询DataManagementService的WSDL地址可能是：

http://tcapp01:8080/tc/services/DataManagementService?wsdl

WSDL文档的核心结构包括types、message、portType、binding和service五个部分。types定义XML Schema数据类型，message定义输入输出消息的抽象结构，portType定义操作集合，binding指定SOAP协议和传输方式，service给出实际端点地址。解析WSDL时，重点提取以下信息：

operation名称：如createObjects、getProperties、deleteObjects，这些就是客户端代理中可调用的方法名。
输入参数类型：如CreateObjectsInput，包含业务对象类型、属性列表、容器引用等字段。
输出参数类型：如CreateObjectsOutput，包含创建结果、对象UID、错误信息等。
端点地址：决定运行时实际请求发往哪个URL。

在Java环境中，常用wsimport或Apache CXF的wsdl2java工具解析WSDL并生成代理类。以wsimport为例：

wsimport -keep -s ./src -d ./classes \
  -p com.mycompany.tc.proxy \
  http://tcapp01:8080/tc/services/DataManagementService?wsdl

执行后会在./src/com/mycompany/tc/proxy下生成一组Java类，包括服务接口、服务实现类、异常类和数据类型类。这些类就是客户端代理的骨架，开发者只需实例化服务类并调用对应方法即可。

四、元数据在代理生成中的作用

元数据虽然不直接出现在WSDL的portType中，但它影响代理生成和调用的多个环节。例如，Teamcenter服务的版本号决定了WSDL的命名空间后缀，如果客户端使用的代理版本与服务端不匹配，调用时会抛出SOAPFault。再如，某些服务要求事务上下文，元数据中会标记transactional=true，生成代理时需要额外配置事务管理器。此外，权限元数据决定了调用前是否需要先执行登录和会话建立。

在实际项目中，建议将Registry查询、WSDL获取和代理生成做成一个可重复的构建步骤。每次Teamcenter升级或服务变更后，重新执行一次代理生成，避免手工修改代理类导致的版本漂移。

五、一个完整的发现与生成示例

假设我们需要调用Teamcenter的QueryService来执行一个已保存查询。完整流程如下：

通过Registry查询，确认QueryService存在，命名空间为http://teamcenter.com/Services/Query/2023-06，版本为2023-06。
拼接WSDL地址：http://tcapp01:8080/tc/services/QueryService?wsdl。
使用wsimport生成代理类，指定包名为com.example.tc.query。
在代码中实例化QueryService，设置端点地址和认证信息。
调用executeSavedQuery方法，传入查询名称和参数，获取结果集。

生成后的代理类中，方法签名大致如下：

// 生成的代理接口方法（示意）
ExecuteSavedQueryResponse executeSavedQuery(
    ExecuteSavedQueryInput input
) throws ServiceException;

其中ExecuteSavedQueryInput包含queryName、queryParameters、maxResults等字段。开发者只需按业务需求填充这些字段，即可完成调用。整个过程的关键在于：Registry确保服务存在，WSDL确保契约正确，Metadata确保行为兼容。

注意：不同Teamcenter版本的WSDL端点路径可能不同，部分版本使用/tc/services/，部分使用/soa/services/。生成代理前务必通过Registry返回的元数据确认实际端点，不要硬编码URL。

掌握服务发现与元数据获取，意味着开发者不再依赖手工翻阅文档或猜测接口，而是通过标准化的Registry、WSDL和Metadata三层机制，自动、准确地生成客户端代理。这是Teamcenter SOA工程化开发的第一步，也是后续所有调用、调试和排障的基准。