Make mongo-hibernate.jar a Java module
#149
Conversation
stIncMale
force-pushed
the
HIBERNATE-52
branch
from
3856819 to
332f624
Compare
| tasks.withType<JavaCompile>().configureEach { | ||
| options.compilerArgs.addAll(listOf("-Xlint:all", "-Werror")) | ||
| options.compilerArgs.addAll( | ||
| listOf("-Xlint:all", "-Xlint:-requires-automatic", "-Xlint:-requires-transitive-automatic", "-Werror")) |
There was a problem hiding this comment.
It seems fine to declare requires and requires-transitive for automatic modules, as long as those modules get their names specified via the Automatic-Module-Name JAR manifest attribute. See https://dev.java/learn/modules/automatic-module/#depending-on-automatic-modules for more details.
HIBERNATE-52
…umentation HIBERNATE-52
stIncMale
force-pushed
the
HIBERNATE-52
branch
from
332f624 to
7b850d2
Compare
HIBERNATE-52
| useJavaOutput() | ||
| packageName("com.mongodb.hibernate.internal") | ||
| documentation.set( | ||
| "Generated by the <a href=\"https://github.com/gmazzo/gradle-buildconfig-plugin\">BuildConfig</a> plugin.\n\n@hidden") |
There was a problem hiding this comment.
I failed to exclude out generated code using -XepExcludedPaths - Error Prone seem to ignore this argument. So, to prevent it from complaining, I had to add the summary documentation line it complains about.
| addBooleanOption("Werror", false) | ||
| // TODO-HIBERNATE-129 addStringOption("-link-modularity-mismatch", "info") |
There was a problem hiding this comment.
We can't enable -Werror because of the single warning we have that can only be disabled in Java SE 18+.
| disableWarningsInGeneratedCode = true | ||
| // Error Prone does not understand the `@hidden` standard tag | ||
| disable("InvalidBlockTag") | ||
| disable("AssignmentExpression") |
There was a problem hiding this comment.
I upgraded the Error Prone, and it now has the AssignmentExpression check enabled by default. We don't have a problem with people using such expressions lightly, but they can be useful in some situations. We already have a single instance of using an assignment expression in the codebase.
HIBERNATE-52
stIncMale
requested review from
katcharov and
vbabanin
and removed request for
a team and
katcharov
There was a problem hiding this comment.
We no longer need this annotation, as now we can actually use sealed classes without the limitation of having to have all permits in the same package as the sealed class.
|
I realized that I should add some |
1 participant
@vbabanin, thank you for the information about the
@hiddenstandard tag! Note that I added it in a separate commit to make reviewing simpler.The only way I see of completely removing the non-exported program elements from the API documentation is to move all those packages to a newcom.mongodb.hibernate.internalmodule, whichexports ... to com.mongodb.hibernate. This requires declaring incom.mongodb.hibernatethatrequires transitive com.mongodb.hibernate.internal, and also requires publishing the artifact for thecom.mongodb.hibernate.internalmodule. Producing multiple Java modules also means using a multi-project Gradle build.I also upgraded Gradle to 9.2.1 (fortunately, it was trivial as the automatic upgrade worked just fine) and Error Prone (to the latest version that still works for us).
HIBERNATE-52