1 /* 2 * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 package javax.annotation; 27 28 import java.lang.annotation.*; 29 import static java.lang.annotation.ElementType.*; 30 import static java.lang.annotation.RetentionPolicy.*; 31 32 /** 33 * The PostConstruct annotation is used on a method that needs to be executed 34 * after dependency injection is done to perform any initialization. This 35 * method MUST be invoked before the class is put into service. This 36 * annotation MUST be supported on all classes that support dependency 37 * injection. The method annotated with PostConstruct MUST be invoked even 38 * if the class does not request any resources to be injected. Only one 39 * method can be annotated with this annotation. The method on which the 40 * PostConstruct annotation is applied MUST fulfill all of the following 41 * criteria: 42 * <p> 43 * <ul> 44 * <li>The method MUST NOT have any parameters except in the case of 45 * interceptors in which case it takes an InvocationContext object as 46 * defined by the Interceptors specification.</li> 47 * <li>The method defined on an interceptor class MUST HAVE one of the 48 * following signatures: 49 * <p> 50 * void <METHOD>(InvocationContext) 51 * <p> 52 * Object <METHOD>(InvocationContext) throws Exception 53 * <p> 54 * <i>Note: A PostConstruct interceptor method must not throw application 55 * exceptions, but it may be declared to throw checked exceptions including 56 * the java.lang.Exception if the same interceptor method interposes on 57 * business or timeout methods in addition to lifecycle events. If a 58 * PostConstruct interceptor method returns a value, it is ignored by 59 * the container.</i> 60 * </li> 61 * <li>The method defined on a non-interceptor class MUST HAVE the 62 * following signature: 63 * <p> 64 * void <METHOD>() 65 * </li> 66 * <li>The method on which PostConstruct is applied MAY be public, protected, 67 * package private or private.</li> 68 * <li>The method MUST NOT be static except for the application client.</li> 69 * <li>The method MAY be final.</li> 70 * <li>If the method throws an unchecked exception the class MUST NOT be put into 71 * service except in the case of EJBs where the EJB can handle exceptions and 72 * even recover from them.</li></ul> 73 * 74 * @see javax.annotation.PreDestroy 75 * @see javax.annotation.Resource 76 * @since 1.6, Common Annotations 1.0 77 */ 78 @Documented 79 @Retention (RUNTIME) 80 @Target(METHOD) 81 public @interface PostConstruct { 82 }