Какая аннотация используется для добавления бина?

Какая аннотация используется для добавления бина

В Spring Framework есть несколько аннотаций для регистрации бинов в контексте приложения. Каждая имеет свой назначение и область применения.

1. @Component — базовая аннотация

Самая универсальная и часто используемая аннотация для любого компонента:

import org.springframework.stereotype.Component;

@Component
public class EmailService {
    public void sendEmail(String to, String message) {
        System.out.println("Sending email to " + to);
    }
}

Spring автоматически обнаружит этот класс через component scanning и создаст бин.

По умолчанию: имя бина = первая буква класса в нижнем регистре ("emailService")

@Component("customEmailService")
public class EmailService {
}

2. @Service — для бизнес-логики

Специализированная аннотация для слоя сервисов:

import org.springframework.stereotype.Service;

@Service
public class UserService {
    private final UserRepository userRepository;
    
    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }
    
    public User getUserById(Long id) {
        return userRepository.findById(id)
            .orElseThrow(() -> new UserNotFoundException(id));
    }
    
    public void updateUser(User user) {
        userRepository.save(user);
    }
}

Функционально идентична @Component, но семантически указывает на бизнес-логику.

3. @Repository — для работы с БД

Аннотация для Data Access Object (DAO) слоя:

import org.springframework.stereotype.Repository;
import org.springframework.data.jpa.repository.JpaRepository;

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    User findByEmail(String email);
    
    List<User> findAllActive();
}

Особенность: Spring автоматически транслирует исключения БД в Spring Data Access exceptions.

4. @Controller — для веб-слоя

Аннотация для классов, которые обрабатывают HTTP запросы:

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;

@Controller
@RequestMapping("/api/users")
public class UserController {
    
    private final UserService userService;
    
    public UserController(UserService userService) {
        this.userService = userService;
    }
    
    @GetMapping("/{id}")
    public String getUser(@PathVariable Long id, Model model) {
        User user = userService.getUserById(id);
        model.addAttribute("user", user);
        return "user-details";
    }
}

5. @RestController — для REST API

Комбинация @Controller + @ResponseBody. Все методы автоматически сериализуют результат в JSON:

import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;

@RestController
@RequestMapping("/api/v1/users")
public class UserRestController {
    
    private final UserService userService;
    
    public UserRestController(UserService userService) {
        this.userService = userService;
    }
    
    @GetMapping("/{id}")
    public ResponseEntity<UserDto> getUserById(@PathVariable Long id) {
        User user = userService.getUserById(id);
        return ResponseEntity.ok(new UserDto(user));
    }
    
    @PostMapping
    public ResponseEntity<UserDto> createUser(@RequestBody CreateUserRequest request) {
        User user = userService.createUser(request);
        return ResponseEntity.status(HttpStatus.CREATED)
            .body(new UserDto(user));
    }
}

6. @Configuration — для конфигурационных классов

Аннотация для классов, которые определяют бины вручную через методы:

import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Bean;

@Configuration
public class AppConfig {
    
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        mapper.registerModule(new JavaTimeModule());
        mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
        return mapper;
    }
    
    @Bean
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }
    
    @Bean
    public PasswordEncoder passwordEncoder() {
        return new BCryptPasswordEncoder();
    }
}

Методы с @Bean возвращают объекты, которые регистрируются как бины в контексте.

7. @Bean — для явной регистрации бина

Используется внутри @Configuration классов:

@Configuration
public class DatabaseConfig {
    
    @Bean
    public DataSource dataSource() {
        return new HikariDataSource(createHikariConfig());
    }
    
    @Bean
    public JdbcTemplate jdbcTemplate(DataSource dataSource) {
        return new JdbcTemplate(dataSource);
    }
}

Преимущество: полный контроль над созданием и инициализацией бина.

8. @Conditional — условная регистрация

Можно регистрировать бины только при определённых условиях:

import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;

@Component
@ConditionalOnProperty(
    name = "app.email.enabled",
    havingValue = "true"
)
public class EmailService {
}

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

• @Component — базовая
• @Service — для бизнес-логики
• @Repository — для БД/DAO
• @Controller — для веб-контроллеров
• @RestController — для REST API
• @Configuration + @Bean — для явной регистрации

Component Scanning

По умолчанию Spring сканирует пакет приложения и все подпакеты:

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

Можно настроить диапазон сканирования:

@Configuration
@ComponentScan(basePackages = {
    "com.example.service",
    "com.example.repository"
})
public class AppConfig {
}

Порядок предпочтения

Используй:

1. @Service для бизнес-сервисов
2. @Repository для DAO/database классов
3. @RestController для REST API endpoints
4. @Configuration + @Bean для внешних библиотек
5. @Component только если ничего из выше не подходит

Рекомендация: всегда явно указывай правильную аннотацию — это улучшает читаемость и позволяет инструментам лучше анализировать код.