Что добавляет @Service

# @Service аннотация в Spring: полное объяснение

Определение

@Service — это специальная аннотация Spring, которая помечает класс как сервис (компонент бизнес-логики). Это делает класс управляемым Spring-ом и добавляет специфическую функциональность.

Иерархия аннотаций

// @Service наследует @Component
@Component  // Самая базовая аннотация
@Service    // Специализированная @Component для сервисов
@Repository // Специализированная @Component для БД операций
@Controller // Специализированная @Component для контроллеров

// Исходный код Spring
@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Component  // Да, @Service наследует @Component!
public @interface Service {
    @AliasFor(annotation = Component.class)
    String value() default "";
}

Что добавляет @Service?

1. Регистрация в IoC контейнере Spring

// Без @Service
public class UserService {
    public User findUser(Long id) { /* ... */ }
}

// Spring не знает об этом классе
UserService service = new UserService();

// -----------------------------------------------

// С @Service
@Service
public class UserService {
    public User findUser(Long id) { /* ... */ }
}

// Spring автоматически создаёт инстанс
UserService service = applicationContext.getBean(UserService.class);

2. Dependency Injection (DI)

Благодаря @Service, Spring может внедрять зависимости:

@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;
    
    public User findUser(Long id) {
        return userRepository.findById(id);
    }
}

// Или через конструктор (более предпочтительно)
@Service
public class UserService {
    private final UserRepository userRepository;
    
    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }
    
    public User findUser(Long id) {
        return userRepository.findById(id);
    }
}

3. Доступность через контекст приложения

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        ApplicationContext context = SpringApplication.run(Application.class);
        
        // Можем получить bean'ы из контейнера
        UserService userService = context.getBean(UserService.class);
        User user = userService.findUser(1L);
    }
}

Где @Service появляется в приложении?

Типичная архитектура

Controller (RestController)
    |
    v
Service (@Service) -- бизнес-логика
    |
    v
Repository (@Repository) -- работа с БД

// 1. КОНТРОЛЛЕР (обрабатывает HTTP запросы)
@RestController
@RequestMapping("/api/users")
public class UserController {
    @Autowired
    private UserService userService;
    
    @GetMapping("/{id}")
    public ResponseEntity<UserDTO> getUser(@PathVariable Long id) {
        User user = userService.findUser(id);
        return ResponseEntity.ok(new UserDTO(user));
    }
}

// 2. СЕРВИС (бизнес-логика)
@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;
    
    public User findUser(Long id) {
        User user = userRepository.findById(id)
            .orElseThrow(() -> new UserNotFoundException(id));
        
        user.setLastAccessTime(LocalDateTime.now());
        return user;
    }
}

// 3. РЕПОЗИТОРИЙ (работа с БД)
@Repository
public interface UserRepository extends JpaRepository<User, Long> {
}

Специальные возможности @Service

1. Транзакции (@Transactional)

@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;
    
    @Transactional
    public void createUserWithProfile(User user, Profile profile) {
        userRepository.save(user);
        profileRepository.save(profile);
        // Если падает — откатится и первая операция
    }
}

2. Кэширование

@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;
    
    @Cacheable("users")
    public User findUser(Long id) {
        return userRepository.findById(id)
            .orElseThrow(() -> new UserNotFoundException(id));
    }
    
    @CacheEvict("users", allEntries = true)
    public void save(User user) {
        userRepository.save(user);
    }
}

3. Аспекты (AOP)

// Логирование всех вызовов методов в @Service
@Aspect
@Component
public class LoggingAspect {
    @Around("@within(org.springframework.stereotype.Service)")
    public Object logServiceMethods(ProceedingJoinPoint pjp) throws Throwable {
        System.out.println("Вызов: " + pjp.getSignature());
        Object result = pjp.proceed();
        System.out.println("Результат: " + result);
        return result;
    }
}

@Service vs обычный класс

Без @Service

public class UserService {
    private UserRepository userRepository = new UserRepository();
    
    public User findUser(Long id) {
        return userRepository.findById(id);
    }
}

// Использование
public class UserController {
    private UserService userService = new UserService();
    
    public void getUser(Long id) {
        User user = userService.findUser(id);
    }
}

Проблемы:

• Жёсткая связь между классами
• Сложно тестировать
• Вручную управляем жизненным циклом
• Дублирование кода

С @Service

@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;
    
    public User findUser(Long id) {
        return userRepository.findById(id);
    }
}

// Использование
@RestController
public class UserController {
    @Autowired
    private UserService userService;
    
    @GetMapping("/users/{id}")
    public User getUser(@PathVariable Long id) {
        return userService.findUser(id);
    }
}

Преимущества:

• Слабая связь — легко поменять реализацию
• Простое тестирование
• Spring управляет жизненным циклом
• Нет дублирования

Тестирование @Service

@SpringBootTest
public class UserServiceTest {
    @MockBean
    private UserRepository userRepository;
    
    @Autowired
    private UserService userService;
    
    @Test
    public void testFindUser() {
        User user = new User(1L, "John");
        when(userRepository.findById(1L)).thenReturn(Optional.of(user));
        
        User result = userService.findUser(1L);
        
        assertEquals("John", result.getName());
        verify(userRepository).findById(1L);
    }
}

Правильное именование сервисов

// Правильно: задача + Service
@Service
public class UserRegistrationService { }

@Service
public class PaymentProcessingService { }

@Service
public class EmailNotificationService { }

Когда @Service рекомендуется?

В бизнес-логике приложения, когда нужны транзакции, кэширование, логирование и правильная архитектура.

Резюме

@Service — это специализированная аннотация Spring, которая регистрирует класс в IoC контейнере, позволяет внедрять зависимости, даёт доступ к функциям Spring (транзакции, кэширование, AOP) и делает код более тестируемым.