org.mdiutil.net

Class NestableURLConstructor

java.lang.Object

org.mdiutil.net.NestableURLConstructor

public class NestableURLConstructor
extends Object

This class is able to construct a nestable URL with arbitrary levels of nested zip elements.

Constructor Summary

Constructors

Constructor and Description
NestableURLConstructor(File file) Constructor.
NestableURLConstructor(File file, boolean useZipProtocol) Constructor.
NestableURLConstructor(URL url) Constructor.
NestableURLConstructor(URL url, boolean useZipProtocol) Constructor.

Method Summary

Modifier and Type	Method and Description
void	addNestedEntry(String entry) Add a nested entry.
int	countEntryLevels() Count the number of levels of entries.
URL	getURL() Return the URL.
String	getURLSpec() Return the URL specification.

Methods inherited from class java.lang.Object

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

Constructor Detail

NestableURLConstructor

public NestableURLConstructor(URL url)

Constructor. The wrapper protocol will be "zip:" by default.

Parameters:

url - the URL

NestableURLConstructor

public NestableURLConstructor(URL url,
                              boolean useZipProtocol)

Constructor.

Parameters:

url - the URL

useZipProtocol - true if the "zip:" protocol must be used, else the "jar:" ptrotocol will be used

NestableURLConstructor

public NestableURLConstructor(File file)
                       throws MalformedURLException

Constructor. The wrapper protocol will be "zip:" by default.

Parameters:

file - the file

Throws:

MalformedURLException - for a malformed URL exception

NestableURLConstructor

public NestableURLConstructor(File file,
                              boolean useZipProtocol)
                       throws MalformedURLException

Constructor.

Parameters:

file - the file

useZipProtocol - true if the "zip:" protocol must be used, else the "jar:" ptrotocol will be used

Throws:

MalformedURLException - for a malformed URL exception

Method Detail

addNestedEntry

public void addNestedEntry(String entry)

Add a nested entry. The last one will be a termial entry.

Parameters:

entry - the entry path from its parent

countEntryLevels

public int countEntryLevels()

Count the number of levels of entries.

Returns:

the number of levels of entries

getURL

public URL getURL()
           throws MalformedURLException

Return the URL. Note that to be able to use this method, you will need to install the ZipStreamHandlerFactory if you did not set the useZipProtocol argument to false, because by default Java does not accept to handle zip protocols. If you don't do this prior to using this method, you will encounter an exception because zip protocols are not handled by default in the JDK.

Returns:

the URL

Throws:

MalformedURLException

getURLSpec

public String getURLSpec()
                  throws MalformedURLException

Return the URL specification. To create an URL from this spec, just do:

 URL url = new URL(spec);
 

Returns:

the URL specification

Throws:

MalformedURLException