Home | History | Annotate | Download | only in inject
      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  *
     25  * @author crazybob (at) google.com (Bob Lee)
     26  * @author jessewilson (at) google.com (Jesse Wilson)
     27  * @since 2.0
     28  */
     29 public interface MembersInjector<T> {
     30 
     31   /**
     32    * Injects dependencies into the fields and methods of {@code instance}. Ignores the presence or
     33    * absence of an injectable constructor.
     34    *
     35    * <p>Whenever Guice creates an instance, it performs this injection automatically (after first
     36    * performing constructor injection), so if you're able to let Guice create all your objects for
     37    * you, you'll never need to use this method.
     38    *
     39    * @param instance to inject members on. May be {@code null}.
     40    */
     41   void injectMembers(T instance);
     42 }
     43