|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.net.ContentHandler
public abstract class ContentHandler
The abstract class ContentHandler
is the superclass
of all classes that read an Object
from a
URLConnection
.
An application does not generally call the
getContent
method in this class directly. Instead, an
application calls the getContent
method in class
URL
or in URLConnection
.
The application's content handler factory (an instance of a class that
implements the interface ContentHandlerFactory
set
up by a call to setContentHandler
) is
called with a String
giving the MIME type of the
object being received on the socket. The factory returns an
instance of a subclass of ContentHandler
, and its
getContent
method is called to create the object.
If no content handler could be found, URLConnection will look for a content handler in a user-defineable set of places. By default it looks in sun.net.www.content, but users can define a vertical-bar delimited set of class prefixes to search through in addition by defining the java.content.handler.pkgs property. The class name must be of the form:
{package-prefix}.{major}.{minor} e.g. YoyoDyne.experimental.text.plainIf the loading of the content handler class would be performed by a classloader that is outside of the delegation chain of the caller, the JVM will need the RuntimePermission "getClassLoader".
getContent(java.net.URLConnection)
,
ContentHandlerFactory
,
URL.getContent()
,
URLConnection
,
URLConnection.getContent()
,
URLConnection.setContentHandlerFactory(java.net.ContentHandlerFactory)
Constructor Summary | |
---|---|
ContentHandler()
|
Method Summary | |
---|---|
abstract Object |
getContent(URLConnection urlc)
Given a URL connect stream positioned at the beginning of the representation of an object, this method reads that stream and creates an object from it. |
Object |
getContent(URLConnection urlc,
Class[] classes)
Given a URL connect stream positioned at the beginning of the representation of an object, this method reads that stream and creates an object that matches one of the types specified. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public ContentHandler()
Method Detail |
---|
public abstract Object getContent(URLConnection urlc) throws IOException
urlc
- a URL connection.
ContentHandler
.
IOException
- if an I/O error occurs while reading the object.public Object getContent(URLConnection urlc, Class[] classes) throws IOException
urlc
- a URL connection.classes
- an array of types requested
ContentHandler
that is
the first match of the suggested types.
null if none of the requested are supported.
IOException
- if an I/O error occurs while reading the object.
|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 1993, 2010, Oracle and/or its affiliates. All rights reserved.