Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes