2. 环境搭建与快速上手

OpenGamma Strata 是一个面向金融定价与风险计算的开源 Java 库，其设计目标是提供一套统一、可组合、可扩展的金融分析基础设施。在正式进入定价与风险实战之前，必须先完成环境搭建与运行验证。本节将围绕 Strata 的安装配置、依赖管理、第一个定价示例、常用工具类以及运行环境验证展开，帮助学员建立可复用的本地开发环境。

一、核心原理：Strata 的模块化与依赖结构

Strata 采用模块化设计，核心模块包括 strata-basics、strata-market、strata-pricer、strata-product、strata-report 等。其中 strata-basics 提供日期、货币、曲线、插值等基础工具；strata-market 负责市场数据与曲线构建；strata-pricer 提供定价引擎与风险度量；strata-product 定义金融产品模型；strata-report 用于结果输出与报表生成。理解模块边界，有助于在后续开发中精准引入依赖，避免“全量依赖”导致的构建臃肿。

Strata 的依赖管理推荐使用 Maven 或 Gradle。由于 Strata 本身依赖 Guava、Joda-Beans、SLF4J 等第三方库，建议在项目中显式声明版本，避免传递依赖冲突。对于生产环境，建议使用 BOM（Bill of Materials）方式统一管理 Strata 及其相关模块版本。

二、方法流程：安装配置与依赖管理

以下以 Maven 为例，展示 Strata 的最小依赖配置。假设使用 Strata 2.x 版本，核心依赖如下：

<dependency>
  <groupId>com.opengamma.strata</groupId>
  <artifactId>strata-pricer</artifactId>
  <version>2.12.0</version>
</dependency>
<dependency>
  <groupId>com.opengamma.strata</groupId>
  <artifactId>strata-market</artifactId>
  <version>2.12.0</version>
</dependency>
<dependency>
  <groupId>com.opengamma.strata</groupId>
  <artifactId>strata-report</artifactId>
  <version>2.12.0</version>
</dependency>

若使用 Gradle，可写为：

implementation 'com.opengamma.strata:strata-pricer:2.12.0'
implementation 'com.opengamma.strata:strata-market:2.12.0'
implementation 'com.opengamma.strata:strata-report:2.12.0'

配置完成后，执行 mvn clean compile 或 gradle build，若构建成功，说明依赖解析正常。此时可进一步验证 Java 版本：Strata 2.x 要求 Java 8 或更高版本，推荐 Java 11 或 17。可通过 java -version 确认。

三、第一个定价示例：从产品到结果

下面给出一个最小可运行的定价示例：对一笔固定利率债券进行定价。该示例涵盖产品构建、市场数据准备、定价引擎调用与结果输出四个步骤。

// 1. 构建固定利率债券
LocalDate start = LocalDate.of(2024, 1, 15);
LocalDate end = LocalDate.of(2029, 1, 15);
FixedCouponBond bond = FixedCouponBond.builder()
    .securityId(SecurityId.of("OG", "BOND-001"))
    .currency(Currency.USD)
    .notional(1_000_000)
    .fixedRate(0.05)
    .startDate(start)
    .endDate(end)
    .frequency(Frequency.P6M)
    .dayCount(DayCounts.ACT_360)
    .rollConvention(RollConventions.DAY_15)
    .build();

// 2. 准备市场数据
LocalDate valuationDate = LocalDate.of(2024, 6, 15);
double discountFactor = 0.98;
double price = bond.getNotional() * discountFactor;

// 3. 输出结果
System.out.println("债券估值日期: " + valuationDate);
System.out.println("债券价格: " + price);

上述示例简化了曲线构建与贴现过程，目的是让学员快速跑通“产品—市场—定价”链路。实际项目中，应使用 RatesProvider、Curve 与 DiscountingRatesProvider 构建完整的定价环境。

四、常用工具类与运行环境验证

Strata 提供了大量工具类，以下为高频使用的清单：

运行环境验证建议按以下顺序执行：

1. 确认 Java 版本符合要求：java -version 输出 11 或 17。
2. 确认 Maven/Gradle 构建成功：mvn clean test 或 gradle test。
3. 运行第一个定价示例，观察控制台是否输出债券价格。
4. 检查日志中是否出现 SLF4J 绑定警告，若有则补充日志实现依赖。
5. 验证 strata-report 是否能正常生成报表文件。