001 /*
002 * ============================================================================
003 * GNU Lesser General Public License
004 * ============================================================================
005 *
006 * Beanlet - JSE Application Container.
007 * Copyright (C) 2006 Leon van Zantvoort
008 *
009 * This library is free software; you can redistribute it and/or
010 * modify it under the terms of the GNU Lesser General Public
011 * License as published by the Free Software Foundation; either
012 * version 2.1 of the License, or (at your option) any later version.
013 *
014 * This library is distributed in the hope that it will be useful,
015 * but WITHOUT ANY WARRANTY; without even the implied warranty of
016 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
017 * Lesser General Public License for more details.
018 *
019 * You should have received a copy of the GNU Lesser General Public
020 * License along with this library; if not, write to the Free Software
021 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
022 *
023 * Leon van Zantvoort
024 * 243 Acalanes Drive #11
025 * Sunnyvale, CA 94086
026 * USA
027 *
028 * zantvoort@users.sourceforge.net
029 * http://beanlet.org
030 */
031 package org.beanlet;
032
033 import java.lang.annotation.ElementType;
034 import java.lang.annotation.Retention;
035 import java.lang.annotation.RetentionPolicy;
036 import java.lang.annotation.Target;
037
038 /**
039 * <p>The {@code PostConstruct} annotation is used on a method that needs to be
040 * executed after dependency injection is done to perform any initialization.
041 * Such methods are so-called post construct methods. This annotation is
042 * also supported for interceptor methods, further referred to as
043 * post-construct lifecycle methods.</p>
044 *
045 * <p>{@code PostConstruct} methods are invoked by the container before
046 * beanlet instances are put into service. The post-construct method is
047 * called even if the class does not request any resources to be injected.
048 * The beanlet instance is not put into service if an exception is thrown by
049 * this method.</p>
050 *
051 * <p><h3>Method Constraints</h3>
052 * Only one method can be marked with this annotation. The method on which the
053 * {@code PostConstruct} annotation is applied MUST fulfill all of the following
054 * criteria:
055 * <ul>
056 * <li>The method MUST NOT have any parameters except in the case of
057 * interceptors in which case it MUST take an {@code InterceptorContext} object.
058 * <li>The method MAY return any type.
059 * <li>The method MAY throw a checked exception.
060 * <li>The method on which {@code PostConstruct} is applied MAY be
061 * {@code public}, {@code protected}, package private or {@code private}.
062 * <li>The method MUST NOT be {@code static}.
063 * <li>The method MAY be {@code final}.
064 * </ul>
065 *
066 * {@beanlet.annotation}
067 *
068 * @author Leon van Zantvoort
069 */
070 @Retention(RetentionPolicy.RUNTIME)
071 @Target({ElementType.METHOD})
072 public @interface PostConstruct {
073
074 }