01 /*
02 * Copyright 2008-2014 the original author or authors.
03 *
04 * Licensed under the Apache License, Version 2.0 (the "License");
05 * you may not use this file except in compliance with the License.
06 * You may obtain a copy of the License at
07 *
08 * http://www.apache.org/licenses/LICENSE-2.0
09 *
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 package griffon.core.injection;
17
18 import griffon.exceptions.InstanceNotFoundException;
19 import griffon.exceptions.MembersInjectionException;
20
21 import javax.annotation.Nonnull;
22 import java.lang.annotation.Annotation;
23 import java.util.Collection;
24
25 /**
26 * @author Andres Almiray
27 * @since 2.0.0
28 */
29 public interface Injector<I> {
30 @Nonnull
31 <T> T getInstance(@Nonnull Class<T> type) throws InstanceNotFoundException;
32
33 @Nonnull
34 <T> T getInstance(@Nonnull Class<T> type, @Nonnull Annotation qualifier) throws InstanceNotFoundException;
35
36 @Nonnull
37 <T> Collection<T> getInstances(@Nonnull Class<T> type) throws InstanceNotFoundException;
38
39 @Nonnull
40 <T> Collection<Qualified<T>> getQualifiedInstances(@Nonnull Class<T> type) throws InstanceNotFoundException;
41
42 void injectMembers(@Nonnull Object instance) throws MembersInjectionException;
43
44 @Nonnull
45 I getDelegateInjector();
46
47 @Nonnull
48 Injector<I> createNestedInjector(@Nonnull Iterable<Binding<?>> bindings);
49
50 @Nonnull
51 Injector<I> createNestedInjector(@Nonnull String name, @Nonnull Iterable<Binding<?>> bindings);
52
53 void close();
54 }
|