XSLT元素重命名与新增：Schema v1转v2样式表开发需求

这种大规模Schema版本迭代的转换需求我碰到过很多，完全不用手写几百个模板——利用XSLT的通用匹配特性+字符串处理函数，就能批量搞定标准化重命名，同时兼顾元素的新增和删除。下面给你一套可落地的实现思路：

1. 通用重命名模板（核心逻辑） #

先写一个匹配所有元素的通用模板，把标准化重命名的规则封装进去，比如移除前缀、处理下划线这类操作：

<!-- 匹配所有元素的通用模板 -->
<xsl:template match="*">
  <!-- 步骤1：移除固定前缀（比如v1元素都带"v1_"前缀） -->
  <xsl:variable name="name-no-prefix" select="if (starts-with(local-name(), 'v1_')) then substring-after(local-name(), 'v1_') else local-name()"/>
  
  <!-- 步骤2：移除下划线并转换为驼峰命名（适配"删除相邻词下划线"的需求） -->
  <xsl:variable name="name-no-underscores">
    <xsl:call-template name="underscore-to-camelcase">
      <xsl:with-param name="input" select="$name-no-prefix"/>
    </xsl:call-template>
  </xsl:variable>
  
  <!-- 步骤3：过滤需要删除的元素 -->
  <xsl:variable name="final-element-name">
    <xsl:choose>
      <xsl:when test="$name-no-underscores = ('deprecatedUserField', 'oldAddressInfo')">
        <!-- 标记为删除，后续不输出 -->
        <xsl:value-of select="''"/>
      </xsl:when>
      <xsl:otherwise>
        <xsl:value-of select="$name-no-underscores"/>
      </xsl:otherwise>
    </xsl:choose>
  </xsl:variable>
  
  <!-- 只输出非空名称的元素 -->
  <xsl:if test="$final-element-name != ''">
    <xsl:element name="{$final-element-name}">
      <!-- 复制属性和子节点（属性如果也需要重命名，可参考同样逻辑写@*模板） -->
      <xsl:apply-templates select="@* | node()"/>
    </xsl:element>
  </xsl:if>
</xsl:template>

<!-- 辅助模板：下划线转驼峰命名 -->
<xsl:template name="underscore-to-camelcase">
  <xsl:param name="input"/>
  <xsl:param name="delimiter" select="'_'"/>
  <xsl:if test="$input != ''">
    <xsl:variable name="first-segment" select="substring-before(concat($input, $delimiter), $delimiter)"/>
    <xsl:variable name="remaining" select="substring-after($input, $delimiter)"/>
    
    <!-- 首段保持小写，后续段首字母大写 -->
    <xsl:if test="position() = 1">
      <xsl:value-of select="$first-segment"/>
    </xsl:if>
    <xsl:if test="position() != 1">
      <xsl:value-of select="upper-case(substring($first-segment, 1, 1))"/>
      <xsl:value-of select="substring($first-segment, 2)"/>
    </xsl:if>
    
    <!-- 递归处理剩余部分 -->
    <xsl:call-template name="underscore-to-camelcase">
      <xsl:with-param name="input" select="$remaining"/>
    </xsl:call-template>
  </xsl:if>
</xsl:template>

2. 处理元素的新增与删除 #

• 删除元素：上面的模板里已经通过判断元素名称实现了删除，你可以把所有需要删除的元素名放在一个变量里，维护起来更方便：

  <xsl:variable name="deprecated-elements" select="('deprecatedUserField', 'oldAddressInfo', 'legacyContact')"/>
  <!-- 然后把判断改成：test="$name-no-underscores = $deprecated-elements" -->
  

• 新增元素：如果需要在特定位置新增v2的元素，可以给父元素写单独的模板，在原有内容之后添加新元素：

  <!-- 给User元素新增v2要求的ContactDetail子元素 -->
  <xsl:template match="User">
    <xsl:copy>
      <xsl:apply-templates select="@* | node()"/>
      <!-- 新增元素，可以复用v1里的现有数据 -->
      <ContactDetail>
        <Email><xsl:value-of select="../v1_Email"/></Email>
        <Phone><xsl:value-of select="../v1_Phone"/></Phone>
      </ContactDetail>
    </xsl:copy>
  </xsl:template>
  

3. 例外情况处理 #

总有一些元素不符合通用规则，这时候只需要为这些元素写单独的模板——XSLT会优先匹配更具体的模板，不会触发通用模板：

<!-- 特殊元素：v1的CustomData不需要重命名，直接映射到v2的CustomData -->
<xsl:template match="v1_CustomData">
  <CustomData>
    <xsl:apply-templates select="@* | node()"/>
  </CustomData>
</xsl:template>

4. 进阶维护技巧 #

如果后续Schema规则有变动，建议把重命名映射、删除列表放在单独的XML配置文件里，用document()函数加载，不用修改XSLT核心代码，维护起来更灵活：

<!-- 配置文件：schema-mappings.xml -->
<mappings>
  <deprecated-elements>
    <element>deprecatedUserField</element>
    <element>oldAddressInfo</element>
  </deprecated-elements>
  <rename-rules>
    <rule old="v1_SpecialItem" new="SpecialItemV2"/>
  </rename-rules>
</mappings>

然后在XSLT里加载这个文件，读取对应规则即可。

内容的提问来源于stack exchange，提问作者jrpartridge