jaxws/src/java.xml.ws.annotation/share/classes/javax/annotation/PostConstruct.java

*** 1,7 ****
  /*
!  * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
--- 1,7 ----
  /*
!  * Copyright (c) 2005, 2017, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
*** 28,52 ****
  import java.lang.annotation.*;
  import static java.lang.annotation.ElementType.*;
  import static java.lang.annotation.RetentionPolicy.*;
  
  /**
!  * The PostConstruct annotation is used on a method that needs to be executed
!  * after dependency injection is done to perform any initialization. This
!  * method MUST be invoked before the class is put into service. This
!  * annotation MUST be supported on all classes that support dependency
!  * injection. The method annotated with PostConstruct MUST be invoked even
!  * if the class does not request any resources to be injected. Only one
!  * method can be annotated with this annotation. The method on which the
!  * PostConstruct annotation is applied MUST fulfill all of the following
!  * criteria:
   * <ul>
!  * <li>The method MUST NOT have any parameters except in the case of
!  * interceptors in which case it takes an InvocationContext object as
!  * defined by the Interceptors specification.</li>
!  * <li>The method defined on an interceptor class MUST HAVE one of the
!  * following signatures:
   * <p>
   * void <METHOD>(InvocationContext)
   * <p>
   * Object <METHOD>(InvocationContext) throws Exception
   * <p>
--- 28,53 ----
  import java.lang.annotation.*;
  import static java.lang.annotation.ElementType.*;
  import static java.lang.annotation.RetentionPolicy.*;
  
  /**
!  * The <code>PostConstruct</code> annotation is used on a method that
!  * needs to be executed after dependency injection is done to perform
!  * any initialization. This  method must be invoked before the class
!  * is put into service. This annotation must be supported on all classes
!  * that support dependency injection. The method annotated with
!  * <code>PostConstruct</code> must be invoked even if the class does
!  * not request any resources to be injected. Only one
!  * method in a given class can be annotated with this annotation.
!  * The method on which the <code>PostConstruct</code> annotation is
!  * applied must fulfill all of the following criteria:
   * <ul>
!  * <li>The method must not have any parameters except in the case of
!  * interceptors in which case it takes an <code>InvocationContext</code>
!  * object as defined by the Interceptors specification.</li>
!  * <li>The method defined on an interceptor class or superclass of an
!  * interceptor class must have one of the following signatures:
   * <p>
   * void <METHOD>(InvocationContext)
   * <p>
   * Object <METHOD>(InvocationContext) throws Exception
   * <p>
*** 55,76 ****
   * the java.lang.Exception if the same interceptor method interposes on
   * business or timeout methods in addition to lifecycle events. If a
   * PostConstruct interceptor method returns a value, it is ignored by
   * the container.</i>
   * </li>
!  * <li>The method defined on a non-interceptor class MUST HAVE the
   * following signature:
   * <p>
   * void <METHOD>()
   * </li>
!  * <li>The method on which PostConstruct is applied MAY be public, protected,
!  * package private or private.</li>
!  * <li>The method MUST NOT be static except for the application client.</li>
!  * <li>The method MAY be final.</li>
!  * <li>If the method throws an unchecked exception the class MUST NOT be put into
!  * service except in the case of EJBs where the EJB can handle exceptions and
!  * even recover from them.</li></ul>
   *
   * @see javax.annotation.PreDestroy
   * @see javax.annotation.Resource
   * @since 1.6, Common Annotations 1.0
   */
--- 56,77 ----
   * the java.lang.Exception if the same interceptor method interposes on
   * business or timeout methods in addition to lifecycle events. If a
   * PostConstruct interceptor method returns a value, it is ignored by
   * the container.</i>
   * </li>
!  * <li>The method defined on a non-interceptor class must have the
   * following signature:
   * <p>
   * void <METHOD>()
   * </li>
!  * <li>The method on which the <code>PostConstruct</code> annotation
!  * is applied may be public, protected, package private or private.</li>
!  * <li>The method must not be static except for the application client.</li>
!  * <li>The method should not be final.</li>
!  * <li>If the method throws an unchecked exception the class must not be put into
!  * service except in the case where the exception is handled by an
!  * interceptor.</li></ul>
   *
   * @see javax.annotation.PreDestroy
   * @see javax.annotation.Resource
   * @since 1.6, Common Annotations 1.0
   */