java.applet

java.awt

java.awt.color

java.awt.datatransfer

java.awt.dnd

java.awt.event

java.awt.font

java.awt.geom

java.awt.im

java.awt.im.spi

java.awt.image

java.awt.image.renderable

java.awt.print

java.beans

java.beans.beancontext

java.io

java.lang

java.lang.annotation

java.lang.instrument

java.lang.management

java.lang.ref

java.lang.reflect

java.math

java.net

java.nio

java.nio.channels

java.nio.channels.spi

java.nio.charset

java.nio.charset.spi

java.rmi

java.rmi.activation

java.rmi.dgc

java.rmi.registry

java.rmi.server

java.security

java.security.acl

java.security.cert

java.security.interfaces

java.security.spec

java.sql

java.text

java.util

java.util.concurrent

java.util.concurrent.atomic

java.util.concurrent.locks

java.util.jar

java.util.logging

java.util.prefs

java.util.regex

java.util.zip

javax.accessibility

javax.activity

javax.crypto

javax.crypto.interfaces

javax.crypto.spec

javax.imageio

javax.imageio.event

javax.imageio.metadata

javax.imageio.plugins.bmp

javax.imageio.plugins.jpeg

javax.imageio.spi

javax.imageio.stream

javax.management

javax.management.loading

javax.management.modelmbean

javax.management.monitor

javax.management.openmbean

javax.management.relation

javax.management.remote

javax.management.remote.rmi

javax.management.timer

javax.naming

javax.naming.directory

javax.naming.event

javax.naming.ldap

javax.naming.spi

javax.net

javax.net.ssl

javax.print

javax.print.attribute

javax.print.attribute.standard

javax.print.event

javax.rmi

javax.rmi.CORBA

javax.rmi.ssl

javax.security.auth

javax.security.auth.callback

javax.security.auth.kerberos

javax.security.auth.login

javax.security.auth.spi

javax.security.auth.x500

javax.security.cert

javax.security.sasl

javax.sound.midi

javax.sound.midi.spi

javax.sound.sampled

javax.sound.sampled.spi

javax.sql

javax.sql.rowset

javax.sql.rowset.serial

javax.sql.rowset.spi

javax.swing

javax.swing.border

javax.swing.colorchooser

javax.swing.event

javax.swing.filechooser

javax.swing.plaf

javax.swing.plaf.basic

javax.swing.plaf.metal

javax.swing.plaf.multi

javax.swing.plaf.synth

javax.swing.table

javax.swing.text

javax.swing.text

javax.swing.text.parser

javax.swing.text.rtf

javax.swing.tree

javax.swing.undo

javax.transaction

javax.transaction.xa

javax.xml

javax.xml.datatype

javax.xml.namespace

javax.xml.parsers

javax.xml.transform

javax.xml.transform.dom

javax.xml.transform.sax

javax.xml.transform.stream

javax.xml.validation

javax.xml.xpath

org.ietf.jgss

org.omg.CORBA

org.omg.CORBA_2_3

org.omg.CORBA_2_3.portable

org.omg.CORBA.DynAnyPackage

org.omg.CORBA.ORBPackage

org.omg.CORBA.portable

org.omg.CORBA.TypeCodePackage

org.omg.CosNaming

org.omg.CosNaming.NamingContextExtPackage

org.omg.CosNaming.NamingContextPackage

org.omg.Dynamic

org.omg.DynamicAny

org.omg.DynamicAny.DynAnyFactoryPackage

org.omg.DynamicAny.DynAnyPackage

org.omg.IOP

org.omg.IOP.CodecFactoryPackage

org.omg.IOP.CodecPackage

org.omg.Messaging

org.omg.PortableInterceptor

org.omg.PortableInterceptor.ORBInitInfoPackage

org.omg.PortableServer

org.omg.PortableServer.CurrentPackage

org.omg.PortableServer.POAManagerPackage

org.omg.PortableServer.POAPackage

org.omg.PortableServer.portable

org.omg.PortableServer.ServantLocatorPackage

org.omg.SendingContext

org.omg.stub.java.rmi

org.w3c.dom

org.w3c.dom.bootstrap

org.w3c.dom.events

org.w3c.dom.ls

org.xml.sax

org.xml.sax.ext

org.xml.sax.helpers

allclasses-frame

allclasses-noframe

constant-values

deprecated-list

help-doc

JavaTM 2 Platform
Standard Ed. 5.0

java.rmi.activation
接口 Activator

所有超级接口:
Remote

public interface Activator
extends Remote

Activator 方便了远程对象激活。“失效的”远程引用调用激活器 (activator) 的 activate 方法来获得到“可激活的”远程对象的“活”引用。接收到激活的请求后,激活器为激活标识符 id 查找激活描述符,确定应当激活的对象所在的组通过组的 ActivationInstantiator 来初始化对象重创建(通过调用 newInstance 方法)。激活器在必要时才初始化激活组的执行。例如,如果针对某个特定组标识符的激活组尚未执行,则激活器为该组初始化 VM 的执行。

ActivatorActivationSystemActivationMonitor 紧密协作,ActivationSystem 提供了一种方式来注册那些组中的组和对象,而 ActivationMonitor 接收有关活动和不活动对象以及不活动组的信息。

激活器负责监视和检测,当激活组失败时,它可以移除那些组中的组和活动对象的旧远程引用。

从以下版本开始:
1.2
另请参见:
ActivationInstantiator, ActivationGroupDesc, ActivationGroupID

方法摘要
 MarshalledObject activate(ActivationID id, boolean force)
          激活与激活标识符 id 关联的对象。
 

方法详细信息

activate

MarshalledObject activate(ActivationID id,
                          boolean force)
                          throws ActivationException,
                                 UnknownObjectException,
                                 RemoteException
激活与激活标识符 id 关联的对象。如果激活器知道对象已经是活动的,并且 force 为 false,则立即向调用方返回具有一个“活”引用的 stub;否则,如果激活器不知道对应的远程对象是否为活动的,则激活器使用激活描述符信息(前面已注册)来确定应当被激活的对象所在的组 (VM)。如果与对象组描述符相对应的 ActivationInstantiator 已经存在,则激活器调用激活组的 newInstance 方法来传递对象的 id 和描述符。

如果针对该对象的组描述符的激活组尚未存在,则激活器启动一次 ActivationInstantiator 执行(例如,通过生成一个子进程)。当激活器接收到激活组的指定该激活组引用的回调(通过 ActivationSystemactiveGroup 方法)时,然后激活器可以调用该激活初始化程序的 newInstance 方法来转发每一个挂起的激活请求给激活组,并且向调用方返回结果(一个编组的远程对象引用,一个 stub)。

注意,激活器接收一个“编组”的对象,而不是一个远程对象,以便激活器无需为该对象加载代码或者参与针对该对象的分布式垃圾收集。如果激活器保持对该远程对象的一个强引用,则在正常的分布式垃圾收集机制下,激活器可能阻止对象被垃圾回收。

参数:
id - 正被激活的对象的激活标识符
force - 如果为 true,激活器联络该组来获得该远程对象的引用;如果为 false,返回允许的缓存值。
返回:
以一种编组形式返回远程对象(一个 stub)
抛出:
ActivationException - 如果对象激活失败
UnknownObjectException - 如果对象未知(未注册)
RemoteException - 如果远程调用失败
从以下版本开始:
1.2

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策