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

@@ -1,7 +1,7 @@
 /*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * 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,25 +28,26 @@
 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:
+ * 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 InvocationContext object as
- * defined by the Interceptors specification.</li>
- * <li>The method defined on an interceptor class MUST HAVE one of the
- * following signatures:
+ * <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,22 +56,22 @@
  * 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
+ * <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>
+ * <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
  */