Injector.java
01 /*
02  * SPDX-License-Identifier: Apache-2.0
03  *
04  * Copyright 2008-2017 the original author or authors.
05  *
06  * Licensed under the Apache License, Version 2.0 (the "License");
07  * you may not use this file except in compliance with the License.
08  * You may obtain a copy of the License at
09  *
10  *     http://www.apache.org/licenses/LICENSE-2.0
11  *
12  * Unless required by applicable law or agreed to in writing, software
13  * distributed under the License is distributed on an "AS IS" BASIS,
14  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15  * See the License for the specific language governing permissions and
16  * limitations under the License.
17  */
18 package griffon.core.injection;
19 
20 import griffon.exceptions.InstanceNotFoundException;
21 import griffon.exceptions.MembersInjectionException;
22 
23 import javax.annotation.Nonnull;
24 import java.lang.annotation.Annotation;
25 import java.util.Collection;
26 
27 /**
28  @author Andres Almiray
29  @since 2.0.0
30  */
31 public interface Injector<I> {
32     @Nonnull
33     <T> T getInstance(@Nonnull Class<T> typethrows InstanceNotFoundException;
34 
35     @Nonnull
36     <T> T getInstance(@Nonnull Class<T> type, @Nonnull Annotation qualifierthrows InstanceNotFoundException;
37 
38     @Nonnull
39     <T> Collection<T> getInstances(@Nonnull Class<T> typethrows InstanceNotFoundException;
40 
41     @Nonnull
42     <T> Collection<Qualified<T>> getQualifiedInstances(@Nonnull Class<T> typethrows InstanceNotFoundException;
43 
44     void injectMembers(@Nonnull Object instancethrows MembersInjectionException;
45 
46     @Nonnull
47     I getDelegateInjector();
48 
49     void release(@Nonnull Object instance);
50 
51     void close();
52 }