001// Copyright 2004, 2005 The Apache Software Foundation
002//
003// Licensed under the Apache License, Version 2.0 (the "License");
004// you may not use this file except in compliance with the License.
005// 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
010// distributed under the License is distributed on an "AS IS" BASIS,
011// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
012// See the License for the specific language governing permissions and
013// limitations under the License.
014
015package org.apache.tapestry.services;
016
017/**
018 * Starting with 4.0, copmonents do not always have a zero-args constructor; the enhanced subclass
019 * may take some parameters used to initialize instance variables. This interface represents a
020 * wrapper around a constructor and an array of parameters that can be used to stamp out new
021 * instances of a component.
022 * 
023 * @author Howard M. Lewis Ship
024 * @since 4.0
025 */
026public interface ComponentConstructor
027{
028    /**
029     * Requests that a new instance of the component.
030     */
031
032    public Object newInstance();
033
034    /**
035     * Returns the class actually instantiated (which may be an enhanced subclass).
036     */
037    public Class getComponentClass();
038}