典型情况下uri构造函数用于建立封装用户指定的uri的uri对象。因为用户可能输入不正确的uri,所以uri构造函数产生已检查的urisyntaxexception对象。这意味着你的代码必须明确地尝试着调用某个uri构造函数并捕捉异常,或者通过在该方法的throws子句中列举urisyntaxexception以"推卸责任"。
如果你知道uri是有效的(例如在源代码中的uri),将不会产生urisyntaxexception对象。因为在这种情况下处理某个uri构造函数的异常处理要求可能有困难,所以uri提供了静态的create(string uri)方法。
这个方法分解通过uri引用的string对象中包含uri,如果该uri没有违反任何语法规则就建立uri对象(并从方法中返回对它的引用),否则将捕捉到一个内部的urisyntaxexception对象,把该对象包装金一个未检查的illegalargumentexception对象中,并抛出这个illegalargumentexception对象。
因为illegalargumentexception是未检查的,你不需要明确的尝试代码并捕捉异常或把它的类名称列举在throws子句中。
下面的代码片断演示了create(string uri):
uri uri = uri.create ("http://www.cnn.com");
uri构造函数和create(string uri)方法试图分解出某个uri的授权机构组件的用户信息、主机和端口部分。对于按正常形式形成的基于服务器的授权机构组件,它们是会成功的。对于按拙劣的形式形成的基于服务器的授权机构组件,他们将会失败--并且把该授权机构组件当作是基于注册的。
有时你可能知道某个uri的授权机构组件必须是基于服务器的。你可以确保该uri的授权机构组件分解出用户信息、主机和端口,或者你可以确保将产生一个异常(伴随着相应的诊断信息)。你可以通过调用uri的parseserverauthority()方法实现这种操作。
如果成功分解出uri,该方法将返回包含提取的用户信息、主机和端口部分的uri的新uri对象的一个引用(但是如果授权机构组件已经被分解过了,将会返回调用parseserverauthority()的uri对象的引用。),否则该方法将产生一个urisyntaxexception对象。
下面的代码片断演示了parseserverauthority():
// 下面的parseserverauthority()调用出现后会发生什么情况?
uri uri = new uri ("//foo:bar").parseserverauthority();
一旦拥有了uri对象,你就可以通过调用getauthority()、getfragment()、gethost()、getpath()、getport()、getquery()、getscheme()、getschemespecificpart()和 getuserinfo()方法提取多种组件。
你也可以通过调用isabsolute()确定该uri是绝对的还是相对的,通过调用isopaque()确定该uri是不透明的还是分层的。如果返回值是true意味着该uri是绝对的或不透明的,如果返回值是false意味着该uri是相对的或分层的。
列表1中的程序用命令行参数建立了一个uri对象,调用uri组件提取方法来检索uri的组件,并调用uri的isabsolute()和isopaque()方法把该uri分类为绝对的/相对性和不透明的/分层的。
列表1: uridemo1.java
// uridemo1.java
import java.net.*;
class uridemo1
{
ublic static void main (string [] args) throws exception
{
if (args.length != 1)
{
system.err.println ("usage: java uridemo1 uri");
return;
}
uri uri = new uri (args [0]);
system.out.println ("authority = " +uri.getauthority ());
system.out.println ("fragment = " +uri.getfragment ());
system.out.println ("host = " +uri.gethost ());
system.out.println ("path = " +uri.getpath ());
system.out.println ("port = " +uri.getport ());
system.out.println ("query = " +uri.getquery ());
system.out.println ("scheme = " +uri.getscheme ());
system.out.println ("scheme-specific part = " +
uri.getschemespecificpart ());
system.out.println ("user info = " +uri.getuserinfo ());
system.out.println ("uri is absolute: " +uri.isabsolute ());
system.out.println ("uri is opaque: " +uri.isopaque ());
}
}
闽公网安备 35060202000074号