RMISocketFactory (Java Platform SE 8 )

java.lang.Object
- java.rmi.server.RMISocketFactory

All Implemented Interfaces:

RMIClientSocketFactory ， RMIServerSocketFactory
```
public abstract class RMISocketFactory
extends Object
implements RMIClientSocketFactory, RMIServerSocketFactory
```
RMI运行时使用RMISocketFactory实例，以获取RMI调用的客户端和服务器套接字。应用程序可以使用setSocketFactory方法来请求RMI运行时使用其套接字工厂实例而不是默认实现。
默认套接字工厂实现执行三层方法来创建客户端套接字。首先，尝试与远程VM的直接套接字连接。如果失败（由于防火墙），运行时将使用具有服务器的显式端口号的HTTP。如果防火墙不允许这种类型的通信，则使用服务器上的cgi-bin脚本的HTTP来POST RMI调用。默认情况下禁用HTTP隧道机制。此行为由java.rmi.server.disableHttp属性控制，其默认值为true 。将此属性的值设置为false将启用HTTP隧道机制。

已弃用：HTTP隧道。 上面描述的HTTP隧道机制，特别是具有显式端口的HTTP和到cgi-bin脚本的HTTP已被弃用。 这些HTTP隧道机制在将来的平台版本中被删除。

默认套接字工厂实现创建绑定到通配符地址的服务器套接字，该通配符地址接受来自所有网络接口的请求。
Implementation Note:
您可以使用RMISocketFactory类创建绑定到特定地址的服务器套接字，限制请求的来源。例如，以下代码实现将服务器套接字绑定到IPv4环回地址的套接字工厂。这将限制RMI仅处理来自本地主机的请求。
```
   class LoopbackSocketFactory extends RMISocketFactory { public ServerSocket createServerSocket(int port) throws IOException { return new ServerSocket(port, 5, InetAddress.getByName("127.0.0.1")); } public Socket createSocket(String host, int port) throws IOException { // just call the default client socket factory return RMISocketFactory.getDefaultSocketFactory() .createSocket(host, port); } } // ... RMISocketFactory.setSocketFactory(new LoopbackSocketFactory());  
```
将java.rmi.server.hostname系统属性设置为127.0.0.1以确保生成的存根连接到正确的网络接口。
从以下版本开始：

JDK1.1

构造方法摘要

构造方法
Constructor and Description
`RMISocketFactory()` 构造一个 `RMISocketFactory` 。

方法摘要

所有方法静态方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`abstract ServerSocket`	`createServerSocket(int port)` 在指定端口上创建服务器套接字（端口0表示匿名端口）。
`abstract Socket`	`createSocket(String host, int port)` 创建连接到指定主机和端口的客户端套接字。
`static RMISocketFactory`	`getDefaultSocketFactory()` 返回对此RMI实现使用的默认套接字工厂的引用。
`static RMIFailureHandler`	`getFailureHandler()` 返回由 `setFailureHandler`方法设置的套接字创建失败的处理程序。
`static RMISocketFactory`	`getSocketFactory()` 返回由 `setSocketFactory`方法设置的套接字工厂。
`static void`	`setFailureHandler(RMIFailureHandler fh)` 如果服务器套接字创建失败，则设置由RMI运行时调用的故障处理程序。
`static void`	`setSocketFactory(RMISocketFactory fac)` 设置RMI获取套接字的全局套接字工厂（如果远程对象与特定客户端和/或服务器套接字工厂没有关联）。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造方法详细信息
  - RMISocketFactory
```
public RMISocketFactory()
```
    构造一个 RMISocketFactory 。
    
    从以下版本开始：
    
    JDK1.1
- 方法详细信息
  - createSocket
```
public abstract Socket createSocket(String host,
                                    int port)
                             throws IOException
```
    创建连接到指定主机和端口的客户端套接字。
    
    Specified by:
    
    createSocket在界面 RMIClientSocketFactory
    
    参数
    
    host - 主机名
    
    port - 端口号
    
    结果
    
    一个连接到指定主机和端口的套接字。
    
    异常
    
    IOException - 如果套接字创建期间发生I / O错误
    
    从以下版本开始：
    
    JDK1.1
  - createServerSocket
```
public abstract ServerSocket createServerSocket(int port)
                                         throws IOException
```
    在指定端口上创建服务器套接字（端口0表示匿名端口）。
    
    Specified by:
    
    createServerSocket在界面 RMIServerSocketFactory
    
    参数
    
    port - 端口号
    
    结果
    
    指定端口上的服务器套接字
    
    异常
    
    IOException - 如果在创建服务器套接字期间发生I / O错误
    
    从以下版本开始：
    
    JDK1.1
  - setSocketFactory
```
public static void setSocketFactory(RMISocketFactory fac)
                             throws IOException
```
    设置RMI获取套接字的全局套接字工厂（如果远程对象与特定客户端和/或服务器套接字工厂没有关联）。 RMI插座工厂只能设置一次。注意：只有当当前安全管理器允许设置套接字工厂时，才可以设置RMISocketFactory; 如果不允许，将抛出SecurityException。
    
    参数
    
    fac - 插座工厂
    
    异常
    
    IOException - 如果已经设置了RMI套接字工厂
    
    SecurityException - 如果安全管理器存在，并且其 checkSetFactory方法不允许操作。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    getSocketFactory() ， SecurityManager.checkSetFactory()
  - getSocketFactory
```
public static RMISocketFactory getSocketFactory()
```
    返回由setSocketFactory方法设置的套接字工厂。如果没有设置套接字工厂，返回null 。
    
    结果
    
    插座工厂
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    setSocketFactory(RMISocketFactory)
  - getDefaultSocketFactory
```
public static RMISocketFactory getDefaultSocketFactory()
```
    返回对此RMI实现使用的默认套接字工厂的引用。这将是getSocketFactory运行时使用的工厂， getSocketFactory返回null 。
    
    结果
    
    默认的RMI套接字工厂
    
    从以下版本开始：
    
    JDK1.1
  - setFailureHandler
```
public static void setFailureHandler(RMIFailureHandler fh)
```
    如果服务器套接字创建失败，则设置由RMI运行时调用的故障处理程序。默认情况下，如果没有安装故障处理程序并且服务器套接字创建失败，则RMI运行时会尝试重新创建服务器套接字。
    如果有安全管理员，则该方法首先调用安全管理器的checkSetFactory方法，以确保允许操作。这可能会导致一个SecurityException 。
    
    参数
    
    fh - 故障处理程序
    
    异常
    
    SecurityException - 如果存在安全管理员，并且其 checkSetFactory方法不允许操作。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    getFailureHandler() ， RMIFailureHandler.failure(Exception)
  - getFailureHandler
```
public static RMIFailureHandler getFailureHandler()
```
    返回由 setFailureHandler方法设置的套接字创建失败的处理程序。
    
    结果
    
    故障处理程序
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    setFailureHandler(RMIFailureHandler)

Class RMISocketFactory

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

RMISocketFactory

方法详细信息

createSocket

createServerSocket

setSocketFactory

getSocketFactory

getDefaultSocketFactory

setFailureHandler

getFailureHandler