SiCom Multi-Module Maven Architecture Explained

XHTML view (PrimeFaces)
   │  EL binding  #{articuloUI.guardarNuevo()}
   ▼
CDI Bean  ui.ArticuloBeanUI  (@Named @SessionScoped)
   │  delegates to helper
   ▼
Helper  helper.ArticuloHelper
   │  calls ServiceFacadeLocator
   ▼
Facade  mx.desarollo.facade.FacadeArticulo
   │  validates business rules, calls delegate
   ▼
Delegate  mx.desarollo.delegate.DelegateArticulo
   │  calls ServiceLocator
   ▼
DAO  mx.avanti.desarollo.dao.ArticuloDAO  (extends AbstractDAO)
   │  EntityManager + EntityTransaction
   ▼
MySQL 8  (via HikariCP pool, persistence unit "persistencePU")

// ui/ArticuloBeanUI.java  (@Named("articuloUI") @SessionScoped)
public class ArticuloBeanUI implements Serializable {

    private final ArticuloHelper articuloHelper;

    public ArticuloBeanUI() {
        articuloHelper = new ArticuloHelper();   // plain instantiation, no CDI injection
    }

    public void guardarNuevo() {
        // ... validation logic ...
        nuevoArticulo.setPrecio(nuevoPrecio);

        Imagen imagen = new Imagen();
        imagen.setDatos(imagenBytes);
        imagen.setMime(imagenMime);

        // delegate to helper — bean never touches the Facade directly
        articuloHelper.guardarConImagen(nuevoArticulo, imagen);

        articulosOriginales = articuloHelper.obtenerTodas();
    }
}

// helper/ArticuloHelper.java
public class ArticuloHelper {

    public void guardarConImagen(Articulo articulo, Imagen imagen) {
        // reaches across to the business layer via the locator
        ServiceFacadeLocator.getInstanceFacadeArticulo()
                            .crearArticuloConImagen(articulo, imagen);
    }

    public List<Articulo> obtenerTodas() {
        return ServiceFacadeLocator.getInstanceFacadeArticulo()
                                   .obtenerArticulos();
    }
}

// mx.desarollo.facade.FacadeArticulo
public class FacadeArticulo {

    private final DelegateArticulo delegateArticulo;

    public FacadeArticulo() {
        this.delegateArticulo = new DelegateArticulo();
    }

    public void crearArticuloConImagen(Articulo articulo, Imagen imagen) {
        if (delegateArticulo.existsArticuloByNombre(articulo.getNombre())) {
            throw new IllegalArgumentException("Ya existe un articulo con ese nombre");
        }
        articulo.setNombre(articulo.getNombre().trim());
        delegateArticulo.saveArticuloWithImage(articulo, imagen);
    }
}