Gloo Gateway企业版中的SOAP/XSLT转换技术详解

2025-06-12 07:00:22作者：尤峻淳Whitney

前言

在现代企业应用架构中，经常会遇到新旧系统集成的问题。SOAP协议作为企业级Web服务的传统标准，在金融、医疗等行业仍广泛使用，但其基于XML的消息格式与现代JSON格式存在兼容性问题。Gloo Gateway企业版提供的XSLT转换功能能够优雅地解决这一难题。

核心概念解析

SOAP与XML

SOAP(简单对象访问协议)是一种基于XML的通信协议，它定义了在分布式环境中如何交换结构化信息。XML(可扩展标记语言)是SOAP消息的标准格式，具有严格的结构和丰富的元数据。

JSON与现代服务

JSON(JavaScript对象表示法)是一种轻量级的数据交换格式，易于人阅读和编写，也易于机器解析和生成。现代Web服务和前端应用普遍采用JSON作为数据交换格式。

XSLT转换

XSLT(可扩展样式表语言转换)是一种用于将XML文档转换为其他XML文档或其他格式(如HTML或纯文本)的语言。Gloo Gateway利用XSLT 3.0的强大功能实现了JSON与XML之间的双向转换。

环境准备

部署SOAP服务

我们首先部署一个模拟的世界城市查询SOAP服务。该服务接收包含城市名称的XML查询，返回匹配的城市详细信息。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: world-cities-soap-service
spec:
  template:
    spec:
      containers:
        - name: world-cities-soap-service
          image: quay.io/solo-io/world-cities-soap-service:0.0.1
          ports:
            - containerPort: 8080

创建Kubernetes服务

为SOAP服务创建对应的Kubernetes Service资源：

apiVersion: v1
kind: Service
metadata:
  name: world-cities-soap-service
spec:
  ports:
  - port: 8080
    protocol: TCP
  selector:
    app: world-cities-soap-service

配置基础虚拟服务

创建基本的VirtualService资源，将所有流量路由到SOAP服务：

apiVersion: gateway.solo.io/v1
kind: VirtualService
metadata:
  name: world-city-service-vs
spec:
  virtualHost:
    routes:
      - matchers:
        - prefix: /
        routeAction:
          single:
            upstream:
              name: default-world-cities-soap-service-8080

原生SOAP服务测试

我们可以通过以下命令测试原生SOAP服务：

curl $GATEWAY_URL -H "SOAPAction:findCity" -H "content-type:application/xml" \
-d '<?xml version="1.0"?>
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
   <Body>
      <Query>
         <CityQuery>south bo</CityQuery>
      </Query>
   </Body>
</Envelope>'

服务会返回XML格式的城市信息。

实现JSON到SOAP的转换

配置XSLT转换

关键步骤是在VirtualService中配置请求和响应的XSLT转换：

options:
  stagedTransformations:
    regular:
      requestTransforms:
        - requestTransformation:
            xsltTransformation:
              xslt: |
                <!-- 请求转换XSLT -->
                <xsl:template match="/" xmlns="http://schemas.xmlsoap.org/soap/envelope/">
                  <Envelope>
                    <Body>
                      <Query>
                        <CityQuery><xsl:value-of select="json-to-xml(.)/*/string[@key='cityQuery']"/></CityQuery>
                      </Query>
                    </Body>
                  </Envelope>
                </xsl:template>
              nonXmlTransform: true
              setContentType: text/xml
          responseTransformation:
            xsltTransformation:
              xslt: |
                <!-- 响应转换XSLT -->
                <xsl:template match="/">
                  <xsl:apply-templates select="xml-to-json(.)"/>
                </xsl:template>
              setContentType: application/json

转换原理详解

请求转换流程

客户端发送JSON请求：{"cityQuery": "south bo"}
XSLT使用json-to-xml函数将JSON转换为中间XML
从中间XML提取cityQuery值并构建SOAP信封
将最终XML发送到后端SOAP服务

响应转换流程

SOAP服务返回XML响应
XSLT使用xml-to-json函数将XML转换为JSON
调整数据结构格式以生成友好的JSON输出
将JSON响应返回给客户端

测试JSON接口

配置完成后，我们可以使用JSON直接查询服务：

curl $GATEWAY_URL -d '{"cityQuery": "south bo"}' \
-H "SOAPAction:findCity" -H "content-type:application/json"

响应将是格式化的JSON数据，包含匹配的城市信息。

高级配置技巧

处理复杂数据结构

对于嵌套更深的SOAP消息，可以在XSLT中构建更复杂的模板：

<xsl:template match="complexType">
  <xsl:for-each select="item">
    <complexProperty>
      <name><xsl:value-of select="name"/></name>
      <value><xsl:value-of select="value"/></value>
    </complexProperty>
  </xsl:for-each>
</xsl:template>

错误处理

可以在XSLT中添加错误处理逻辑：

<xsl:template match="fault">
  <error>
    <code><xsl:value-of select="faultcode"/></code>
    <message><xsl:value-of select="faultstring"/></message>
  </error>
</xsl:template>