XSLT 3.0：将返回xs:boolean的自定义分组函数结果映射为有意义文本

一、通用映射方案解决布尔分组键转换问题 #

针对用返回布尔值的自定义函数作为分组键，需要将true()/false()映射为指定字符串的需求，以下两种方案支持扩展到更多映射场景：

方案1：使用XPath映射字典（推荐，扩展性极强） #

利用XSLT 3.0原生支持的map类型定义键值映射，后续扩展新的键值对仅需修改字典，无需调整分组逻辑：

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="3.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:my="https://my-function.library.org" exclude-result-prefixes="#all">
    <xsl:output method="xml" version="1.0" encoding="UTF-8" indent="yes"/>
    
    <!-- 定义通用映射字典，可随时添加新的键值对适配更多场景 -->
    <xsl:variable name="group-label-map" as="map(xs:boolean, xs:string)" select="map{
        true() : 'Live album',
        false() : 'Studio album'
    }"/>
    
    <xsl:function name="my:group-key" as="xs:boolean">
        <xsl:param name="recording"/>
        <xsl:sequence select="contains($recording/title, 'Live')"/>
    </xsl:function>

    <xsl:template match="/catalog">
        <groups>
            <xsl:for-each-group select="recording" group-by="my:group-key(.)">
                <!-- 通过映射字典快速获取分组显示标签 -->
                <group key="{$group-label-map(current-grouping-key())}">
                    <xsl:for-each select="current-group()">
                        <titel><xsl:value-of select="title"/></titel>
                    </xsl:for-each>
                </group>
            </xsl:for-each-group>
        </groups>
    </xsl:template>
</xsl:stylesheet>

方案2：独立映射函数（适合复杂映射逻辑） #

如果映射需要处理多分支判断、调用其他函数或复杂计算，可将映射逻辑封装为独立函数，XSLT 3.0的switch表达式能让多分支逻辑更清晰：

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="3.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:my="https://my-function.library.org" exclude-result-prefixes="#all">
    <xsl:output method="xml" version="1.0" encoding="UTF-8" indent="yes"/>
    
    <xsl:function name="my:group-key" as="xs:boolean">
        <xsl:param name="recording"/>
        <xsl:sequence select="contains($recording/title, 'Live')"/>
    </xsl:function>

    <!-- 独立映射函数，支持复杂逻辑扩展 -->
    <xsl:function name="my:map-group-key" as="xs:string">
        <xsl:param name="key" as="xs:boolean"/>
        <xsl:sequence select="
            switch ($key)
                case true() return 'Live album'
                case false() return 'Studio album'
                <!-- 扩展时直接添加新的case分支 -->
                <!-- case ... return ... -->
        "/>
    </xsl:function>

    <xsl:template match="/catalog">
        <groups>
            <xsl:for-each-group select="recording" group-by="my:group-key(.)">
                <group key="{my:map-group-key(current-grouping-key())}">
                    <xsl:for-each select="current-group()">
                        <titel><xsl:value-of select="title"/></titel>
                    </xsl:for-each>
                </group>
            </xsl:for-each-group>
        </groups>
    </xsl:template>
</xsl:stylesheet>

二、映射逻辑独立为函数的合理性及最佳实践 #

合理性 #

• 代码复用：若多处需要相同的键值映射，独立函数可避免重复代码；
• 职责分离：分组判断逻辑（my:group-key）与显示映射逻辑（my:map-group-key）解耦，调整显示标签无需修改分组逻辑；
• 可测试性：单独的映射函数可独立验证输入输出的正确性，降低调试成本。

最佳实践 #

• 单一职责原则：一个函数只负责一项逻辑——比如分组函数仅生成原始分组键，映射函数仅处理键到显示标签的转换；
• 强类型约束：为函数参数和返回值指定明确类型（如as="xs:boolean"），让处理器提前发现类型错误；
• 简单映射优先用字典：仅需键值对应时，map比函数更简洁易维护；
• 添加文档注释：为自定义函数标注参数含义、返回值用途，提升代码可读性；
• 避免分组键与映射耦合：不要将映射逻辑直接写到group-by表达式中，否则会丢失原始键的类型优势，增加后续维护难度。

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