Skip to main content

[jsr363-experts] Final coordination and review of Spec, etc.

  • From: Werner Keil < >
  • To: " " < >
  • Subject: [jsr363-experts] Final coordination and review of Spec, etc.
  • Date: Wed, 10 Aug 2016 17:42:11 +0200

Dear Experts,

Please have a look at all deliverables of JSR 363
Code where you can/want, JavaDoc under:
http://unitsofmeasurement.github.io/unit-api/site/apidocs/index.html
Spec:
https://docs.google.com/document/d/12KhosAFriGCczBs6gwtJJDfg_QlANT92_lhxUWO2gCY/edit#heading=h.hf5olbmzpxb

Leo kindly reviewed much of the spec already. I confirmed all minor or
spelling suggestions. Also moved the Cloud/DevOps, Config or Monitoring
examples from use cased into examples. An example for QS and BMI was
already there, so it makes sense to list those later.
Most of them directly involve JSR 363 like Parfait, but even others like
YAML or HOCON JSR 363 can be used rather easily to parse values. US Energy
provider Opower does in their Jackson binding example case via UCUM codes.

The energy sector as a whole was also mentioned under use cases, maybe one
or two small code samples (like the heat efficiency) could still be added,
but otherwise I think it looks OK.

Leo asked one or two questions about "Vector Units" that have a long
history, most of them were mentioned at least in JSR 275, so could those
most actively involved over the years (Jean-Marie, Martin or others) please
also have a look and provide feedback in Google Docs or change
recommendations?

Leo also mentioned, it would be nice to decouple the SPI and Format module,
so that you can use the SPI without having to implement UnitFormatService
or return it by ServiceProvider.
As the SPI references UnitFormat (the only interface other than its
assisting exception in the "format" package) it would not work to
completely strip the package or interfaces away.
If not having to use them if you use the SPI was a huge benefit, we must
document this in JavaDoc and mention it in the spec, too. Plus make sure,
the TCK is passed even if e.g. there's no usage of UnitFormat. As of now "
54-A2" of the TCK expects that UnitFormatService is returned and at least
one UnitFormat is returned by it. I am not sure, if this helps or adds more
complexity to the TCK, but it would be possible if there's a strong need.

Thanks and Regards,

Werner


[jsr363-experts] Final coordination and review of Spec, etc.

Werner Keil 08/10/2016

[jsr363-experts] Re: Final coordination and review of Spec, etc.

Werner Keil 08/10/2016

[jsr363-experts] Re: Final coordination and review of Spec, etc.

Jean-Marie Dautelle 08/10/2016

[jsr363-experts] Re: Final coordination and review of Spec, etc.

Jean-Marie Dautelle 08/10/2016

[jsr363-experts] Re: Final coordination and review of Spec, etc.

Werner Keil 08/11/2016
 
 
Close
loading
Please Confirm
Close