You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by ma...@apache.org on 2016/02/01 12:07:20 UTC

svn commit: r1727917 - in /tomcat/trunk: java/org/apache/catalina/core/StandardContext.java java/org/apache/catalina/core/StandardWrapper.java java/org/apache/catalina/core/mbeans-descriptors.xml webapps/docs/funcspecs/mbean-names.xml

Author: markt
Date: Mon Feb  1 11:07:20 2016
New Revision: 1727917

URL: http://svn.apache.org/viewvc?rev=1727917&view=rev
Log:
Deprecate what is left of the JSR-77 implementation.

Modified:
    tomcat/trunk/java/org/apache/catalina/core/StandardContext.java
    tomcat/trunk/java/org/apache/catalina/core/StandardWrapper.java
    tomcat/trunk/java/org/apache/catalina/core/mbeans-descriptors.xml
    tomcat/trunk/webapps/docs/funcspecs/mbean-names.xml

Modified: tomcat/trunk/java/org/apache/catalina/core/StandardContext.java
URL: http://svn.apache.org/viewvc/tomcat/trunk/java/org/apache/catalina/core/StandardContext.java?rev=1727917&r1=1727916&r2=1727917&view=diff
==============================================================================
--- tomcat/trunk/java/org/apache/catalina/core/StandardContext.java (original)
+++ tomcat/trunk/java/org/apache/catalina/core/StandardContext.java Mon Feb  1 11:07:20 2016
@@ -6203,7 +6203,11 @@ public class StandardContext extends Con
      * JSR77 deploymentDescriptor attribute
      *
      * @return string deployment descriptor
+     *
+     * @deprecated The JSR-77 implementation is incomplete and will be removed
+     *             in 9.0.x
      */
+    @Deprecated
     public String getDeploymentDescriptor() {
 
         InputStream stream = null;
@@ -6234,7 +6238,11 @@ public class StandardContext extends Con
      * JSR77 servlets attribute
      *
      * @return list of all servlets ( we know about )
+     *
+     * @deprecated The JSR-77 implementation is incomplete and will be removed
+     *             in 9.0.x
      */
+    @Deprecated
     public String[] getServlets() {
 
         String[] result = null;
@@ -6448,7 +6456,11 @@ public class StandardContext extends Con
 
     /**
      * @return support for "stateManageable" JSR77
+     *
+     * @deprecated The JSR-77 implementation is incomplete and will be removed
+     *             in 9.0.x
      */
+    @Deprecated
     public boolean isStateManageable() {
         return true;
     }

Modified: tomcat/trunk/java/org/apache/catalina/core/StandardWrapper.java
URL: http://svn.apache.org/viewvc/tomcat/trunk/java/org/apache/catalina/core/StandardWrapper.java?rev=1727917&r1=1727916&r2=1727917&view=diff
==============================================================================
--- tomcat/trunk/java/org/apache/catalina/core/StandardWrapper.java (original)
+++ tomcat/trunk/java/org/apache/catalina/core/StandardWrapper.java Mon Feb  1 11:07:20 2016
@@ -1787,7 +1787,11 @@ public class StandardWrapper extends Con
 
     /**
      * @return JSR 77. Always return <code>false</code>.
+     *
+     * @deprecated The JSR-77 implementation is incomplete and will be removed
+     *             in 9.0.x
      */
+    @Deprecated
     public boolean isStateManageable() {
         return false;
     }

Modified: tomcat/trunk/java/org/apache/catalina/core/mbeans-descriptors.xml
URL: http://svn.apache.org/viewvc/tomcat/trunk/java/org/apache/catalina/core/mbeans-descriptors.xml?rev=1727917&r1=1727916&r2=1727917&view=diff
==============================================================================
--- tomcat/trunk/java/org/apache/catalina/core/mbeans-descriptors.xml (original)
+++ tomcat/trunk/java/org/apache/catalina/core/mbeans-descriptors.xml Mon Feb  1 11:07:20 2016
@@ -270,7 +270,7 @@
                type="java.lang.String"/>
 
     <attribute name="servlets"
-               description="JSR77 list of servlets"
+               description="Deprecated. JSR77 list of servlets"
                type="[Ljava.lang.String;"
                writeable="false"/>
 
@@ -300,7 +300,7 @@
                type="long"/>
 
     <attribute name="stateManageable"
-               description="State management support for this managed object"
+               description="Deprecated. State management support for this managed object"
                is="true"
                type="boolean"
                writeable="false" />

Modified: tomcat/trunk/webapps/docs/funcspecs/mbean-names.xml
URL: http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/funcspecs/mbean-names.xml?rev=1727917&r1=1727916&r2=1727917&view=diff
==============================================================================
--- tomcat/trunk/webapps/docs/funcspecs/mbean-names.xml (original)
+++ tomcat/trunk/webapps/docs/funcspecs/mbean-names.xml Mon Feb  1 11:07:20 2016
@@ -39,15 +39,14 @@
     <p>We will be using <em>JMX MBeans</em> as the technology for
     implementing manageability of Tomcat.</p>
 
-    <p>One of the key concepts of JMX (and JSR-77) is that each management
-    bean has a unique name in the MBeanServer's registry, and that
-    management applications can utilize these names to retrieve the MBean
-    of interest to them for a particular management operation.
-    This document proposes a naming convention for MBeans that allows easy
-    calculation of the name for a particular MBean.  For background
-    information on JMX MBean names, see the <em>Java Management Extensions
-    Instrumentation and Agent Specification</em>, version 1.0, section 6.
-    In particular, we will be discussing the String Representation of
+    <p>One of the key concepts of JMX is that each management bean has a uniqu
+    name in the MBeanServer's registry, and that management applications can
+    utilize these names to retrieve the MBean of interest to them for a
+    particular management operation. This document proposes a naming convention
+    for MBeans that allows easy calculation of the name for a particular MBean.
+    For background information on JMX MBean names, see the <em>Java Management
+    Extensions Instrumentation and Agent Specification</em>, version 1.0,
+    section 6. In particular, we will be discussing the String Representation of
     <code>ObjectName</code> instances.</p>
 
 </section>
@@ -662,53 +661,6 @@ web application for Tomcat):</p>
   </tr>
 
 </table>
-
-</section>
-
-<section name="JSR-77 Cross Reference">
-
-<p>The managed objects in the JSR-77 object hierarchy correspond
-to the specified MBean names or groups as follows:</p>
-
-<table class="defaultTable">
-
-  <tr>
-    <th>JSR-77 Managed Object</th>
-    <th>MBean Name or Group</th>
-    <th>Comments</th>
-  </tr>
-
-  <tr>
-    <td><code class="noHighlight">J2EEServer</code></td>
-    <td><code class="noHighlight">${SERVICE}</code></td>
-    <td></td>
-  </tr>
-
-  <tr>
-    <td><code class="noHighlight">Node</code></td>
-    <td><code class="noHighlight">${SERVICE}</code></td>
-    <td>Tomcat supports a single node only.</td>
-  </tr>
-
-  <tr>
-    <td><code class="noHighlight">Port</code></td>
-    <td><code class="noHighlight">${CONNECTOR}</code></td>
-    <td></td>
-  </tr>
-
-  <tr>
-    <td><code class="noHighlight">Servlet</code></td>
-    <td><code class="noHighlight">${WRAPPER}</code></td>
-    <td></td>
-  </tr>
-
-  <tr>
-    <td><code class="noHighlight">WebModule</code></td>
-    <td><code class="noHighlight">${CONTEXT}</code></td>
-    <td></td>
-  </tr>
-
-</table>
 
 </section>
 



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org