[BUG][JAVA] useSpecify=true does not generate package-info.java for <invokerPackage>.auth

[bjpe]

Description

When generating a Java client and activating the option <useJspecify>true</useJspecify> the for the packages

• <apiPackage>
• <invokerPackage>
• <modelPackage>
  a package-info.java file containing a @org.jspecify.annotations.NullMarked annotation is generated. However, such a package-info.java is missing for the <invokerPackage>.auth sub-package.

openapi-generator version

I'm using the openapi-generator-maven-plugin in version 7.24.0.

Suggest a fix

Add a authPackageInfo.mustache to https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator/src/main/resources/Java/auth and generate the package-info.java.

[jpfinne]

@bjpe The package-info for the invoker package is created here:

openapi-generator/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/JavaClientCodegen.java

Line 1407 in 55d06c5

if (Boolean.TRUE.equals(additionalProperties.get(CodegenConstants.GENERATE_APIS))) {

There are several issue with this code (disclaimer: this comes from me):

• a supporting file mustache template is used. Problem: new SupportingFile(...) does not support additional parameters. It means that a custom mustache template has to be created for each package. Doable but annoying.
• the generate ApiClient gives plenty of jspecify warnings
• if you add @NullMarked to the auth folder, you will get also plenty of jspecify warning

This is a minor issue if @Generated are not analyzed of course. Problem: cubic does validate them anyway.

For example in HttpBearerAuth.mustache you have

   if (bearerToken == null) {
            return;
    }

Workaround: Copy generatedAnnotation.mustache and add something like this at the start of the file:

{{#useJspecify}}
@org.jspecify.annotations.NullMarked
{{/useJspecify}}