@Autowired

Вы можете применить аннотацию @Autowired к конструкторам, как показано в следующем примере:

public class MovieRecommender {
    private final CustomerPreferenceDao customerPreferenceDao;
    @Autowired
    public MovieRecommender(CustomerPreferenceDao customerPreferenceDao) {
        this.customerPreferenceDao = customerPreferenceDao;
    }
    // ...
}

class MovieRecommender @Autowired constructor(
    private val customerPreferenceDao: CustomerPreferenceDao)

Вы также можете применить аннотацию @Autowired к традиционным сеттерам, как показано в следующем примере:

public class SimpleMovieLister {
    private MovieFinder movieFinder;
    @Autowired
    public void setMovieFinder(MovieFinder movieFinder) {
        this.movieFinder = movieFinder;
    }
    // ...
}

class SimpleMovieLister {
    @set:Autowired
    lateinit var movieFinder: MovieFinder
    // ...
}

Вы также можете применить аннотацию к методам с произвольными именами и несколькими аргументами, как показано в следующем примере:

public class MovieRecommender {
    private MovieCatalog movieCatalog;
    private CustomerPreferenceDao customerPreferenceDao;
    @Autowired
    public void prepare(MovieCatalog movieCatalog,
            CustomerPreferenceDao customerPreferenceDao) {
        this.movieCatalog = movieCatalog;
        this.customerPreferenceDao = customerPreferenceDao;
    }
    // ...
}

class MovieRecommender {
    private lateinit var movieCatalog: MovieCatalog
    private lateinit var customerPreferenceDao: CustomerPreferenceDao
    @Autowired
    fun prepare(movieCatalog: MovieCatalog,
                customerPreferenceDao: CustomerPreferenceDao) {
        this.movieCatalog = movieCatalog
        this.customerPreferenceDao = customerPreferenceDao
    }
    // ...
}

Вы можете применять @Autowired и к полям, и даже смешивать его с конструкторами, как показано в следующем примере:

public class MovieRecommender {
    private final CustomerPreferenceDao customerPreferenceDao;
    @Autowired
    private MovieCatalog movieCatalog;
    @Autowired
    public MovieRecommender(CustomerPreferenceDao customerPreferenceDao) {
        this.customerPreferenceDao = customerPreferenceDao;
    }
    // ...
}

class MovieRecommender @Autowired constructor(
    private val customerPreferenceDao: CustomerPreferenceDao) {
    @Autowired
    private lateinit var movieCatalog: MovieCatalog
    // ...
}

Вы также можете дать Spring команду предоставить все бины определенного типа из ApplicationContext, добавив аннотацию @Autowired к полю или методу, который ожидает массив этого типа, как показано в следующем примере:

public class MovieRecommender {
    @Autowired
    private MovieCatalog[] movieCatalogs;
    // ...
}

class MovieRecommender {
    @Autowired
    private lateinit var movieCatalogs: Array<MovieCatalog>
    // ...
}

То же самое относится и к типизированным коллекциям, как показано в следующем примере:

public class MovieRecommender {
    private Set<MovieCatalog> movieCatalogs;
    @Autowired
    public void setMovieCatalogs(Set<MovieCatalog> movieCatalogs) {
        this.movieCatalogs = movieCatalogs;
    }
    // ...
}

class MovieRecommender {
    @Autowired
    lateinit var movieCatalogs: Set<MovieCatalog>
    // ...
}

Даже типизированные экземпляры Map могут быть автоматически найдены и связаны, если ожидаемый тип ключа - String. Значения в ассоциативных массивах (maps) содержат все бины ожидаемого типа, а ключи - соответствующие имена бинов, как показано в следующем примере:

public class MovieRecommender {
    private Map<String, MovieCatalog> movieCatalogs;
    @Autowired
    public void setMovieCatalogs(Map<String, MovieCatalog> movieCatalogs) {
        this.movieCatalogs = movieCatalogs;
    }
    // ...
}

class MovieRecommender {
    @Autowired
    lateinit var movieCatalogs: Map<String, MovieCatalog>
    // ...
}

По умолчанию автоматический поиск и связывание не работает, если для данной точки внедрения нет подходящих бинов-кандидатов. В случае объявленного массива, коллекции или ассоциативного массива ожидается наличие хотя бы одного совпадающего элемента.

Логика работы по умолчанию - рассмотрение аннотированных методов и полей как указывающих на необходимые зависимости. Вы можете изменить эту логику, как показано в следующем примере, позволяя фреймворку пропускать точку внедрения, не удовлетворяющую условиям, пометив ее как необязательную (т.е. установив атрибут required в @Autowired как false):

public class SimpleMovieLister {
    private MovieFinder movieFinder;
    @Autowired(required = false)
    public void setMovieFinder(MovieFinder movieFinder) {
        this.movieFinder = movieFinder;
    }
    // ...
}

class SimpleMovieLister {
    @Autowired(required = false)
    var movieFinder: MovieFinder? = null
    // ...
}

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

Аргументы внедренного конструктора и фабричного метода являются особым случаем, поскольку атрибут required в @Autowired имеет несколько иное значение из-за алгоритма разрешения конструктора Spring, который потенциально может работать с несколькими конструкторами. Аргументы метода конструктора и фабрики фактически необходимы по умолчанию, но с некоторыми специальными правилами в сценарии с одним конструктором, например, при многоэлементных точках введения (массивы, коллекции, ассоциативные массивы), разрешаются в пустые экземпляры, если нет подходящих бинов. Это позволяет использовать общий шаблон реализации, в котором все зависимости могут быть объявлены в уникальном многоаргументном конструкторе - например, объявлены как один публичный конструктор без аннотации @Autowired.

Как вариант, можно выразить необязательный характер конкретной зависимости с помощью java.util.Optional в Java 8, как показано в следующем примере:

public class SimpleMovieLister {
    @Autowired
    public void setMovieFinder(Optional<MovieFinder> movieFinder) {
        ...
    }
}

Начиная со Spring Framework 5.0, вы также можете использовать аннотацию @Nullable (любого типа в любом пакете, например, javax.annotation.Nullable из JSR-305) или просто использовать встроенную в Kotlin поддержку null-безопасности::

public class SimpleMovieLister {
    @Autowired
    public void setMovieFinder(@Nullable MovieFinder movieFinder) {
        ...
    }
}

class SimpleMovieLister {
    @Autowired
    var movieFinder: MovieFinder? = null
    // ...
}

Вы также можете использовать @Autowired для интерфейсов, которые являются известными разрешаемыми зависимостями: BeanFactory, ApplicationContext, Environment, ResourceLoader, ApplicationEventPublisher и MessageSource. Эти интерфейсы и их расширенные интерфейсы, такие как ConfigurableApplicationContext или ResourcePatternResolver, разрешаются автоматически, без необходимости специальной настройки. В следующем примере выполняется автоматический поиск и связывание объекта ApplicationContext:

public class MovieRecommender {
    @Autowired
    private ApplicationContext context;
    public MovieRecommender() {
    }
    // ...
}

class MovieRecommender {
    @Autowired
    lateinit var context: ApplicationContext
    // ...
}