Где применяется @Service?

Применение аннотации @Service в Spring Framework

Аннотация @Service — это специализированная аннотация Spring Framework, которая применяется для обозначения бизнес-логики приложения. Она является частью системы управления компонентами Spring и играет критическую роль в архитектуре многоуровневых приложений.

Основное назначение @Service

@Service используется для обозначения класса, который содержит бизнес-логику приложения (бизнес-слой). Spring автоматически регистрирует такие классы как бины (beans) в контексте приложения, что позволяет использовать их через инъекцию зависимостей.

import org.springframework.stereotype.Service;

@Service
public class UserService {
    
    private UserRepository userRepository; // Инъекция зависимости
    
    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }
    
    // Бизнес-логика
    public User registerNewUser(String email, String password) {
        // Проверки, валидация
        if (userRepository.existsByEmail(email)) {
            throw new EmailAlreadyExistsException("Email уже зарегистрирован");
        }
        
        // Создание и сохранение
        User user = new User(email, encodePassword(password));
        return userRepository.save(user);
    }
    
    public List<User> getAllActiveUsers() {
        return userRepository.findAllByStatusActive();
    }
}

Применение @Service в архитектуре

В типичной трёхуровневой архитектуре Spring приложения:

Presentation Layer (Controller)
         ↓
   Service Layer (Service)  ← @Service используется здесь
         ↓
Data Access Layer (Repository)
         ↓
Database

Пример полного стека

// 1. Контроллер (Presentation)
@RestController
@RequestMapping("/api/users")
public class UserController {
    
    private UserService userService; // Инъекция Service
    
    @PostMapping
    public ResponseEntity<User> createUser(@RequestBody CreateUserDto dto) {
        User user = userService.registerNewUser(dto.getEmail(), dto.getPassword());
        return ResponseEntity.ok(user);
    }
}

// 2. Сервис (Service Layer)
@Service
@Transactional  // Управление транзакциями
public class UserService {
    
    private UserRepository userRepository; // Инъекция Repository
    private EmailService emailService;     // Инъекция другого сервиса
    
    @Autowired
    public UserService(UserRepository userRepository, EmailService emailService) {
        this.userRepository = userRepository;
        this.emailService = emailService;
    }
    
    public User registerNewUser(String email, String password) {
        // Бизнес-логика
        validateEmail(email);
        validatePassword(password);
        
        User user = new User(email, encryptPassword(password));
        userRepository.save(user);
        
        // Отправка письма
        emailService.sendWelcomeEmail(email);
        
        return user;
    }
}

// 3. Repository (Data Access)
@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    Optional<User> findByEmail(String email);
    boolean existsByEmail(String email);
}

Различия между @Service, @Component, @Repository

Все три аннотации являются специализациями @Component, но имеют разные смыслы:

@Service

@Service
public class OrderService {
    // Содержит бизнес-логику
    public Order createOrder(Order order) {
        validateOrder(order);
        return orderRepository.save(order);
    }
}

@Repository

@Repository
public class UserRepository extends JpaRepository<User, Long> {
    // Отвечает за доступ к данным
    // Spring автоматически преобразует JpaRepository исключения
}

@Component

@Component
public class UtilityComponent {
    // Общая служебная компонента
}

Хотя функционально все они работают одинаково (регистрируют бин), их использование следует соглашениям и упрощает понимание архитектуры.

Практические примеры использования @Service

Пример 1: Сервис с методами по доменной логике

@Service
public class PaymentService {
    
    private PaymentRepository paymentRepository;
    private NotificationService notificationService;
    
    @Transactional
    public Payment processPayment(Long orderId, BigDecimal amount) {
        Order order = orderService.getOrder(orderId);
        
        if (!order.canBePaid()) {
            throw new InvalidOrderStateException();
        }
        
        Payment payment = new Payment(order, amount);
        payment = paymentRepository.save(payment);
        
        notificationService.notifyPaymentProcessed(order);
        
        return payment;
    }
}

Пример 2: Сервис с кэшированием

@Service
public class CatalogService {
    
    @Cacheable("products")
    public List<Product> getAllProducts() {
        return productRepository.findAll();
    }
    
    @CacheEvict("products", allEntries = true)
    public void invalidateCache() {
        // Инвалидация кэша
    }
}

Пример 3: Сервис с асинхронными операциями

@Service
public class ReportService {
    
    @Async
    public CompletableFuture<Report> generateReportAsync(ReportRequest request) {
        // Долгая операция в отдельном потоке
        Report report = generateReport(request);
        return CompletableFuture.completedFuture(report);
    }
}

Управление зависимостями в @Service

@Service
public class AdvancedService {
    
    // Constructor Injection (рекомендуется)
    private final UserRepository userRepository;
    private final EmailService emailService;
    
    public AdvancedService(UserRepository userRepository, EmailService emailService) {
        this.userRepository = userRepository;
        this.emailService = emailService;
    }
    
    // Или с @Autowired (менее рекомендуется)
    @Autowired
    public void setEmailService(EmailService emailService) {
        this.emailService = emailService;
    }
}

Область видимости (@Scope)

@Service
@Scope("prototype") // Новый экземпляр каждый раз (по умолчанию singleton)
public class StatefulService {
    private String state;
}

По умолчанию @Service использует scope "singleton" — один экземпляр на все приложение, что критично для производительности.

Заключение

@Service — это признак архитектурного значения класса. Правильное использование @Service делает код более читаемым, следует Spring соглашениям и позволяет легче тестировать приложение."