--- old/jaxws/src/java.xml.ws.annotation/share/classes/javax/annotation/Resource.java 2017-02-14 14:25:14.892033157 +0300
+++ new/jaxws/src/java.xml.ws.annotation/share/classes/javax/annotation/Resource.java 2017-02-14 14:25:14.796032543 +0300
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2013, 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
@@ -30,7 +30,7 @@
import static java.lang.annotation.RetentionPolicy.*;
/**
- * The Resource annotation marks a resource that is needed
+ * The Resource
annotation marks a resource that is needed
* by the application. This annotation may be applied to an
* application component class, or to fields or methods of the
* component class. When the annotation is applied to a
@@ -38,20 +38,21 @@
* of the requested resource into the application component
* when the component is initialized. If the annotation is
* applied to the component class, the annotation declares a
- * resource that the application will look up at runtime.
- * - * Even though this annotation is not marked Inherited, deployment + * resource that the application will look up at runtime. + *
+ * Even though this annotation is not marked Inherited
, deployment
* tools are required to examine all superclasses of any component
* class to discover all uses of this annotation in all superclasses.
* All such annotation instances specify resources that are needed
* by the application component. Note that this annotation may
* appear on private fields and methods of superclasses; the container
- * is required to perform injection in these cases as well.
+ * is required to perform injection in these cases as well.
name
- * element or defaulted, is a name that is local to the application
- * component using the resource. (It's a name in the JNDI
- * java:comp/env
namespace.) Many application servers
- * provide a way to map these local names to names of resources
- * known to the application server. This mapped name is often a
- * global JNDI name, but may be a name of any form.
- *
- * Application servers are not required to support any particular
+ * A product-specific name that this resource should be mapped to.
+ * The mappedName
element provides for mapping the
+ * resource reference to the name of a resource known to the
+ * applicaiton server. The mapped name could be of any form.
+ *
Application servers are not required to support any particular * form or type of mapped name, nor the ability to use mapped names. * The mapped name is product-dependent and often installation-dependent. - * No use of a mapped name is portable. + * No use of a mapped name is portable.
*/ String mappedName() default "";