void checkConnect(String host, int port, Object context)
描述 (Description)
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。
声明 (Declaration)
以下是java.lang.SecurityManager.checkConnect()方法的声明
public void checkConnect(String host, int port, Object context)
参数 (Parameters)
host - 要连接的主机名端口。
port - 要连接的协议端口。
context - 依赖于系统的安全上下文。
返回值 (Return Value)
此方法不返回值。
异常 (Exception)
SecurityException - 如果指定的安全上下文不是AccessControlContext的实例(例如,为null),或者没有权限打开到指定主机和端口的套接字连接。
NullPointerException - 如果host参数为null。
例子 (Example)
我们的示例要求阻止每个命令的权限。 设置了一个新的策略文件,该文件仅允许创建和设置我们的安全管理器。 该文件位于C:/java.policy中,包含以下文本 -
grant {
permission java.lang.RuntimePermission "setSecurityManager";
permission java.lang.RuntimePermission "createSecurityManager";
permission java.lang.RuntimePermission "usePolicy";
};
以下示例显示了lang.SecurityManager.checkConnect()方法的用法。
package com.iowiki;
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.iowiki.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.iowiki.com:8080 connect,resolve)