Module java.base

软件包 java.net

Class ContentHandler

java.lang.Object

java.net.ContentHandler

public abstract class ContentHandler
extends Object

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

应用程序通常不会直接在此类中调用getContent方法。 相反，应用程序会在URL或URLConnection调用getContent方法。 应用程序的内容处理程序工厂（实现接口的类的实例ContentHandlerFactory通过调用设置为setContentHandler ）是带一个String给套接字上接收的MIME类型的对象。 工厂返回一个ContentHandler子类的ContentHandler ，并调用其getContent方法来创建该对象。

如果没有内容处理程序可以是found ，则URLConnection将在用户可定义的一组位置中查找内容处理程序。 用户可以通过定义URLConnection.contentPathProp属性来定义垂直条分隔的类前缀集来进行搜索。 班级的名称必须是：

{package-prefix}.{major}.{minor}

where {major}.{minor} is formed by taking the content-type string, replacing all slash characters with a period ('.'), and all other non-alphanumeric characters with the underscore character '_'. The alphanumeric characters are specifically the 26 uppercase ASCII letters 'A' through 'Z', the 26 lowercase ASCII letters 'a' through 'z', and the 10 ASCII digits '0' through '9'.

e.g. YoyoDyne.experimental.text.plain

如果没有找到用户定义的内容处理程序，那么系统会尝试从内置处理程序之一加载特定的内容类型处理程序（如果存在）。

如果内容处理程序类的加载将由调用者的委派链之外的类加载器执行，则JVM将需要RuntimePermission“getClassLoader”。

从以下版本开始：

1.0

另请参见：

getContent(java.net.URLConnection) ， ContentHandlerFactory ， URL.getContent() ， URLConnection ， URLConnection.getContent() ， URLConnection.setContentHandlerFactory(java.net.ContentHandlerFactory)

构造方法摘要

构造方法

Constructor	描述
ContentHandler()

方法摘要

Modifier and Type	方法	描述
abstract Object	getContent(URLConnection urlc)	给定位于对象表示开头的URL连接流，该方法读取该流并从中创建一个对象。
Object	getContent(URLConnection urlc, Class[] classes)	给定位于对象表示开始处的URL连接流，该方法读取该流并创建一个与指定类型匹配的对象。

Methods inherited from class 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错误。

从以下版本开始：

1.3