001// *************************************************************************************************************************** 002// * Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file * 003// * distributed with this work for additional information regarding copyright ownership. The ASF licenses this file * 004// * to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance * 005// * with the License. You may obtain a copy of the License at * 006// * * 007// * http://www.apache.org/licenses/LICENSE-2.0 * 008// * * 009// * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an * 010// * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the * 011// * specific language governing permissions and limitations under the License. * 012// *************************************************************************************************************************** 013package org.apache.juneau; 014 015/** 016 * Class used to resolve {@link Class} objects to instances. 017 */ 018public interface ResourceResolver { 019 020 /** 021 * Look for constructors where the arguments passed in must match exactly. 022 */ 023 public static final ResourceResolver BASIC = new BasicResourceResolver(); 024 025 /** 026 * Look for constructors where arguments may or may not exist in any order. 027 */ 028 public static final ResourceResolver FUZZY = new FuzzyResourceResolver(); 029 030 /** 031 * Resolves the specified class to a resource object. 032 * 033 * <p> 034 * Subclasses can override this method to provide their own custom resolution. 035 * 036 * <p> 037 * The default implementation simply creates a new class instance using {@link Class#newInstance()}. 038 * 039 * @param parent 040 * The parent resource. 041 * @param c The class to resolve. 042 * @param args Optional arguments to pass to constructor 043 * @return The instance of that class. 044 */ 045 <T> T resolve(Object parent, Class<T> c, Object...args); 046}