jdk/src/share/classes/java/rmi/server/package.html
author smarks
Wed, 30 Oct 2013 18:39:09 -0700
changeset 21421 aadfbd8b351b
parent 21359 2d32ce9ea2b4
child 24865 09b1d992ca72
permissions -rw-r--r--
8023863: deprecate support for statically-generated stubs from RMI (JRMP) 4449028: exportObject() javadoc should specify behavior for null socket factories Reviewed-by: dfuchs, darcy
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
     1
<!--
21359
2d32ce9ea2b4 8023862: deprecate HTTP proxying from RMI
smarks
parents: 5506
diff changeset
     2
 Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
     3
 DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
90ce3da70b43 Initial load
duke
parents:
diff changeset
     4
90ce3da70b43 Initial load
duke
parents:
diff changeset
     5
 This code is free software; you can redistribute it and/or modify it
90ce3da70b43 Initial load
duke
parents:
diff changeset
     6
 under the terms of the GNU General Public License version 2 only, as
5506
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 2
diff changeset
     7
 published by the Free Software Foundation.  Oracle designates this
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
     8
 particular file as subject to the "Classpath" exception as provided
5506
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 2
diff changeset
     9
 by Oracle in the LICENSE file that accompanied this code.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    10
90ce3da70b43 Initial load
duke
parents:
diff changeset
    11
 This code is distributed in the hope that it will be useful, but WITHOUT
90ce3da70b43 Initial load
duke
parents:
diff changeset
    12
 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
90ce3da70b43 Initial load
duke
parents:
diff changeset
    13
 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
90ce3da70b43 Initial load
duke
parents:
diff changeset
    14
 version 2 for more details (a copy is included in the LICENSE file that
90ce3da70b43 Initial load
duke
parents:
diff changeset
    15
 accompanied this code).
90ce3da70b43 Initial load
duke
parents:
diff changeset
    16
90ce3da70b43 Initial load
duke
parents:
diff changeset
    17
 You should have received a copy of the GNU General Public License version
90ce3da70b43 Initial load
duke
parents:
diff changeset
    18
 2 along with this work; if not, write to the Free Software Foundation,
90ce3da70b43 Initial load
duke
parents:
diff changeset
    19
 Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    20
5506
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 2
diff changeset
    21
 Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 2
diff changeset
    22
 or visit www.oracle.com if you need additional information or have any
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 2
diff changeset
    23
 questions.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    24
-->
90ce3da70b43 Initial load
duke
parents:
diff changeset
    25
90ce3da70b43 Initial load
duke
parents:
diff changeset
    26
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
90ce3da70b43 Initial load
duke
parents:
diff changeset
    27
<html>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    28
<body bgcolor="white">
90ce3da70b43 Initial load
duke
parents:
diff changeset
    29
90ce3da70b43 Initial load
duke
parents:
diff changeset
    30
Provides classes and interfaces for supporting the server
90ce3da70b43 Initial load
duke
parents:
diff changeset
    31
side of RMI.  A group of classes are used by the stubs and skeletons
90ce3da70b43 Initial load
duke
parents:
diff changeset
    32
generated by the rmic stub compiler.  Another group of classes
90ce3da70b43 Initial load
duke
parents:
diff changeset
    33
implements the RMI Transport protocol and HTTP tunneling.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    34
21359
2d32ce9ea2b4 8023862: deprecate HTTP proxying from RMI
smarks
parents: 5506
diff changeset
    35
<p><strong>Deprecated: HTTP Tunneling.</strong> <em>The HTTP tunneling
2d32ce9ea2b4 8023862: deprecate HTTP proxying from RMI
smarks
parents: 5506
diff changeset
    36
mechanism has been deprecated. See {@link java.rmi.server.RMISocketFactory} for
2d32ce9ea2b4 8023862: deprecate HTTP proxying from RMI
smarks
parents: 5506
diff changeset
    37
further information.</em>
2d32ce9ea2b4 8023862: deprecate HTTP proxying from RMI
smarks
parents: 5506
diff changeset
    38
21421
aadfbd8b351b 8023863: deprecate support for statically-generated stubs from RMI (JRMP)
smarks
parents: 21359
diff changeset
    39
<p><strong>Deprecated: Skeletons and Static Stubs.</strong>
aadfbd8b351b 8023863: deprecate support for statically-generated stubs from RMI (JRMP)
smarks
parents: 21359
diff changeset
    40
aadfbd8b351b 8023863: deprecate support for statically-generated stubs from RMI (JRMP)
smarks
parents: 21359
diff changeset
    41
<em>Skeletons and statically generated stubs are deprecated.  This
aadfbd8b351b 8023863: deprecate support for statically-generated stubs from RMI (JRMP)
smarks
parents: 21359
diff changeset
    42
includes the APIs in this package that require the use of skeletons
aadfbd8b351b 8023863: deprecate support for statically-generated stubs from RMI (JRMP)
smarks
parents: 21359
diff changeset
    43
or static stubs, the runtime support for them, and the use of the
aadfbd8b351b 8023863: deprecate support for statically-generated stubs from RMI (JRMP)
smarks
parents: 21359
diff changeset
    44
{@code rmic} stub compiler to generate them.  Support for skeletons
aadfbd8b351b 8023863: deprecate support for statically-generated stubs from RMI (JRMP)
smarks
parents: 21359
diff changeset
    45
and static stubs may be removed in a future release of the
aadfbd8b351b 8023863: deprecate support for statically-generated stubs from RMI (JRMP)
smarks
parents: 21359
diff changeset
    46
platform. Skeletons are unnecessary, as server-side method dispatching
aadfbd8b351b 8023863: deprecate support for statically-generated stubs from RMI (JRMP)
smarks
parents: 21359
diff changeset
    47
is handled directly by the RMI runtime. Statically generated stubs are
aadfbd8b351b 8023863: deprecate support for statically-generated stubs from RMI (JRMP)
smarks
parents: 21359
diff changeset
    48
unnecessary, as stubs are generated dynamically using {@link
aadfbd8b351b 8023863: deprecate support for statically-generated stubs from RMI (JRMP)
smarks
parents: 21359
diff changeset
    49
java.lang.reflect.Proxy Proxy} objects. See {@link
aadfbd8b351b 8023863: deprecate support for statically-generated stubs from RMI (JRMP)
smarks
parents: 21359
diff changeset
    50
java.rmi.server.UnicastRemoteObject UnicastRemoteObject} for
aadfbd8b351b 8023863: deprecate support for statically-generated stubs from RMI (JRMP)
smarks
parents: 21359
diff changeset
    51
information about dynamic stub generation. Generation of skeletons and
aadfbd8b351b 8023863: deprecate support for statically-generated stubs from RMI (JRMP)
smarks
parents: 21359
diff changeset
    52
static stubs was typically performed as part of an application's build
aadfbd8b351b 8023863: deprecate support for statically-generated stubs from RMI (JRMP)
smarks
parents: 21359
diff changeset
    53
process by calling the {@code rmic} tool. This is unnecessary, and
aadfbd8b351b 8023863: deprecate support for statically-generated stubs from RMI (JRMP)
smarks
parents: 21359
diff changeset
    54
calls to {@code rmic} can simply be omitted.</em>
aadfbd8b351b 8023863: deprecate support for statically-generated stubs from RMI (JRMP)
smarks
parents: 21359
diff changeset
    55
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    56
<!--
90ce3da70b43 Initial load
duke
parents:
diff changeset
    57
<h2>Package Specification</h2>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    58
90ce3da70b43 Initial load
duke
parents:
diff changeset
    59
##### FILL IN ANY SPECS NEEDED BY JAVA COMPATIBILITY KIT #####
90ce3da70b43 Initial load
duke
parents:
diff changeset
    60
<ul>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    61
  <li><a href="">##### REFER TO ANY FRAMEMAKER SPECIFICATION HERE #####</a>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    62
</ul>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    63
90ce3da70b43 Initial load
duke
parents:
diff changeset
    64
<h2>Related Documentation</h2>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    65
90ce3da70b43 Initial load
duke
parents:
diff changeset
    66
For overviews, tutorials, examples, guides, and tool documentation, please see:
90ce3da70b43 Initial load
duke
parents:
diff changeset
    67
<ul>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    68
  <li><a href="">##### REFER TO NON-SPEC DOCUMENTATION HERE #####</a>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    69
</ul>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    70
-->
90ce3da70b43 Initial load
duke
parents:
diff changeset
    71
90ce3da70b43 Initial load
duke
parents:
diff changeset
    72
@since JDK1.1
90ce3da70b43 Initial load
duke
parents:
diff changeset
    73
</body>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    74
</html>