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

阅读数:1715 2014 年 8 月 26 日

话题:Java语言 & 开发

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