//NextPatch
Perfil

Java 11 → 17: seis versiones de lenguaje · Los internos del JDK, cerrados

--add-opens vs --add-exports en Java 17: abrir los internos del JDK

Cargando la lección…

Guarda tu racha: crea tu cuenta

Este reto se sumará a tu cuenta nueva: su XP y tu primer día de racha. Luego, uno nuevo cada día para preparar tu próxima entrevista.

Al saltar a Java 17, muchas aplicaciones se encuentran con errores de acceso ilegal a internos del JDK. La opción --illegal-access, que en versiones anteriores dejaba la puerta abierta, ya no sirve. Lo que queda son dos opciones quirúrgicas.

La diferencia

  • --add-exports <módulo>/<paquete>=<destino> hace visible la API pública de un paquete que el módulo no exporta. Es lo mismo que haría un exports en el module-info.
  • --add-opens <módulo>/<paquete>=<destino> permite además reflexión profunda sobre los miembros no públicos: campos privados, setAccessible(true)… Es lo que haría un opens.

Si una librería usa reflexión para tocar campos privados del JDK, necesita --add-opens. --add-exports no le basta.

El destino: ALL-UNNAMED

Todo lo que carga el classpath vive en el módulo sin nombre, y en estas opciones se le nombra como ALL-UNNAMED:

java --add-opens java.base/java.lang=ALL-UNNAMED -jar app.jar

Las dos opciones existen tanto en compilación (javac) como en ejecución (java). Y un JAR ejecutable puede llevarlas en su manifiesto con el atributo Add-Opens, para que quien lo arranca no tenga que escribirlas.

Cómo migrar con cabeza

El orden de trabajo que propone el propio JEP: arrancar en tu JDK actual con --illegal-access=warn para ver qué se accede, repetir con debug para tener la traza de cada acceso, y sustituir lo que se pueda por API estándar, como java.util.Base64 o java.lang.ref.Cleaner. Solo lo que quede se abre explícitamente.

Cada --add-opens que dejas es una deuda documentada y revisable, en lugar de una puerta abierta de par en par para cualquier librería.