Migrate from javax.annotation to jakarta.annotation namespace

[Copilot]

Jakarta EE 9.1 changed the package namespace from javax to jakarta. This migration enables compatibility with modern frameworks like Quarkus and Helidon that require the jakarta namespace.

Changes

Source files

• Replaced all javax.annotation.* imports and fully-qualified annotations with jakarta.annotation.* across:
  • util module (@Nullable, @Nonnull)
  • spring module (@Resource)
  • client-java-contrib/prometheus-operator (@Generated, @Nullable)
  • client-java-contrib/admissionreview (@Nullable)

Dependencies

• Removed javax.annotation-api from dependency management and all module poms
• Added jakarta.annotation-api where needed (util, prometheus-operator)
• Existing jakarta dependency in kubernetes/pom.xml now serves as sole annotation source

Pre-merge validation

Added Spotless rule to prevent reintroduction of javax.annotation:

<replaceRegex>
  <name>Forbids javax.annotation imports</name>
  <searchRegex>^import (static )?javax\.annotation\..*;$</searchRegex>
  <replacement>INVALID IMPORTS (JAVAX.ANNOTATION) - use jakarta.annotation instead</replacement>
</replaceRegex>

Builds will fail if any javax.annotation imports are introduced.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• groovy.jfrog.io
  • Triggering command: /usr/lib/jvm/temurin-17-jdk-amd64/bin/java /usr/lib/jvm/temurin-17-jdk-amd64/bin/java -classpath /home/REDACTED/work/java/java/.mvn/wrapper/maven-wrapper.jar -Dmaven.multiModuleProjectDirectory=/home/REDACTED/work/java/java org.apache.maven.wrapper.MavenWrapperMain spotless:check -pl util grep -l javax\.annotation erBehavior.java rceFieldRef.java -l dels/V1StorageClassListFluent.java rSpecSelfSigned.java grep /io/kubernetes/client/spring/extended/controller/KubernetesInformerCreatorTest.java dels/V1ResourceClaimTemplateListFluent.java /home/REDACTED/work/java/java/kubegrep (dns block)
  • Triggering command: /usr/lib/jvm/temurin-17-jdk-amd64/bin/java /usr/lib/jvm/temurin-17-jdk-amd64/bin/java -classpath /home/REDACTED/work/java/java/.mvn/wrapper/maven-wrapper.jar -Dmaven.multiModuleProjectDirectory=/home/REDACTED/work/java/java org.apache.maven.wrapper.MavenWrapperMain spotless:apply -pl util -Dgroovy.skip=true -q javax\.annotation va grep -l dels/V1ValidatingAdmissionPolicyListFluent.java /home/REDACTED/work/java/java/fluegrep grep /io/kubernetes/client/spring/extended/manifests/KubernetesManifestTest.java gnoredDuringExecutionInnerPodAffinityTermNamespaceSelector.java rReferenceBuilder.java (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Question: any plans to migrating from javax to jakarta package namespaces?</issue_title>
<issue_description>In Jakarta EE 9.1 APIs package namespace was changed from javax to jakarta. Jakarta EE 9.1 is supported by many popular frameworks like Quarkus, Helidon, etc.

Here are some links talking about this namespace change:

• Quarkus Migration to Jakarta EE packages (javax.* to jakarta.* namespace change) quarkusio/quarkus#21574
• Helidon https://helidon.io/docs/v3/#/mp/guides/migration_3x

Are there any plans for such a migration in the k8s client?</issue_description>

<agent_instructions>In addition to migrating all references to javax.annotation to use Jakarta.annotation, please add a pre-merge validator which prevents us from adding any new references to javax.annotation. This should be possible by adding a custom style rule in our pom.xml</agent_instructions>

Comments on the Issue (you are @copilot in this section)

@brendandburns I think it would be fine to migrate the `javax.annotation.*` to `jakarta.annotation.*` The other javax references are for SSL and I don't believe that is present in the jakarta namespace (nor do I necessarily want to switch ssl implementations)

But we'd definitely take a PR to update all of the annotations if you wanted to send it.</comment_new>
<comment_new>@brendandburns
Some reference/background reading:

https://www.infoworld.com/article/3600158/enterprise-java-gets-a-new-namespace.html</comment_new>

• Fixes Question: any plans to migrating from javax to jakarta package namespaces? #2606

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[brendandburns]

/lgtm
/approve

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: brendandburns, Copilot

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [brendandburns]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment