001 /* $Id: AnnotationRuleProviderFactory.java 992719 2010-09-05 07:49:25Z simonetripodi $ 002 * 003 * Licensed to the Apache Software Foundation (ASF) under one or more 004 * contributor license agreements. See the NOTICE file distributed with 005 * this work for additional information regarding copyright ownership. 006 * The ASF licenses this file to You under the Apache License, Version 2.0 007 * (the "License"); you may not use this file except in compliance with 008 * the License. You may obtain a copy of the License at 009 * 010 * http://www.apache.org/licenses/LICENSE-2.0 011 * 012 * Unless required by applicable law or agreed to in writing, software 013 * distributed under the License is distributed on an "AS IS" BASIS, 014 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 015 * See the License for the specific language governing permissions and 016 * limitations under the License. 017 */ 018 package org.apache.commons.digester.annotations.spi; 019 020 import java.lang.annotation.Annotation; 021 import java.lang.reflect.AnnotatedElement; 022 023 import org.apache.commons.digester.Rule; 024 import org.apache.commons.digester.annotations.AnnotationRuleProvider; 025 import org.apache.commons.digester.annotations.DigesterLoadingException; 026 027 /** 028 * An object capable of providing instances of {@link AnnotationRuleProvider}. 029 * 030 * @since 2.1 031 */ 032 public interface AnnotationRuleProviderFactory { 033 034 /** 035 * Return an {@link AnnotationRuleProvider} instance of the specified type. 036 * 037 * @param <T> the {@link AnnotationRuleProvider} type. 038 * @param type the class of the object to be returned. 039 * @return an instance of the specified class. 040 * @throws DigesterLoadingException if any error occurs while creating the 041 * {@code type} instance. 042 */ 043 <T extends AnnotationRuleProvider<? extends Annotation, ? extends AnnotatedElement, ? extends Rule>> 044 T newInstance(Class<T> type) throws DigesterLoadingException; 045 046 }