001    /**
002     Licensed to the Apache Software Foundation (ASF) under one or more
003     contributor license agreements.  See the NOTICE file distributed with
004     this work for additional information regarding copyright ownership.
005     The ASF licenses this file to You under the Apache License, Version 2.0
006     (the "License"); you may not use this file except in compliance with
007     the License.  You may obtain a copy of the License at
008    
009          http://www.apache.org/licenses/LICENSE-2.0
010    
011     Unless required by applicable law or agreed to in writing, software
012     distributed under the License is distributed on an "AS IS" BASIS,
013     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
014     See the License for the specific language governing permissions and
015     limitations under the License.
016    */
017    package org.apache.commons.inject.api.bind;
018    
019    import java.lang.annotation.Annotation;
020    
021    /**
022     * A binding builder, which allows to specify annotations, or annotation
023     * types as constraints, depending on which POJO's may, or may not be
024     * injected.
025     */
026    public interface IAnnotatedBindingBuilder<T> extends ILinkedBindingBuilder<T> {
027            /**
028             * Specifies, that the binding can only be used for injection, if a
029             * field is annotated with an {@link Annotation}, that equals the
030             * given. In general, this means that the annotation type, and all
031             * attributes are equal.
032             * @see Annotation#equals(Object)
033             */
034            ILinkedBindingBuilder<T> annotatedWith(Annotation pAnnotation);
035            /**
036             * Specifies, that the binding can only be used for injection, if a
037             * field is annotated with an {@link Annotation} of the given type.
038             */
039            ILinkedBindingBuilder<T> annotatedWith(Class<? extends Annotation> pAnnotation);
040    }