Java.lang.SecurityManager.checkConnect() 方法

描述

java.lang.SecurityManager.checkConnect(String host, int port, Object context) 方法 如果不允许指定的安全上下文打开与指定主机和端口号的套接字连接,则抛出 SecurityException。 端口号 -1 表示调用方法正在尝试确定指定主机名的 IP 地址。

如果 context 不是 AccessControlContext 的实例,则抛出 SecurityException。 否则,检查端口号。 如果不等于 -1,则使用 SocketPermission(host+":"+port,"connect") 权限调用上下文的 checkPermission 方法。 如果端口等于 -1,则使用 SocketPermission(host,"resolve") 权限调用上下文的 checkPermission 方法。

如果你重写了这个方法,那么你应该在被重写的方法通常会抛出异常的地方调用 super.checkConnect。


声明

以下是 java.lang.SecurityManager.checkConnect() 方法的声明。

public void checkConnect(String host, int port, Object context)

参数

  • host − 要连接的主机名端口。

  • port − 要连接的协议端口。

  • context − 依赖于系统的安全上下文。


返回值

此方法不返回值。


异常

  • SecurityException − 如果指定的安全上下文不是 AccessControlContext 的实例(例如,为 null),或者无权打开到指定主机和端口的套接字连接。

  • NullPointerException − 如果主机参数为空。


示例

我们的示例要求阻止每个命令的权限。 设置了一个新的策略文件,它只允许创建和设置我们的安全管理器。 该文件位于 C:/java.policy 并包含以下文本 −

grant {
   permission java.lang.RuntimePermission "setSecurityManager";
   permission java.lang.RuntimePermission "createSecurityManager";
   permission java.lang.RuntimePermission "usePolicy";
};

下面的例子展示了 lang.SecurityManager.checkConnect() 方法的使用。

package com.tutorialspoint;

import java.security.AccessControlContext;
import java.security.AccessController;

public class SecurityManagerDemo {

   public static void main(String[] args) {

      // get the current calling context
      AccessControlContext acc = AccessController.getContext();

      // set the policy file as the system securuty policy
      System.setProperty("java.security.policy", "file:/C:/java.policy");

      // create a security manager
      SecurityManager sm = new SecurityManager();

      // set the system security manager
      System.setSecurityManager(sm);

      // perform the check
      sm.checkConnect("www.tutorialspoint.com", 8080, acc);

      // print a message if we passed the check
      System.out.println("Allowed!");
   }
}

让我们编译并运行上面的程序,这将产生下面的结果 −

Exception in thread "main" java.security.AccessControlException: access denied (java.net.SocketPermission www.tutorialspoint.com:8080 connect,resolve)