org.apache.river.phoenix

Class SystemAccessExporter

java.lang.Object

org.apache.river.phoenix.SystemAccessExporter

All Implemented Interfaces:

net.jini.export.Exporter

public class SystemAccessExporter
extends Object
implements net.jini.export.Exporter

Exporter that wraps an ActivationSystem instance so that it only accepts calls from the local host and optionally enforces a GroupPolicy on calls to registerGroup and setActivationGroupDesc.

Since:

2.0

Author:

Sun Microsystems, Inc.

Constructor Summary

Constructors

Constructor and Description
SystemAccessExporter() Creates an exporter with an underlying SunJrmpExporter that exports using a well-known object identifier (4) on the standard activation port (1098), and a DefaultGroupPolicy instance.
SystemAccessExporter(net.jini.export.Exporter exporter) Creates an exporter with the specified underlying exporter and a DefaultGroupPolicy instance.
SystemAccessExporter(net.jini.export.Exporter exporter, GroupPolicy policy) Creates an exporter with the specified underlying exporter and the specified group policy, if any.
SystemAccessExporter(GroupPolicy policy) Creates an exporter with an underlying SunJrmpExporter that exports using a well-known object identifier (4) on the standard activation port (1098), and the specified group policy, if any.
SystemAccessExporter(int port) Creates an exporter with an underlying SunJrmpExporter that exports using a well-known object identifier (4) on the specified port, and a DefaultGroupPolicy instance.
SystemAccessExporter(int port, GroupPolicy policy) Creates an exporter with an underlying SunJrmpExporter that exports using a well-known object identifier (4) on the specified port, and the specified group policy, if any.

Method Summary

Modifier and Type	Method and Description
Remote	export(Remote impl) Wraps the specified remote object in an ActivationSystem implementation that only accepts calls from the local host and enforces the group policy (if any) before delegating to the specified remote object, exports the wrapper with the underlying exporter, and returns the resulting proxy.
boolean	unexport(boolean force)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SystemAccessExporter

public SystemAccessExporter()

Creates an exporter with an underlying SunJrmpExporter that exports using a well-known object identifier (4) on the standard activation port (1098), and a DefaultGroupPolicy instance.

SystemAccessExporter

public SystemAccessExporter(GroupPolicy policy)

Creates an exporter with an underlying SunJrmpExporter that exports using a well-known object identifier (4) on the standard activation port (1098), and the specified group policy, if any.

Parameters:

policy - the group policy, or null

SystemAccessExporter

public SystemAccessExporter(int port)

Creates an exporter with an underlying SunJrmpExporter that exports using a well-known object identifier (4) on the specified port, and a DefaultGroupPolicy instance.

Parameters:

port - the port on which to receive calls (if zero, an anonymous port will be chosen)

SystemAccessExporter

public SystemAccessExporter(int port,
                            GroupPolicy policy)

Creates an exporter with an underlying SunJrmpExporter that exports using a well-known object identifier (4) on the specified port, and the specified group policy, if any.

Parameters:

port - the port on which to receive calls (if zero, an anonymous port will be chosen)

policy - the group policy, or null

SystemAccessExporter

public SystemAccessExporter(net.jini.export.Exporter exporter)

Creates an exporter with the specified underlying exporter and a DefaultGroupPolicy instance.

Parameters:

exporter - the underlying exporter

SystemAccessExporter

public SystemAccessExporter(net.jini.export.Exporter exporter,
                            GroupPolicy policy)

Creates an exporter with the specified underlying exporter and the specified group policy, if any.

Parameters:

exporter - the underlying exporter

policy - the group policy, or null

Method Detail

export

public Remote export(Remote impl)
              throws ExportException

Wraps the specified remote object in an ActivationSystem implementation that only accepts calls from the local host and enforces the group policy (if any) before delegating to the specified remote object, exports the wrapper with the underlying exporter, and returns the resulting proxy. The wrapper is strongly referenced by this exporter. For all ActivationSystem and ActivationAdmin methods, the wrapper throws an AccessControlException if the client is not calling from the local host. For the registerGroup and setActivationGroupDesc methods, the policy (if any) is checked by calling its checkGroup method with the ActivationGroupDesc argument.

Specified by:

export in interface net.jini.export.Exporter

Throws:

IllegalArgumentException - if impl does not implement ActivationSystem or ActivationAdmin

NullPointerException

IllegalStateException

ExportException

unexport

public boolean unexport(boolean force)

Specified by:

unexport in interface net.jini.export.Exporter

Throws:

IllegalStateException