1 /*
2  * Copyright (C) 2009 Google Inc.
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 package com.google.inject;
18 
19 /**
20  * Injects dependencies into the fields and methods on instances of type {@code T}. Ignores the
21  * presence or absence of an injectable constructor.
22  *
23  * @param <T> type to inject members of
24  * @author crazybob@google.com (Bob Lee)
25  * @author jessewilson@google.com (Jesse Wilson)
26  * @since 2.0
27  */
28 public interface MembersInjector<T> {
29 
30   /**
31    * Injects dependencies into the fields and methods of {@code instance}. Ignores the presence or
32    * absence of an injectable constructor.
33    *
34    * <p>Whenever Guice creates an instance, it performs this injection automatically (after first
35    * performing constructor injection), so if you're able to let Guice create all your objects for
36    * you, you'll never need to use this method.
37    *
38    * @param instance to inject members on. May be {@code null}.
39    */
injectMembers(T instance)40   void injectMembers(T instance);
41 }
42