JDK-8026020 : update rmic tool page to reflect deprecation of static stub generation
  • Type: Enhancement
  • Component: docs
  • Sub-Component: tools
  • Affected Version: 8
  • Priority: P3
  • Status: Resolved
  • Resolution: Fixed
  • Submitted: 2013-10-08
  • Updated: 2013-11-05
  • Resolved: 2013-11-05
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 8
8Fixed
Related Reports
Relates :  
JDK-8023863 - deprecate support for statically-generated stubs from RMI (JRMP)
Description
Per JDK-8023863 (currently in progress) the generation of static stubs for RMI will be deprecated. The rmic tool page will need to be updated to reflect this.
Comments
Fixed. But we are not making forward statement about it being possibly removed in a future release.
05-11-2013
Expanded note from engineering: "Note: Support for static generation of Java Remote Method Protocol (JRMP) stubs and skeletons using this tool has been deprecated, and it may be removed in a future release of the platform. Oracle recommends that you use dynamically generated JRMP stubs instead, removing the need to use this tool for JRMP-based applications. See the java.rmi.server.UnicastRemoteObject specification for further information."
31-10-2013
Incorporating more suggestions from engineering...
31-10-2013
Deprecated as per FMW doc standards: "Note: Support for the Java Remote Method Protocol (JRMP) has been deprecated. Oracle recommends that you use the IIOP-related features of this tool instead." This note will appear in the following places: * After the term JRMP "skeleton" has been defined * At the end of the Description section * After each of the -vcompat, -v1.1, and -v1.2 options
31-10-2013
Fix understood as follows: * Only the RMI/JRMP portion of rmic is being deprecated. (The page fix is to add deprecated notes where they apply.) * There are no semantic or functional spec changes. * There are no new rmic options beyond what's already described. * All mention of "skeleton" classes can be left in place for now, but must be noted as deprecated. * Any subsequent text referencing skeletons can be left in place, since "skeleton" is still defined. * We will need to re-visit this doc in the future if/when skeleton support is removed from the tool. * In Description section: Vague mention of "a method" should be changed to the "dispatch" method, making it more meaningful to the user. * Options -vcompat, -v1.1, and -v1.2 will be noted as deprecated. Therefore, the fix simply involves adding "deprecated" notes in a number of places throughout the page.
30-10-2013
Sent first round of technical questions about rmic to Stuart.
22-10-2013
Management is currently discussing how to handle this bug. Wait until CCC's and spec changes have finalized, then document. Or document something in the short term and modify later along the way.
18-10-2013
Some background information from Stuart: "As I understand the history, rmic was originally developed for RMI/JRMP, and the CORBA/IIOP stuff was added later. The tool page shows that: it mainly assumes RMI/JRMP, with the description of CORBA/IIOP inserted at specific locations.Since we're deprecating the RMI/JRMP-related functions of rmic, it might make sense to refocus the page (or at least the main section) around CORBA/IIOP. That might require a bit of editing or rewriting."
18-10-2013
The rmic tool pages will be updated to indicate that statically generated stub support has been deprecated.
14-10-2013