CKTIS / Java
uses — declarar el uso de un servicio en un módulo
La directiva uses en module-info.java identifica un tipo de servicio cuyos proveedores puede buscar el módulo mediante ServiceLoader. No selecciona una implementación concreta ni inicia la búsqueda por sí sola. uses es una palabra clave contextual, no reservada.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
module ModuleName {
uses ServiceType;
}uses ServiceType; se coloca dentro de la declaración del módulo en module-info.java. El tipo de servicio es un contrato, normalmente una interfaz, y un proveedor ofrece una implementación. uses es una palabra clave contextual: tiene un significado especial en esta posición, pero fuera del contexto adecuado puede ser un identificador, como el nombre de una variable.
La directiva declara el uso de un servicio; el código realiza la búsqueda mediante java.util.ServiceLoader. No crea instancias automáticamente ni garantiza que se encuentre un proveedor. Cuando el código de un módulo explícito invoca ServiceLoader.load(ServiceType.class), la comprobación del uso del servicio se supera si el módulo contiene la directiva uses correspondiente o si ha añadido ese uso en tiempo de ejecución mediante Module.addUses. Si no se cumple ninguna de estas condiciones, la llamada lanza ServiceConfigurationError.
No confundas uses con requires o provides ... with ...: requires declara una dependencia de módulo, mientras que provides registra un proveedor. Si el servicio pertenece a otro módulo, su tipo debe ser accesible para el consumidor; uses no sustituye la dependencia necesaria ni la exportación del paquete. No hace falta declarar una dependencia del módulo del proveedor concreto.
El tipo de servicio no puede ser una clase enum. Repetir uses para el mismo servicio en una declaración de módulo es un error de compilación. El ejemplo reúne al consumidor y a su único proveedor en un módulo para que sea autónomo. La clase anidada Hello es public y static y tiene un constructor public sin argumentos.
Ejemplos
// src/demo/module-info.java
module demo {
uses demo.Main.Greeting;
provides demo.Main.Greeting with demo.Main.Hello;
}
// src/demo/demo/Main.java
package demo;
import java.util.ServiceLoader;
public class Main {
public interface Greeting {
String message();
}
public static class Hello implements Greeting {
public Hello() {}
@Override
public String message() {
return "Hello";
}
}
public static void main(String[] args) {
Greeting greeting = ServiceLoader.load(Greeting.class)
.findFirst().orElseThrow();
System.out.println(greeting.message());
}
}Resultado
Hello
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.