The Spec Document and API are rapidly heading towards EDR 1. Some of you may have reviewed and also placed comments, others commented here, while others may prefer to watch it from the sidelines for now.
Although the balance between the Standalone JSR we voted to go for at this point and preparing it as good as it gets for a possible later addition to OpenJDK required a bit of re-factoring or -structuring of modules, I think it looks good, especially for a first EDR now.
After taking a peek at the latest JDK 8 snapshot including the java.time package, Anatole feels comfortable to try those static factory methods of() instead of a widely accepted de facto naming standard from the "Old Testament" of Java written mainly by folks like Josh Bloch in his books:
While I heard a few comments the Java Architects at Oracle wished java.time and some of its static methods to be simplified or redundant functionally equal duplicates removed, I haven't heard their recommendation about that, so unless I overlooked it or they overlooked that, I'd say it is at least tolerated.
Other Date/Time APIs not only inside the JDK, where JavaFX sticks to the established naming standards and method signatures of e.g. BigDecimal, or Fantom, a language written by a former JSR 275 EG Member which inspired many aspects of JSR 310 has things like
A counterpart of toStr() is a slightly shorter version of the Java method toString(), so it handles parsing and formatting in a slightly more consistent way than Java, not just in the Duration class. to* and from* are somewhat widely used factory method naming patterns in Fantom, where 310 did something a bit similar to valueOf() as Fantom did with toString(), cutting a few characters
While valueOf() is most widely used all across the JDK and e.g. every enum, even those in 310 can't but use and expose it (hence that makes the API a bit inconsistent by using of() in many final classes while valueOf() is used by all enums, themselves final classes, too
) the only notable example for newInstance() would be java.util.Currency. If we happen to improve the existing java.util.Currency class by implementing CurrencyUnit from Java 9 on, for backward-compatibility we must stick to this existing method signature, too. I don't know, if Oracle tolerated a duality by adding of() there, most likely they won't. Should the java.time like approach of a completely new package e.g. "java.money" inside the JDK, implementing key elements of the JSR like MonetaryAmount, CurrencyUnit or Rounding be preferred by OpenJDK and Oracle, then we'd be free to do whatever 310 did within the scope and sense of Monetary operations of course.
If you have your own suggestions here or feel either direction was more in your taste, please feel free to reply. Unless Oracle sanctions or mandates either of the two, we might hold a doodle poll later, or wait, what others using the EDR think. As of now, the EDR may start about a week from now, it's too late to do it today, though PMO told us, it may be started any day of the week. A start date near April 15 also means, the next EC F2F meeting in Zurich at CS shall conclude the 30 day usual EDR period, so we'd be in a place where Spec Lead, selected EG Members, the EC and PMO gather and I also asked to present a summary at this meeting. So without voting, EC Members have a chance to see what happened since the Renewal Ballot and what they feel comfortable with or what they may want to change, especially if it's something that could influence their vote in subsequent ballots
Werner Keil | JCP Executive Committee Member | Eclipse UOMo Lead, Babel Language Champion | Java Godfather
Twitter @wernerkeil | @JSR354 | #Java_Social | #EclipseUOMo | #OpenDDR
* JavaOne Russia: April 23-24 2013, Moscow, Russia. Werner Keil, JCP Executive Committee Member, JSR 354/360 EG Member will present "JSR 321, JSR 354, Standards for the Future of Java Embedded"
* Eclipse Stammtisch: May 15 2013, Zurich, Switzerland. Werner Keil, UOMo Lead, JSR 360 EG Member will present "M4M 2 the Rescue of M2M"
* GeeCON: May 16-17 2013, Krakow, Poland. Werner Keil, JCP Executive Committee Member, JSR 360 EG Member will present "Standards for the Future of Java Embedded"