JAVA RMI文档中文

原文链接
2.4 RMI 接口和类概述
负责rmi系统远程调用使用的类和接口都定义在 java.mri包中。下图展示了这些接口和类之间大概的关系：
这里写图片描述

2.4.1 java.rmi.Remote 接口
在RMI中，一个remote接口会声明一系列的方法，这些方法可能会被一个远端的java虚拟机调用。一个远端接口必须满足下列条件：
1、一个远端接口必须直接或间接实现java.rmi.Remote接口。
2、远端接口中声明的方法必须满足下列条件：
1、一个远端方法声明的时候，除了自身需要抛出的异常，必须要抛出java.rmi.RemoteException（或者它的父类，比如java.io.IOException, java.lang.Exception）。
2、在远端方法声明中，远端对象声明为参数或返回值（在参数列表中直接声明或在参数中嵌入非远端对象）的远端对象必须声明为远端接口，而不是该接口的实现类。

java.rmi.Remote 接口是一个marker interface，它没有声明方法。

一个远端接口必须至少实现java.rmi.Remote接口。但是，在下面情况下，一个远端接口也可以实现一个非远端接口：
一个远端接口可能实现一个非远端接口，只要这个接口下的方法全部满足远端接口下方法的声明条件。

比如，下面的接口BankAccount 定义了一个用来访问银行账户的远端接口。它包含了存钱、获取余额和撤回方法。

public interface BankAccount extends java.rmi.Remote {
	public void deposit(float amount)
		throws java.rmi.RemoteException;
	public void withdraw(float amount)
		throws OverdrawnException, java.rmi.RemoteException;
	public float getBalance()
		throws java.rmi.RemoteException;
}

接下来的例子，展示了一个有效的远端接口Beta，它实现了一个远端接口java.rmi.Remote和一个非远端接口Alpha，该接口声明了一些远端方法。

public interface Alpha {
	public final String okay = "constants are okay too";
	public Object foo(Object obj)
		throws java.rmi.RemoteException;
	public void bar() throws java.io.IOException;
	public int baz() throws java.lang.Exception;
}


public interface Beta extends Alpha, java.rmi.Remote {
	public void ping() throws java.rmi.RemoteException;
}

2.4.2 RemoteException
java.rmi.RemoteException是RMI系统在运行时，方法调用时抛出异常的父类。为了保证使用RMI系统的应用的健壮性，每一个远端方法在声明的时候都必须抛出该异常。

该异常在某些原因下当方法调用异常会被抛出。这些原因包括：
1、连接失败（远端服务器不可达到或者拒绝连接，服务端关闭连接等）
2、参数或者返回值编组或者解组错误（Failure during parameter or return value marshalling or unmarshalling）
3、协议错误
EemoteException 是一个检查性异常（它必须被调用者处理，而且会受到编译器检查），而不是一个运行时异常。

2.4.3 RemoteObject 类和它的子类
RMI服务中的功能是由java.rmi.server.RemoteObject和它的子类以及java.rmi.server.RemoteServer、java.rmi.server.UnicastRemoteObject、java.rmi.activation.Activatable提供的。

1、java.rmi.server.RemoteObject类实现了java.lang.Object中的hashCode、equals和toString方法，这些方法对于远端对象也是很有用的。

2、UnicastRemoteObject 和 Activatable 提供了创建远端对象的方法，并暴露它们给客户端，供客户端使用。

3、java.rmi.server.UnicastRemoteObject类定义了一个单例（unicast）远端对象，该对象的引用只有在服务端进程有效的时候才会有效。

4、java.rmi.activation.Activatable是一个抽象类，它定义了一个远端对象activatable，当它的方法被调用的时候，它就开始执行，并且可以在必要的时候停止。

2.5 实现一个远端接口

一个类实现一个远端接口，通常要遵守下面的规则：
1、这个类通常会继承java.rmi.server.UnicastRemoteObject，从而继承java.rmi.server.RemoteObject和java.rmi.server.RemoteServer提供的方法。
2、这个类可以实现任意多的远端接口。
3、这个类可以继承其他的远端接口实现类。
4、这个类可以定义不在远端接口中出现的方法，当时该方法只能用于本地。

比如说，下面这个类BankAcctImpl实现了BankAccount远端接口，而且继承了java.rmi.server.UnicastRemoteObject类：

package mypackage;

import java.rmi.RemoteException;
import java.rmi.server.UnicastRemoteObject;

public class BankAccountImpl
	extends UnicastRemoteObject
	implements BankAccount
{
	private float balance = 0.0;

	public BankAccountImpl(float initialBalance) 
		throws RemoteException 
	{
		balance = initialBalance;
	}
	public void deposit(float amount) throws RemoteException {
		...
	}
	public void withdraw(float amount) throws OverdrawnException,
		RemoteException {
		...
	}
	public float getBalance() throws RemoteException {
		...
	}
}

注意，如果有必要的话，一个实现了远端接口的类可以继承除了java.rmi.server.UnicastRemoteObject外的其他类。但是，这个实现类必须承担暴露这些对象的（由UnicastRemoteObject的构造方法负责）而且要实现（如果需要的话）正确的hashCode、equals、toString这些从java.lang.Object继承来的方法。

To Be Continue

猜你喜欢