001 /* $Id: DigesterLoaderHandlerFactory.java 992060 2010-09-02 19:09:47Z 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.annotations.DigesterLoaderHandler; 024 import org.apache.commons.digester.annotations.DigesterLoadingException; 025 026 /** 027 * An object capable of providing instances of {@link DigesterLoaderHandler}. 028 * 029 * @since 2.1 030 */ 031 public interface DigesterLoaderHandlerFactory { 032 033 /** 034 * Return an instance of the specified type. 035 * 036 * @param <L> 037 * @param type the class of the object to be returned. 038 * @return an instance of the specified class. 039 * @throws DigesterLoadingException if any error occurs while creating the 040 * {@code type} instance. 041 */ 042 <L extends DigesterLoaderHandler<? extends Annotation, ? extends AnnotatedElement>> L newInstance( 043 Class<L> type) throws DigesterLoadingException; 044 045 }