fr.gouv.culture.util.apache.avalon.excalibur.source.impl
Class URLSource

java.lang.Object
  org.apache.excalibur.source.impl.AbstractSource
      fr.gouv.culture.util.apache.avalon.excalibur.source.impl.URLSource

All Implemented Interfaces:

org.apache.excalibur.source.Source

public class URLSource
extends org.apache.excalibur.source.impl.AbstractSource
implements org.apache.excalibur.source.Source

Description of a source which is described by an URL. Cette classe vient telle quelle (excepté le nom du paquet et l'import de la classe org.apache.excalibur.source.impl.AbstractSource) de la version 2.2.3 d'Avalon Excalibur SourceResolver. Le but est de remplacer la classe originale de la version 2.1 incluse dans Cocoon 2.1.10. On cherche à paramétrer les "timeout" pour le moissonneur OAI de SDX (visiblement ce dernier a un "timeout " de 3 minutes). Dommage, ça ne fonctionne pas !

Version:

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

Author:

Avalon Development Team, Malo Pichot (AJLSM)

Field Summary

protected long	m_cachedLastModificationDate
protected org.apache.excalibur.source.SourceValidity	m_cachedValidity the prev returned SourceValidity
protected java.net.URLConnection	m_connection The connection for a real URL
protected java.lang.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 java.lang.String	m_mimeType The content type (if known)
protected org.apache.excalibur.source.SourceParameters	m_parameters The SourceParameters used for a post
protected java.net.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.
java.io.InputStream	getInputStream() Return an InputStream object to read from the source.
java.lang.String	getMimeType() The mime-type of the content described by this object.
protected java.lang.String	getUserInfo() The decoded userinfo for this source.
org.apache.excalibur.source.SourceValidity	getValidity() Get the Validity object.
void	init(java.net.URL url, java.util.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 java.net.URL m_url

The URL of the source

m_connection

protected java.net.URLConnection m_connection

The connection for a real URL

m_parameters

protected org.apache.excalibur.source.SourceParameters m_parameters

The SourceParameters used for a post

m_encoding

protected java.lang.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 org.apache.excalibur.source.SourceValidity m_cachedValidity

the prev returned SourceValidity

m_cachedLastModificationDate

protected long m_cachedLastModificationDate

m_mimeType

protected java.lang.String m_mimeType

The content type (if known)

Constructor Detail

URLSource

public URLSource()

Constructor

Method Detail

init

public void init(java.net.URL url,
                 java.util.Map parameters)
          throws java.io.IOException

Initialize a new object from a URL.

Parameters:

parameters - This is optional

Throws:

java.io.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 org.apache.excalibur.source.impl.AbstractSource

exists

public boolean exists()

Does this source exist ?

Specified by:

exists in interface org.apache.excalibur.source.Source

getInputStream

public java.io.InputStream getInputStream()
                                   throws java.io.IOException,
                                          org.apache.excalibur.source.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 org.apache.excalibur.source.Source

Overrides:

getInputStream in class org.apache.excalibur.source.impl.AbstractSource

Throws:

org.apache.excalibur.source.SourceException - if file not found or HTTP location does not exist.

java.io.IOException - if I/O error occured.

getValidity

public org.apache.excalibur.source.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 org.apache.excalibur.source.Source

Overrides:

getValidity in class org.apache.excalibur.source.impl.AbstractSource

refresh

public void refresh()

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

Specified by:

refresh in interface org.apache.excalibur.source.Source

Overrides:

refresh in class org.apache.excalibur.source.impl.AbstractSource

getMimeType

public java.lang.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 org.apache.excalibur.source.Source

Overrides:

getMimeType in class org.apache.excalibur.source.impl.AbstractSource

getUserInfo

protected java.lang.String getUserInfo()

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