Joda-Money 项目技术文档

1. 安装指南

1.1 环境要求

• Java SE 8 或更高版本
• 可选：Joda-Convert（仅在编译时需要，运行时不需要）

1.2 Maven 安装

在项目的 pom.xml 文件中添加以下依赖：

<dependency>
    <groupId>org.joda</groupId>
    <artifactId>joda-money</artifactId>
    <version>1.0.4</version>
</dependency>

1.3 手动安装

可以从 Maven Central Repository 下载 Joda-Money 的 JAR 文件，并将其添加到项目的类路径中。

2. 项目的使用说明

2.1 创建货币金额

使用 Money.parse 方法可以创建一个货币金额对象：

Money money = Money.parse("USD 23.87");

2.2 进行货币计算

可以对货币金额进行加减乘除等操作：

CurrencyUnit usd = CurrencyUnit.of("USD");
money = money.plus(Money.of(usd, 12.43d));
money = money.minusMajor(2);
money = money.multipliedBy(3.5d, RoundingMode.DOWN);

2.3 比较货币金额

可以使用 isGreaterThan 方法比较两个货币金额：

boolean bigAmount = money.isGreaterThan(dailyWage);

2.4 货币转换

可以使用 convertedTo 方法进行货币转换：

BigDecimal conversionRate = ...;  // 从外部代码获取转换率
Money moneyGBP = money.convertedTo(CurrencyUnit.GBP, conversionRate, RoundingMode.HALF_EVEN);

3. 项目API使用文档

3.1 Money 类

Money 类是 Joda-Money 的核心类，用于表示货币金额。

• Money.parse(String amount)：解析字符串创建货币金额。
• Money.of(CurrencyUnit currency, double amount)：使用指定货币和金额创建货币金额。
• plus(Money money)：加法操作。
• minusMajor(int amount)：减法操作。
• multipliedBy(double multiplicand, RoundingMode roundingMode)：乘法操作。
• isGreaterThan(Money money)：比较操作。
• convertedTo(CurrencyUnit currency, BigDecimal conversionRate, RoundingMode roundingMode)：货币转换。

3.2 CurrencyUnit 类

CurrencyUnit 类用于表示货币单位。

• CurrencyUnit.of(String currencyCode)：根据货币代码创建货币单位。

3.3 BigMoney 类

BigMoney 类用于更复杂的货币计算，尤其是在需要精确控制小数位数时。

• toBigMoney()：将 Money 转换为 BigMoney。

4. 项目安装方式

4.1 Maven 安装

如前所述，在 pom.xml 中添加依赖即可。

4.2 手动安装

下载 JAR 文件并添加到项目的类路径中。

4.3 企业级支持

Joda-Money 可以通过 Tidelift 订阅获得企业级支持。

---

通过以上文档，用户可以了解如何安装、使用 Joda-Money 项目，并掌握其核心 API 的使用方法。