模块  java.base
软件包  java.net

Class ContentHandler


  • public abstract class ContentHandlerextends Object
    抽象类ContentHandler是从URLConnection读取Object的所有类的超类。

    应用程序通常不直接在此类中调用getContent方法。 相反,应用程序在类URLURLConnection调用getContent方法。 应用程序的内容处理程序工厂(实现接口的类的实例ContentHandlerFactory通过呼叫建立到setContentHandlerFactory被称为具有String给套接字上接收的MIME类型的对象。工厂返回的子类的实例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)ContentHandlerFactoryURL.getContent()URLConnectionURLConnection.getContent()URLConnection.setContentHandlerFactory(java.net.ContentHandlerFactory)
    • 构造方法详细信息

      • 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,                         [] classes)                  throws IOException
        给定位于对象表示开头的URL连接流,此方法读取该流并创建与指定类型之一匹配的对象。 此方法的默认实现应调用getContent(URLConnection)并筛选返回类型以匹配建议的类型。
        参数
        urlc - URL连接。
        classes - 请求的类型数组
        结果
        ContentHandler读取的对象是建议类型的第一个匹配项,如果没有支持请求, null
        异常
        IOException - 如果在读取对象时发生I / O错误。
        从以下版本开始:
        1.3