01: /*
02: * Licensed to the Apache Software Foundation (ASF) under one
03: * or more contributor license agreements. See the NOTICE file
04: * distributed with this work for additional information
05: * regarding copyright ownership. The ASF licenses this file
06: * to you under the Apache License, Version 2.0 (the
07: * "License"); you may not use this file except in compliance
08: * with the License. You may obtain a copy of the License at
09: *
10: * http://www.apache.org/licenses/LICENSE-2.0
11: *
12: * Unless required by applicable law or agreed to in writing,
13: * software distributed under the License is distributed on an
14: * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15: * KIND, either express or implied. See the License for the
16: * specific language governing permissions and limitations
17: * under the License.
18: */
19:
20: package org.apache.myfaces.config.annotation;
21:
22: import java.lang.reflect.InvocationTargetException;
23:
24: import javax.naming.NamingException;
25:
26: /**
27: * Proposed interface to annotation service. An implementation of this class needs to know the appropriate classloader,
28: * dependencies to be injected, and lifecycle methods to be called.
29: *
30: * @version $Rev:$ $Date:$
31: */
32: public interface LifecycleProvider {
33:
34: /**
35: * Create an object of the class with the supplied name, inject dependencies as appropriate,
36: * and call a postContruct method as appropriate.
37: *
38: * @param className name of the class of the desired object
39: * @return a fully constructed, dependency-injected, and initialized object.
40: */
41: Object newInstance(String className) throws ClassNotFoundException,
42: IllegalAccessException, InstantiationException,
43: NamingException, InvocationTargetException;
44:
45: /**
46: * Take whatever steps are needed to shut down the object, including calling a preDestroy method.
47: *
48: * @param o object to shut down.
49: */
50: void destroyInstance(Object o) throws IllegalAccessException,
51: InvocationTargetException;
52: }
|