java.net

Class ContentHandler

java.lang.Object

java.net.ContentHandler

public abstract class ContentHandler
extends Object

This is an abstract class that is the superclass for classes that read objects from URL's. Calling the getContent() method in the URL class or the URLConnection class will cause an instance of a subclass of ContentHandler to be created for the MIME type of the object being downloaded from the URL. Thus, this class is seldom needed by applications/applets directly, but only indirectly through methods in other classes.

Constructor Summary

Constructors

Constructor and Description
ContentHandler() Default, no-argument constructor.

Method Summary

Methods

Modifier and Type	Method and Description
abstract Object	getContent(URLConnection urlc) This method reads from the InputStream of the passed in URL connection and uses the data downloaded to create an Object represening the content.
Object	getContent(URLConnection urlc, Class[] classes) This method reads from the InputStream of the passed in URL connection and uses the data downloaded to create an Object represening the content.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ContentHandler

public ContentHandler()

Default, no-argument constructor.

Method Detail

getContent

public abstract Object getContent(URLConnection urlc)
                           throws IOException

This method reads from the InputStream of the passed in URL connection and uses the data downloaded to create an Object represening the content. For example, if the URL is pointing to a GIF file, this method might return an Image object. This method must be implemented by subclasses.

Parameters:

urlc - A URLConnection object to read data from.

Returns:

An object representing the data read

Throws:

IOException - If an error occurs

getContent

public Object getContent(URLConnection urlc,
                Class[] classes)
                  throws IOException

This method reads from the InputStream of the passed in URL connection and uses the data downloaded to create an Object represening the content. For example, if the URL is pointing to a GIF file, this method might return an Image object. This method must be implemented by subclasses. This method uses the list of supplied classes as candidate types. If the data read doesn't match any of the supplied type, null is returned.

Parameters:

urlc - A URLConnection object to read data from.

classes - An array of types of objects that are candidate types for the data to be read.

Returns:

An object representing the data read, or null if the data does not match any of the candidate types.

Throws:

IOException - If an error occurs

Since:

1.3