Estas anotaciones están basadas en el patrón MVC. A saber:
Las clases decoradas con la anotación @Controller
sirven como la C de MVC. Cabe resaltar que el verdadero controlador en Spring MVC es la clase DispatchServlet
que usará las clases @Controller
específicas para atender las peticiones en base al mapeo de las URLs declaradas.
Las clases decoradas con la anotación @Service
deberían servir para tu capa de servicio o lógica de negocio. Aquí es donde colocas la lógica de negocio de tu aplicación, reglas de negocio, entre otros.
Las clases decoradas con la anotación @Repository
deberían servir para la capa de acceso a datos. Aquí deberías colocar la lógica de CRUD: inserción, actualización (update), eliminación (física y/o lógica), consultas (select).
Las clases @Service
, @Repository
y tus clases de entidad serán la M de MVC. Tus archivos JSP y otras tecnologías de vista (JSTL, mustache, etc) conforman la V de MVC.
Las clases @Controller
solo deberían tener acceso a las clases @Service
mediante interfaces. De manera similar, las clases @Service
solo deberían tener acceso a otras clases @Service
y a un conjunto específico de clases @Repository
mediante interfaces.
Ejemplo:
//Entidades
public class Recibo {
private List<DetalleRecibo>
}
public class Producto { }
public class DetalleRecibo {
Producto producto;
}
//DAOs, Repositorios, etc
public interface ReciboDao {
void guardar(Recibo recibo);
}
//nota: estas anotaciones van a nivel de clase, NO a nivel de interfaz
@Repository
public class ReciboDaoImpl implements ReciboDao {
//implementa los métodos
//puede mandarlo a archivo, usar JDBC u otro framework
//como Hibernate, JPA, MyBatis, jOOQ
//o usar un repositorio de datos externo como servicios REST
}
public interface ProductoDao {
Producto obtener(int id);
void actualizar(Producto producto);
}
@Repository
public class ProductoDaoImpl implements ProductoDao {
//implementación...
}
//Service
public interface ProductoService {
Producto obtener(int id);
void actualizarStock(Producto productoConStockActualizado);
}
@Service
public class ProductoServiceImpl implements ProductoService {
//se le asocia al ProductoDao (interfaz)
//ojo que debería acceder de manera vertical/jerárquica
//al dao asociado a la entidad Producto
@Autowired
private ProductoDao productoDao;
@Override
public Producto obtener(int id) {
return productoDao.obtener(id);
}
@Override
public void actualizarStock(Producto productoConStockActualizado) {
//ejemplo minimalista y básico
//la implementación de un caso de uso como el de aquí debería
//considerar más elementos
Producto actual = obtener(productoConStockActualizado.getId());
if (actual.getStock() - productoConStockActualizado.getStock() < 0)
throw new MiExcepcion("Producto no puede tener stock negativo");
productoDao.actualizar(productoConStockActualizado);
}
}
public interface ReciboService {
Recibo generaRecibo(List<DetalleRecibo> listaDetalleRecibo);
void guardar(Recibo recibo);
}
@Service
public class ReciboServiceImpl {
//se le asocia a ReciboDao, similar a la relación
//entre ProductoService y ProductoDao
@Autowired
private ReciboDao reciboDao;
//Nota: si ReciboServiceImpl quiere consultar u operar
//con la información de la entidad Producto
//en lugar de asociarse a ProductoDao se asociará
//a ProductoService puesto que su implementación posee
//reglas de negocio a usar en la aplicación
@Autowired
private ProductoService productoService;
@Override
public Recibo generaRecibo(List<DetalleRecibo> listaDetalleRecibo) {
//usar la información de detalle del recibo
//para armar y generar un recibo
//ejemplo
for (DetalleRecibo detalle : listaDetalleRecibo) {
Producto producto = detalle.getProducto();
productoService.actualizarStock(producto);
}
//más procesamiento...
//se retorna el recibo generado
}
@Override
public void guardar(Recibo recibo) {
reciboDao.guardar(recibo);
}
}
@Controller
public class VentaController {
@Autowired
private ReciboService reciboService;
@RequestMapping(...)
public void guardaRecibo() {
//procesa la información recibida
//genera el recibo, lo guarda, etc...
}
}
Adaptado de mi respuesta en el sitio en inglés.