站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

ContentHandler (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

JavaTM 2 Platform
Standard Ed. 5.0

java.net
类 ContentHandler

java.lang.Object
  继承者 java.net.ContentHandler

public abstract class ContentHandler
extends Object

抽象类 ContentHandler 是从 URLConnection 读取 Object 的所有类的超类。

应用程序一般不直接调用此类中的 getContent 方法。而是调用 URLURLConnection 类中的 getContent 方法。应用程序的内容处理程序工厂(实现 ContentHandlerFactory 接口的类的实例,该接口通过调用 setContentHandler 设置)通过某个 String 来调用,该 String 给出将在套接字上接收的对象的 MIME 类型。工厂返回 ContentHandler 的子类的实例,并调用其 getContent 方法创建对象。

如果找不到任何内容处理程序,则 URLConnection 将在用户自定义的地点集合中查找内容处理程序。默认情况下,它在 sun.net.www.content 中查找,但是用户可以定义一个以垂线分隔的类前缀集合,也可以通过定义 java.content.handler.pkgs 属性以供搜索。类名称必须具有以下形式:

     {package-prefix}.{major}.{minor}
例如,
     YoyoDyne.experimental.text.plain
 
如果由调用方委托链外部的加载器执行内容处理程序类的加载,则 JVM 需要 RuntimePermission "getClassLoader"。

从以下版本开始:
JDK1.0
另请参见:
getContent(java.net.URLConnection), ContentHandlerFactory, URL.getContent(), URLConnection, URLConnection.getContent(), URLConnection.setContentHandlerFactory(java.net.ContentHandlerFactory)

构造方法摘要
ContentHandler()
           
 
方法摘要
abstract  Object getContent(URLConnection urlc)
          如果给出位于对象表示形式开头的 URL 连接流,则此方法读取该流并根据其创建对象。
 Object getContent(URLConnection urlc, Class[] classes)
          如果给出位于对象表示形式开头的 URL 连接流,则此方法读取该流并创建与给定类型之一匹配的对象。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

ContentHandler

public ContentHandler()
方法详细信息

getContent

public abstract Object getContent(URLConnection urlc)
                           throws IOException
如果给出位于对象表示形式开头的 URL 连接流,则此方法读取该流并根据其创建对象。

参数:
urlc - URL 连接。
返回:
ContentHandler 读取的对象。
抛出:
IOException - 如果读取该对象时发生 I/O 错误。

getContent

public Object getContent(URLConnection urlc,
                         Class[] classes)
                  throws IOException
如果给出位于对象表示形式开头的 URL 连接流,则此方法读取该流并创建与给定类型之一匹配的对象。 此方法的默认实现应该调用 getContent() 并在屏幕上显示建议类型的匹配项的返回类型。

参数:
urlc - URL 连接。
classes - 请求类型的数组
返回:
ContentHandler 读取的对象,其为建议类型的第一个匹配项。如果所有请求类型都不受支持,则返回 null。
抛出:
IOException - 如果读取该对象时发生 I/O 错误。

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策