org.apache.ivy.util.url
Class ApacheURLLister

java.lang.Object
  extended by org.apache.ivy.util.url.ApacheURLLister

public class ApacheURLLister
extends java.lang.Object

Utility class which helps to list urls under a given url. This has been tested with Apache 1.3.33 server listing, as the one used at ibiblio, and with Apache 2.0.53 server listing, as the one on mirrors.sunsite.dk.


Constructor Summary
ApacheURLLister()
           
 
Method Summary
 java.util.List listAll(java.net.URL url)
          Returns a list of sub urls of the given url.
 java.util.List listDirectories(java.net.URL url)
          Returns a list of sub 'directories' of the given url.
 java.util.List listFiles(java.net.URL url)
          Returns a list of sub 'files' (in opposition to directories) of the given url.
 java.util.List retrieveListing(java.net.URL url, boolean includeFiles, boolean includeDirectories)
          Retrieves a List of URLs corresponding to the files and/or directories found at the supplied base URL.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ApacheURLLister

public ApacheURLLister()
Method Detail

listAll

public java.util.List listAll(java.net.URL url)
                       throws java.io.IOException
Returns a list of sub urls of the given url. The returned list is a list of URL.

Parameters:
url - The base URL from which to retrieve the listing.
Returns:
a list of sub urls of the given url.
Throws:
java.io.IOException - If an error occures retrieving the HTML.

listDirectories

public java.util.List listDirectories(java.net.URL url)
                               throws java.io.IOException
Returns a list of sub 'directories' of the given url. The returned list is a list of URL.

Parameters:
url - The base URL from which to retrieve the listing.
Returns:
a list of sub 'directories' of the given url.
Throws:
java.io.IOException - If an error occures retrieving the HTML.

listFiles

public java.util.List listFiles(java.net.URL url)
                         throws java.io.IOException
Returns a list of sub 'files' (in opposition to directories) of the given url. The returned list is a list of URL.

Parameters:
url - The base URL from which to retrieve the listing.
Returns:
a list of sub 'files' of the given url.
Throws:
java.io.IOException - If an error occures retrieving the HTML.

retrieveListing

public java.util.List retrieveListing(java.net.URL url,
                                      boolean includeFiles,
                                      boolean includeDirectories)
                               throws java.io.IOException
Retrieves a List of URLs corresponding to the files and/or directories found at the supplied base URL.

Parameters:
url - The base URL from which to retrieve the listing.
includeFiles - If true include files in the returned list.
includeDirectories - If true include directories in the returned list.
Returns:
A List of URLs.
Throws:
java.io.IOException - If an error occures retrieving the HTML.