Note that custom checkstyle rule implementations does not fare well with IDE checkstyle
I can't make it reliably work on search and OGM.
On 16 mai 2015, at 16:11, Sanne Grinovero <sanne(a)hibernate.org>
One nice thing of checkstyle is that it's easily extended, for example
in Search we added a couple of checks, like to ban double whitespaces:
Or to ban specific import statements:
For example this is useful to iteratively move away from
commons-annotations, like we ban its AssertionFailure to favor usage
of a different AssertionFailure within Search:
But checkstyle isn't enough, I for one would love to ban auto-boxing
from our main code (it's ok in tests) as I'd rather the syntax call
explicit attention to it.
Sometimes it's dangerous for performance reasons, or because of other
subtle API compability reasons like the JBoss Logger upgrade.. but
checktyle can't do such things, you need to add additional tools to
the mix, like FindBugs.
Have a look at the above linked checkstyle.xml for more ideas, but
sometimes I feel we've been too strict as it does fire back on quick
prototyping: it's very annoying to have your build fail for a couple
of style errors when you're deep in debugging some functionality..
I'd rather stick to it though, as it can be disabled locally with
appropriate flags and there finally are no more delays in pull request
reviews because of whitespacing.
To make it slightly less annoying I've made a CheckStyle filter which
allows us to enforce some selected rules only on non-test code:
We could similarly extend it to enforce a package-info.java for all
non-test, non .impl packages?
One which I would strongly enforce is about having the right copyright
headers. For example I've seen various hibernate-infinispan classes
using a non-Hibernate template. The traditional header includes the
year, which was sometimes problematic (like you'd copy an header in a
new class and mark it with a 6 years old copyright); so now we're
using a simplified copyright template which is shorter and has no
(according to legal that's good enough)
> On 16 May 2015 at 00:19, Steve Ebersole <steve(a)hibernate.org> wrote:
> FYI : https://hibernate.atlassian.net/browse/HHH-9803
> Its not super high on my priority list, but I want to get to a point where
> we can start to fail the build on "serious checkstyle regressions". Part
> of that is being more realistic with what is considered serious, and part
> of that is fixing up code.
> For example, we have quite a few warnings about spaces rather than tabs for
> indentation. That's a serious one to me. There are quite a few "unused
> import" warnings, again to me that's serious (it just looks sloppy).
> A few I have already disabled. Checking that there is a package-info.java
> file for example. I'd love to make a requirement that all API and SPI
> packages have one. But as far as I know that detailing is not available in
> checkstyle, and I really dont overly care about package-info.java files for
> internal packages.
> These are just a few examples. #909 (still running atm) is the first
> build with my preliminary work here. Let me know if there are any checks
> anyone feels strongly about in one bucket or another.
>  http://ci.hibernate.org/job/hibernate-orm-master-h2/909/
> hibernate-dev mailing list
hibernate-dev mailing list