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 * <ul> 43 * <li>The method MUST NOT have any parameters except in the case of 44 * interceptors in which case it takes an InvocationContext object as 45 * defined by the Interceptors specification.</li> 46 * <li>The method defined on an interceptor class MUST HAVE one of the 47 * following signatures: 48 * <p> 49 * void <METHOD>(InvocationContext) 50 * <p> 51 * Object <METHOD>(InvocationContext) throws Exception 52 * <p> 53 * <i>Note: A PostConstruct interceptor method must not throw application 54 * exceptions, but it may be declared to throw checked exceptions including 55 * the java.lang.Exception if the same interceptor method interposes on 56 * business or timeout methods in addition to lifecycle events. If a 57 * PostConstruct interceptor method returns a value, it is ignored by 58 * the container.</i> 59 * </li> 60 * <li>The method defined on a non-interceptor class MUST HAVE the 61 * following signature: 62 * <p> 63 * void <METHOD>() 64 * </li> 65 * <li>The method on which PostConstruct is applied MAY be public, protected, 66 * package private or private.</li> 67 * <li>The method MUST NOT be static except for the application client.</li> 68 * <li>The method MAY be final.</li> 69 * <li>If the method throws an unchecked exception the class MUST NOT be put into 70 * service except in the case of EJBs where the EJB can handle exceptions and 71 * even recover from them.</li></ul> 72 * 73 * @see javax.annotation.PreDestroy 74 * @see javax.annotation.Resource 75 * @since 1.6, Common Annotations 1.0 76 */ 77 @Documented 78 @Retention (RUNTIME) 79 @Target(METHOD) 80 public @interface PostConstruct { 81 }