org.apache.excalibur.source.impl
Class URLSource

java.lang.Object
  org.apache.excalibur.source.impl.AbstractSource
      org.apache.excalibur.source.impl.URLSource

All Implemented Interfaces:

Source

Direct Known Subclasses:

FTPSource

public class URLSource
extends AbstractSource
implements Source

Description of a source which is described by an URL.

Version:

CVS $Revision: 1.5 $ $Date: 2004/02/28 11:47:24 $

Author:

Avalon Development Team

Field Summary

protected long	m_cachedLastModificationDate
protected SourceValidity	m_cachedValidity the prev returned SourceValidity
protected URLConnection	m_connection The connection for a real URL
protected String	m_encoding The encoding of the SourceParameters
protected boolean	m_exists Does this source exist ?
protected boolean	m_isPost Is this a post?
protected String	m_mimeType The content type (if known)
protected SourceParameters	m_parameters The SourceParameters used for a post
protected URL	m_url The URL of the source

Constructor Summary

URLSource()
Constructor

Method Summary

boolean	exists() Does this source exist ?
protected void	getInfos() Get the last modification date and content length of the source.
InputStream	getInputStream() Return an InputStream object to read from the source.
String	getMimeType() The mime-type of the content described by this object.
protected String	getUserInfo() The decoded userinfo for this source.
SourceValidity	getValidity() Get the Validity object.
void	init(URL url, Map parameters) Initialize a new object from a URL.
void	parameterize(org.apache.avalon.framework.parameters.Parameters par)
void	refresh() Refresh this object and update the last modified date and content length.

Methods inherited from class org.apache.excalibur.source.impl.AbstractSource

checkInfos, getContentLength, getLastModified, getScheme, getURI, setContentLength, setLastModified, setScheme, setSystemId

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.excalibur.source.Source

getContentLength, getLastModified, getScheme, getURI

Field Detail

m_url

protected URL m_url

The URL of the source

m_connection

protected URLConnection m_connection

The connection for a real URL

m_parameters

protected SourceParameters m_parameters

The SourceParameters used for a post

m_encoding

protected String m_encoding

The encoding of the SourceParameters

m_isPost

protected boolean m_isPost

Is this a post?

m_exists

protected boolean m_exists

Does this source exist ?

m_cachedValidity

protected SourceValidity m_cachedValidity

the prev returned SourceValidity

m_cachedLastModificationDate

protected long m_cachedLastModificationDate

m_mimeType

protected String m_mimeType

The content type (if known)

Constructor Detail

URLSource

public URLSource()

Constructor

Method Detail

init

public void init(URL url,
                 Map parameters)
          throws IOException

Initialize a new object from a URL.

Parameters:

parameters - This is optional

Throws:

IOException

parameterize

public void parameterize(org.apache.avalon.framework.parameters.Parameters par)

getInfos

protected void getInfos()

Get the last modification date and content length of the source. Any exceptions are ignored. Override this to get the real information

Overrides:

getInfos in class AbstractSource

exists

public boolean exists()

Does this source exist ?

Specified by:

exists in interface Source

Returns:

true if the source exists

getInputStream

public InputStream getInputStream()
                           throws IOException,
                                  SourceException

Return an InputStream object to read from the source. The returned stream must be closed by the calling code.

Specified by:

getInputStream in interface Source

Overrides:

getInputStream in class AbstractSource

Returns:

the InputStream to read data from (never null).

Throws:

SourceException - if file not found or HTTP location does not exist.

IOException - if I/O error occured.

getValidity

public SourceValidity getValidity()

Get the Validity object. This can either wrap the last modification date or the expires information or... If it is currently not possible to calculate such an information null is returned.

Specified by:

getValidity in interface Source

Overrides:

getValidity in class AbstractSource

Returns:

the validity, or null.

refresh

public void refresh()

Refresh this object and update the last modified date and content length.

Specified by:

refresh in interface Source

Overrides:

refresh in class AbstractSource

getMimeType

public String getMimeType()

The mime-type of the content described by this object. If the source is not able to determine the mime-type by itself this can be null.

Specified by:

getMimeType in interface Source

Overrides:

getMimeType in class AbstractSource

Returns:

the source's mime-type or null.

getUserInfo

protected String getUserInfo()

The decoded userinfo for this source. null, if no userinfo exists