聊聊 Joda-Time 2.4 的新增方法及在并发和性能上的改进

Joda-Time 2.4 的日期和时间 Java 包已经发布。这是 Joda-Time 在 2014 年的首个发布版本，它包含了功能的增强、bug 修复，以及一个在时区方面的更新。本次发布没有引入新的 deprecation，Joda-Time 2.4 基于 Apache License Version 2 发布，对 JDK 的版本要求在 1.5 以上。

以下是 Joda-Time 2.4 的一些功能方面的增强。

• 接口中添加了 Duration.multipliedBy(long multiplicand)、Duration.dividedBy(long divisor) 和 Duration.negated() 几个 public 方法。
• 在 LocalDate.hashCode() 中，去掉了 (支持缓存的)hashCode (int iHash) 方法前并不必要的 volatile 修饰符。该 (支持缓存的)hashCode 方法现在遵从了独特的单重检查模式（racy single-check idiom，一种单重检查模式的变体，出自 _Effective Java_）。
• DateTimeParserBucket 内部实现现在已改为使用 CharSequence，但是并没有对 public API 造成任何影响。这允许 DateTimeParserBucket 可以在单个线程中被重新使用，从而减少了短命对象的创建。CharSequence 同样也被应用在解析方面，但是只能通过创建一个可变的 DateTimeParserBucket 才能访问对应的解析方法。DateTimeParserBucket 是一个较底层的概念，通常被用于较高级的使用场景。可以通过查看 issue #111 来了解更多信息。
• DateTimeFormat、DateTimeFormatter 和 DateTimePrinter 添加了对 java.lang.Appendable 的支持。内部实现采用了 StringBuilder 来替代 StringBuffer。
• 对 joda.time.chrono 包内的类的年表查找的性能进行了改进。目前采用了 ConcurrentHashMap 来替代原来的同步 Map。而 GJChronologies 的缓存查找也同样得到了简化。
• 通过使用 AtomicReferenceArray 改进了 DateTimeFormat 的模式缓存查找的性能。
• 简化并提升了 GJLocaleSymbols 符号查找的性能。
• DateTimeZone 数据更新到了版本 2014e。

以下是在 Joda-Time 2.4 中已经修复的 bug。

• 修复了 DateTimeField.getDurationField() 和 DateTimeField.getRangeDurationField() 中对世纪和纪元的错误处理。
• 修复了 DateTimeZone.getOffsetFromLocal()，从而可以正确地处理 DST（Daylight Saving Time，即夏时制）历史中的最近一次转换。这是一个从 Local 向 UTC 的转换问题。
• 在 Period 的创建过程中。如果一个时间端点位于 DST 的覆盖范围之中，而另一个时间端点超出了 DST 的覆盖范围，那么这个 Period 将会出错。该版本修复了对该种情况的计算，而额外的小时数将不再被添加。
• DateTimeUtils.isContiguous(ReadablePartial) 方法将在对非法输入进行求值时将会抛出 NullPointerException 异常。
• 当 PeriodType 缺失了年份或月份时，Period.normalizedStandard(PeriodType) 方法将抛出 UnsupportedOperationException 异常。
• 在方法 Partial.with(DateTimeFieldType,int) 实现中添加了对参数缺失的校验，以避免创建无效的 Partial。
• 向 MutableDateTime 添加零不会再对秋季中 DST 覆盖范围的偏移值进行修改。
• 在 DateTime/MutableDateTime 的入参为 milliseconds 的构造器中增加了校验逻辑。在该版本中，new DateTime(Long.MAX_VALUE) 这种方式不再合法，将会被拒绝。
• 月份中的日（Day-of-month）和年份中的日（day-of-year）等字段类（DateTimeField 的子类）的 isLeap() 方法将返回正确的结果。
• 当创建 Partial 来进行比较时，强调了 year > weekyear。
• 对具有 null ID 的非法 TimeZone 实现进行了处理。当传入含有一个 null ID 的 TimeZone 来调用 DateTimeZone.forTimeZone() 时会抛出 NullPointerException 异常。
• 一些 Android 的实现会在对不同类型的变量进行比较时抛出 ClassCastException 异常。本次修复针对有问题的 Android 实现的处理进行了改善。
• 在 DateTimeFormatterBuilder 中的解析实现采用了 ConcurrentHashMap，从而获得了更高的并发性能。
• DateTimeZone 曾错误地调用了 ThreadGroup.uncaughtException()，目前已经被修改为抛出一个 RuntimeException 作为替代。

查看英文原文： Joda-Time 2.4 - New Methods, Improved Concurrency and Performance