Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Jclouds Wiki" for 
change notification.

The "Coding Standards" page has been changed by AdrianCole:
https://wiki.apache.org/jclouds/Coding%20Standards?action=diff&rev1=12&rev2=13

Comment:
Updated statement about java language level and guava

     {{attachment:devatcloud-pr-builder-link.png}}
   * Both Eclipse and Idea support Checkstyle integration.
   * jclouds Checkstyle does not enforce all coding styles that should be 
followed in pull requests. However, developers can use this jclouds profile 
(compatible for import in both Eclipse and Idea): 
[[attachment:eclipse-code-formatter.xml]]; Also when using Idea ensure that .* 
imports are not used (under code style -> imports).
-  * Java dependency: jclouds 2.0 and onwards target Java 7 and thus cannot use 
newer language features or API additions in Java 8.  jclouds 1.8 and earlier 
target Java 6.  Note that jclouds Maven configuration prevents incorrect use of 
newer language features but not newer APIs.
-  * Guava: jclouds extensively uses 
[[https://code.google.com/p/guava-libraries/|Guava]] to provide additional 
functionality and consistent abstractions.  jclouds code should reuse Guava 
functionality instead of including equivalent libraries, e.g., Apache Commons. 
+  * Java language level: jclouds targets Java language level 6 and thus cannot 
use newer language features or API additions in Java 7. Note that jclouds Maven 
configuration prevents incorrect use of newer language features but not newer 
APIs (yet). The only exception to this rule is the filesystem api, which is 
configured by Maven to use Java language level 7.
+  * Guava: jclouds extensively uses 
[[https://code.google.com/p/guava-libraries/|Guava]] to provide additional 
functionality and consistent abstractions as opposed to other libraries, e.g., 
Apache Commons. That said, Guava usage should be limited in public apis, and 
not used in domain/value classes. This is to avoid runtime incompatibilities 
and confusion between types defined in Guava and Java 8.
  

Reply via email to