# Guidewire SDK 模式 ## 概述掌握 Guidewire 开发的关键 SDK 模式：用于前端的数字 SDK、用于集成的 REST API 客户端以及用于服务器端开发的 Gosu 模式。 ## 先决条件 * Completed `guidewire-install-auth` and `guidewire-hello-world` * Understanding of TypeScript/JavaScript (for Digital SDK) * Familiarity with Gosu basics (for server-side patterns) ## 数字 SDK（前端） ### 安装和设置 # 使用 Digital SDK 初始化 Jutro 项目 npx @guidewire/jutro-cli@latest create my-portal --template agent-portal cd 我的门户 # 从您的云 API 生成数字 SDK npx jutro-cli 生成-sdk \ --api-url https://your-tenant.cloud.guidewire.com/pc \ --输出src/sdk ### SDK配置 // src/sdk/config.ts import { createSdkConfig } from '@guidewire/digital-sdk'; 导出 const sdkConfig = createSdkConfig({ baseUrl：process.env.REACT_APP_API_URL，授权：{ 类型：'oauth2'， clientId：process.env.REACT_APP_CLIENT_ID， redirectUri: `${window.location.origin}/callback`, 范围：'pc.policies' }, 标题：{ “接受语言”：“en-US” }, 超时：30000 }); ### 实体操作 // 使用Digital SDK进行CRUD操作 import { useAccount, useAccounts, createAccount } from '../sdk/account'; // 读取单个实体 function AccountDetail({ accountId }: { accountId: string }) { const { data: account, loading, error } = useAccount(accountId, { 包括：['accountHolder', 'primaryLocation'] }); 如果（正在加载）返回; if (错误) return ; 返回（

{account.accountHolder.displayName}

帐户编号：{account.accountNumber}

状态：{account.accountStatus.name}

）； } // 列出带有过滤的实体函数账户列表() { const { data: accounts, loading, pagination } = useAccounts({ 过滤器：{ accountStatus：'活动'}，页面大小：25，排序：'-创建日期' }); 返回（ <数据表数据={帐户} 加载={加载} 分页={分页} 列={[ { field: 'accountNumber', header: '账户#' }, { field: 'accountHolder.displayName', header: 'Name' }, { field: 'accountStatus.name', header: 'Status' } ]} /> ）； } // 创建实体 async function handleCreateAccount(formData: AccountFormData) { 尝试{ const newAccount = 等待 createAccount({ 帐户持有人：{ 名字：formData.名字，姓氏：formData.姓氏，出生日期：formData.dob }, 主要位置：{ 地址行1：表单数据.地址，城市：formData.city，状态：{代码：formData.state}，邮政编码：formData.zip } }); console.log('Created account:', newAccount.accountNumber); 返回新帐户； } 捕获（错误）{ 处理ApiError（错误）； } } ### 架构验证 // 使用 SDK 生成的模式验证从 '../sdk/account' 导入 { accountSchema, validateAccount }; 从'react-hook-form'导入{useForm}；从 '@hookform/resolvers/zod' 导入 { zodResolver }；函数AccountForm() { 常量{ 注册，处理提交，表单状态：{错误} } = useForm({ 解析器：zodResolver(accountSchema) }); 返回（

<输入 {...register('accountHolder.firstName')} 标签=“名字” 错误={errors.accountHolder?.firstName?.message} 必填 /> <输入 {...register('accountHolder.lastName')} 标签=“姓氏” 错误={errors.accountHolder?.lastName?.message} 必填 /> {/* 附加字段 */} ）； } ## REST API 客户端（集成） ### 客户端插件设置 // build.gradle - REST API 客户端插件插件{ id 'com.guidewire.rest-api-client' 版本 '3.0.0' } 休息Api客户端{ 客户{ 外部评级{ specFile = 文件('规格/评级服务.yaml') 包名 = 'gw.integration. rating' 生成同步 = true 容错性{ 重试次数 = 3 重试延迟 = 1000 断路器阈值 = 5 } } } } ### 生成的客户端使用情况 // 使用生成的 REST API 客户端软件包 gw.integration. rating 使用 gw.integration. rating.api.RatingApi 使用 gw.integration. rating.model.RatingRequest 使用 gw.integration. rating.model.RatingResponse 使用 gw.api.util.Logger 评级服务类 { private static Final var LOG = Logger.forCategory("RatingService") 私有静态最终 var _api = 新的RatingApi() 静态函数 getRating(policy:Policy) :RatingResponse { var request = 新的RatingRequest() 请求.PolicyNumber = 策略.PolicyNumber 请求.生效日期 = 政策.生效日期 request.CoverageType = 策略.Product.Code request.State = 策略.PrimaryLocation.State.Code 尝试{ var 响应 = _api.calculateRating(请求) LOG.info("评级计算：${response.PremiumAmount}") 返回响应 } catch (e:FaultToleranceException) { LOG.error("评级服务不可用", e) throw new RatingServiceException("无法计算评级", e) } } } ### 自定义 REST 客户端 // 自定义 REST 客户端实现包 gw.integration.external 使用 gw.api.rest.RestClient 使用 gw.api.rest.RestClientBuilder 使用 gw.api.rest.Response 使用 gw.api.util.Logger 类外部服务客户端{ private static Final var LOG = Logger.forCategory("ExternalServiceClient") 私有变量_client：RestClient 构造（）{ _client = RestClientBuilder.create() .withBaseUrl(ScriptParameters.ExternalServiceUrl) .withTimeout(30000) .withHeader("授权", "承载${getToken()}") .withHeader("内容类型", "application/json") .build() } 函数 getResource(resourceId : String) : 外部资源 { var response = _client.get("/resources/${resourceId}") 验证响应（响应）返回parseResponse（响应，外部资源） } 函数createResource（资源：外部资源）：外部资源{ var response = _client.post("/resources", toJson(resource)) 验证响应（响应）返回parseResponse（响应，外部资源） } 私有函数 validateResponse(响应：响应) { if (response.StatusCode >= 400) { LOG.error("API 错误：${response.StatusCode} - ${response.Body}") 抛出新的ExternalServiceException（ “外部服务错误：${response.StatusCode}” ） } } 私有函数 getToken() : String { // 令牌检索逻辑返回 ScriptParameters.ExternalServiceToken } } ## Gosu 模式（服务器端） ### 实体查询模式 // 使用 Query API 进行高效查询包 gw.custom.query 使用 gw.api.database.Query 使用 gw.api.database.Relop 使用 gw.api.path.Paths 类策略查询服务{ // 简单查询静态函数 findByPolicyNumber(policyNumber : String) : 策略 { 返回 Query.make(策略) .比较（策略#策略编号，等于，策略编号） .select() .AtMostOneRow } // 使用连接进行查询静态函数 findPoliciesByProducerCode( ProducerCode : String) : List { 返回 Query.make(策略) .join(策略#ProducerCodeOfRecord) .compare(ProducerCode#Code, 等于, ProducerCode) .select() .toList() } // 带子查询的复杂查询静态函数 findActiveHighValuePolicies(minPremium : java.math.BigDecimal) : List { var query = Query.make(策略) query.compare(Policy#Status, 等于, PolicyStatus.TC_INFORCE) query.compare(Policy#TotalPremiumRPT, GreaterThanOrEquals, minPremium) query.compare(Policy#ExpirationDate, GreaterThan, Date.Today) // 添加特定覆盖范围的子查询 var subquery = query.subselect(Policy#ID, CompareIn, PolicyPeriod#Policy) subquery.join(PolicyPeriod#PersonalAutoLine) .比较（PersonalAutoLine#PAVehicles，IsNotNull，空）返回查询.select() .orderBy(\p -> p.TotalPremiumRPT) .toList() } // 批处理模式静态函数 processInBatches( 查询：查询，批量大小：int，处理器（批处理：列表））{ var 迭代器 = query.select().iterator() var batch = new ArrayList() while (iterator.hasNext()) { 批处理.add(迭代器.next()) if (batch.size() >= batchSize) { 处理器（批处理）批处理.clear() } } if (!batch.Empty) { 处理器（批处理） } } } ### 交易模式 // 事务管理模式包 gw.custom.transaction 使用 gw.api.database.Transaction 使用 gw.transaction.Transaction 作为 GWTransaction 类交易服务{ // 基本交易静态函数 createAccountWithPolicy(accountData : AccountData) : 策略 { 返回 GWTransaction.runWithNewBundle(\bundle -> { var account = 新帐户（捆绑）帐户.帐户编号 = 帐户数据.帐户编号 var contact = new Person(bundle) var contact = new Person(bundle) contact.FirstName = accountData.FirstName contact.LastName = accountData.LastName account.AccountHolderContact = 联系人 // 创建提交 var 提交 = 新提交(bundle) 提交.Account = 账户提交.Product = accountData.Product 返回提交.政策 }) } // 带有保存点的事务静态函数complexOperation（策略：策略）{ GWTransaction.runWithNewBundle(\bundle -> { 策略=bundle.add(策略) 尝试{ // 危险操作1 更新覆盖范围（政策） // 危险操作2 申请背书（政策） } catch (e: 异常) { // Bundle将在异常时自动回滚扔 e } }) } // 异步事务静态函数queueAsyncWork（policyId：Key）{ gw.api.async.AsyncProcess.schedule( “流程政策”， \-> processPolicy(policyId), 日期.现在） } } ### 插件模式 // 插件实现模式包 gw.plugin. rating 使用 gw.plugin. rating.IRatingPlugin 使用 gw.api.util.Logger CustomRatingPlugin 类实现 IRatingPlugin { private static Final var LOG = Logger.forCategory("CustomRatingPlugin") 覆盖函数calculatePremium(period:PolicyPeriod):Money{ LOG.info("计算保单保费：${period.PolicyNumber}") var basePremium = 计算BasePremium(周期) var 折扣 = applyDiscounts(期间, basePremium) var 税 =calculateTaxes(期间, basePremium - 折扣) 返回基本溢价 - 折扣 + 税费 } 私有函数calculateBasePremium(period:PolicyPeriod):Money{ // 基础保费计算逻辑返期.线路 .map(\line -> line.calculatePremium()) .sum() } 私有函数 applyDiscounts(period : PolicyPeriod, base : Money) : Money { var TotalDiscount = Money.ZERO // 多策略折扣 if (period.Account.Policies.Count > 1) { 总折扣 += 基础 * 0.10 } // 良好的司机折扣如果（hasGoodDriverDiscount（期间））{ 总折扣 += 基础 * 0.15 } 返回总折扣 } } ## 输出 * 使用类型安全的 API 调用配置数字 SDK * 具有容错功能的 REST API 客户端 * Gosu 模式遵循 Guidewire 最佳实践 ## 错误处理错误 |原因 |解决方案 ---|---|--- SDK生成失败|无效的 API 规范 |验证 OpenAPI 规范 URL 和访问权限类型不匹配 |架构已更改 |重新生成SDK 交易超时 |长时间运行|优化或使用异步客户端超时 |网络问题 |增加超时，添加重试 ## 资源 * [数字 SDK 文档]() * [REST API 客户端指南]() * [Gosu语言参考]() * [查询API文档]() ## 后续步骤对于核心保险工作流程，请参阅“guidewire-core-workflow-a”和“guidewire-core-workflow-b”。

Guidewire SDK 模式

包含技能