summaryrefslogtreecommitdiff
path: root/java/rmi/activation/package.html
diff options
context:
space:
mode:
authorAudrius Meskauskas <audriusa@Bioinformatics.org>2006-03-12 16:34:26 +0000
committerAudrius Meskauskas <audriusa@Bioinformatics.org>2006-03-12 16:34:26 +0000
commit4512141db58f806fc1f955fddf7f0a81a8f2e4ca (patch)
tree3fbe49741a9e46ddb52a552f805ac174a16ed4c9 /java/rmi/activation/package.html
parentcd778749b76bfc3306376ec6d0b96f4afed4ecee (diff)
downloadclasspath-4512141db58f806fc1f955fddf7f0a81a8f2e4ca.tar.gz
2006-03-12 Audrius Meskauskas <AudriusA@Bioinformatics.org>
* java/rmi/activation/ActivationID.java (uid): New field. (writeExternal, readExternal): New methods. (equals, hashCode): Rewritten. * java/rmi/activation/ActivationInstantiator.java, * java/rmi/activation/ActivationSystem.java, * java/rmi/activation/Activator.java, * java/rmi/activation/Activatable.java, * java/rmi/activation/ActivationGroup.java, * java/rmi/activation/ActivationGroupDesc.java: Documented and autoformatted. * java/rmi/activation/package.html: Added content.
Diffstat (limited to 'java/rmi/activation/package.html')
-rw-r--r--java/rmi/activation/package.html24
1 files changed, 22 insertions, 2 deletions
diff --git a/java/rmi/activation/package.html b/java/rmi/activation/package.html
index 444782dd7..24e02f88b 100644
--- a/java/rmi/activation/package.html
+++ b/java/rmi/activation/package.html
@@ -1,6 +1,6 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!-- package.html - describes classes in java.rmi.activation package.
- Copyright (C) 2002 Free Software Foundation, Inc.
+ Copyright (C) 2002, 2006 Free Software Foundation, Inc.
This file is part of GNU Classpath.
@@ -40,7 +40,27 @@ exception statement from your version. -->
<head><title>GNU Classpath - java.rmi.activation</title></head>
<body>
-<p></p>
+In the previous Classpath releases, an instance of a UnicastRemoteObject
+could be accessed from a server that:
+<ul>
+<li>has created an instance of that object<li>
+<li>has been running <i>all<i> the time</li>
+</ul>
+Since the comming of the activation system, the object implementation can also
+be activated and executed on demand rather than running all time. The RMI client
+code for activatable objects is no different than the code for accessing
+non-activatable remote objects. Activation is a server-side implementation
+decision.
+In order for an object to be activated, the "activatable" object class
+(independently if it extends the {@link Activatable} class or not) defines a
+special public constructor that takes two arguments, its activation identifier
+({@link ActivationID}) and its activation data ({@link java.rmi.MarshalledObject}),
+supplied in the activation descriptor used during registration. When an
+activation group activates a remote object, it constructs the object via
+this special constructor. The remote object implementation may use the
+activation data to initialize itself in a needed manner. The remote object may
+also retain its activation identifier, so that it can inform the activation
+group when it becomes inactive (via a call to the Activatable.inactive method).
</body>
</html>