Contexto

En el desarrollo de software corporativo moderno, manejar entidades de negocio (productos, clientes, órdenes) mediante estructuras primitivas o colecciones sin tipos (raw types como ArrayList sin <>) introduce graves riesgos de errores en tiempo de ejecución (ClassCastException).

El Java Collections Framework (JCF) provee abstracciones de alto nivel (List, Set, Map) que, combinadas con tipos genéricos (Generics), permiten diseñar componentes reutilizables, fuertemente tipados y eficientes.

Consigna

Vas a implementar un motor de almacenamiento en memoria genérico siguiendo las mejores prácticas de Programación Orientada a Objetos y Código Limpio.

1. Abstracción del Dominio

  • Identificable.java:
    public interface Identificable<ID> {
        ID getId();
    }
  • Producto.java:
    • Implementa Identificable<String>.
    • Atributos privados: id (String), nombre (String), categoria (String), precio (double).
    • Constructor canónico que valide que ningún String sea nulo o vacío y que el precio sea estrictamente mayor a 0.
    • Métodos accesores (getters) y método toString() formateado con claridad.

2. Capa de Persistencia Genérica

  • Repositorio.java:
    • Interfaz genérica con restricción de tipos:
    public interface Repositorio<T extends Identificable<ID>, ID> {
        void guardar(T entidad);
        T buscarPorId(ID id);
        List<T> listarTodos();
        boolean eliminar(ID id);
        boolean existe(ID id);
        int contar();
    }
  • RepositorioMemoria.java:
    • Implementación que utiliza un Map<ID, T> almacenamiento = new HashMap<>();.
    • guardar(T entidad): si entidad == null, lanza IllegalArgumentException. Si ya existe una entidad con esa clave (almacenamiento.containsKey(entidad.getId())), lanza IllegalStateException con un mensaje descriptivo.
    • buscarPorId(ID id): retorna la entidad encontrada o null.
    • listarTodos(): devuelve una copia inmutable o una nueva lista new ArrayList<>(almacenamiento.values()), protegiendo la colección interna contra modificaciones externas no autorizadas.
  • CatalogoProductos.java:
    • Encapsula una instancia de Repositorio<Producto, String>.
    • Mantiene un Set<String> categorias = new HashSet<>(); que registra automáticamente las categorías existentes sin duplicados.
    • Provee métodos para agregar productos, consultar categorías únicas (Set<String>) y buscar por ID.

4. Demostración en MainInventario

En MainInventario.java:

  1. Instanciá el catálogo.
  2. Registrá varios productos válidos.
  3. Mostrá la lista completa y el conjunto de categorías únicas.
  4. Realizá una búsqueda exitosa y otra fallida.
  5. Verificá que al intentar ingresar un producto con un ID existente, el sistema capture la excepción e informe el rechazo.