BoxLang 1.14.0发布：JSONPath集成到DataNavigator，实现全方位数据导航

// 旧方式——三层 structKeyExists
if ( structKeyExists( config, "database" ) ) {
    if ( structKeyExists( config.database, "connection" ) ) {
        maxSize = config.database.connection.pool?.maxSize ?: 10
    }
}

// 使用 DataNavigator
maxSize = dataNavigate( config ).get( ["database", "connection", "pool", "maxSize"], 10 )

{
  "status": "ok",
  "data": {
    "store": {
      "products": [
        { "id": 1, "name": "Keyboard", "price": 149.99, "inStock": true,  "category": "hardware" },
        { "id": 2, "name": "Mouse",    "price": 49.99,  "inStock": false, "category": "hardware" },
        { "id": 3, "name": "License",  "price": 299.00, "inStock": true,  "category": "software" },
        { "id": 4, "name": "Cable",    "price": 9.99,   "inStock": true,  "category": "hardware" }
      ]
    }
  }
}

// 1.14.0 之前
products = dataNavigate( apiResponse )
    .from( ["data", "store", "products"] )
    .get( [] )

inStockNames = products
    .filter( p -> p.inStock )
    .map( p -> p.name )

nav = dataNavigate( apiResponse )

// 一个表达式获取所有有库存的产品名称
names = nav.query( "data.store.products[?(@.inStock == true)].name" )
// => [ "Keyboard", "License", "Cable" ]

// 仅价格超过 $50 的硬件项目
expensive = nav.query( "data.store.products[?(@.category == 'hardware' && @.price > 50)]" )
// => [ { id:1, name:"Keyboard", price:149.99, ... } ]

// 第一个有库存的产品（单个结果）
first = nav.get( "data.store.products[?(@.inStock == true)]" )
// => { id:1, name:"Keyboard", ... }

// 总产品数量（安全，带默认值）
count = nav.getOrDefault( "data.store.meta.count", 0 )
// => 0（字段不存在，干净地返回默认值）

config = dataNavigate( server.system.config )

// 点号路径读取——无需链式 .from() 调用
logLevel   = config.getOrDefault( "logging.level", "WARN" )
datasource = config.getOrDefault( "defaultDatasource", "main" )
cacheMax   = config.getOrDefault( "caches.default.maxObjects", 1000 )

// 递归下降——在配置树中查找任何位置的 "timeout" 键
// 当你不知道确切嵌套层级时很有用
timeout = config.get( "..timeout", 30 )

// 在使用可选部分之前进行存在性检查
if ( config.has( "modules.bx-ai.providers[*]" ) ) {
    providers = config.query( "modules.bx-ai.providers[*].name" )
    // => [ "openai", "anthropic", "bedrock" ]
}

// 字面包含点的键（常见于 Java 风格的属性文件）
// 使用 getByKey() 跳过路径解析
jdbcUrl = config.getByKey( "datasources.main.db.url" )
//                          ^ 被视为一个字面键，而非路径

moduleData = {
    "name": "bx-ai",
    "version": "3.2.0",
    "providers": [
        { "name": "openai",    "models": [ "gpt-4o", "gpt-4-turbo", "gpt-3.5-turbo" ] },
        { "name": "anthropic", "models": [ "claude-opus-4-5", "claude-sonnet-4-5" ] },
        { "name": "bedrock",   "models": [ "titan", "llama3" ] }
    ],
    "settings": {
        "timeout": 30,
        "retries": 3,
        "debug": false
    }
}

nav = dataNavigate( moduleData )

// 所有提供商名称
nav.query( "providers[*].name" )
// => [ "openai", "anthropic", "bedrock" ]

// 仅前两个提供商（切片）
nav.query( "providers[1:2]" )
// => [ { name:"openai", ... }, { name:"anthropic", ... } ]

// 所有提供商的所有模型名称——通配符 + 通配符
nav.query( "providers[*].models[*]" )
// => [ "gpt-4o", "gpt-4-turbo", "gpt-3.5-turbo", "claude-opus-4-5", ... ]

// 所有设置值（结构体上的通配符）
nav.query( "settings.*" )
// => [ 30, 3, false ]

// 拥有超过 2 个模型的提供商
nav.query( "providers[?(@.models)]" )
// => 所有具有 models 字段的提供商（存在性检查）

class AppConfigLoader {

    function load( required string environment ) {
        var nav = dataNavigate( expandPath( "/config/app.json" ) )

        // 必需字段——如果缺失则快速失败
        var appName = nav.getOrThrow( "app.name" )
        var appVersion = nav.getOrThrow( "app.version" )

        // 限定到请求的环境
        var envNav = nav.from( "environments.#environment#" )
        if ( envNav.isEmpty() ) {
            throw( type="ConfigError", message="未知环境: #environment#" )
        }

        // 收集数据库设置，带默认值
        var db = {
            host:     envNav.getOrDefault( "database.host", "localhost" ),
            port:     envNav.getOrDefault( "database.port", 5432 ),
            ssl:      envNav.getOrDefault( "database.ssl", true ),
            poolMax:  envNav.getOrDefault( "database.pool.maxConnections", 10 )
        }

        // 收集所有已启用的功能标志
        var enabledFeatures = envNav.query( "features[?(@.enabled == true)].name" )

        // 查找第一个配置的缓存提供者（递归下降）
        var cacheProvider = envNav.get( "..cacheProvider", "default" )

        // 任何模块级覆盖——跨所有模块的通配符
        var moduleOverrides = envNav.query( "modules[*].overrides" )

        return {
            name:             appName,
            version:          appVersion,
            environment:      environment,
            database:         db,
            enabledFeatures:  enabledFeatures,
            cacheProvider:    cacheProvider,
            moduleOverrides:  moduleOverrides
        }
    }

}