org.savantbuild.net

Class NetTools

java.lang.Object

org.savantbuild.net.NetTools

public class NetTools
extends java.lang.Object

This class provides toolkit methods for helping work with URLs and URIs and other network classes.

Constructor Summary

Constructors

Constructor and Description
NetTools()

Method Summary

Modifier and Type	Method and Description
static java.net.URI	build(java.lang.String... parts) Builds a URI from the given parts.
static java.nio.file.Path	downloadToPath(java.net.URI uri, java.lang.String username, java.lang.String password, MD5 md5) Downloads the resource given.

Methods inherited from class java.lang.Object

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

Constructor Detail

NetTools

public NetTools()

Method Detail

build

public static java.net.URI build(java.lang.String... parts)
                          throws java.net.URISyntaxException

Builds a URI from the given parts. These are concatenated together with slashes, depending on the endings of each.

Parameters:

parts - The parts

Returns:

The URI.

Throws:

java.net.URISyntaxException - If the parts passed in are not valid URI components.

downloadToPath

public static java.nio.file.Path downloadToPath(java.net.URI uri,
                                                java.lang.String username,
                                                java.lang.String password,
                                                MD5 md5)
                                         throws java.io.IOException,
                                                MD5Exception

Downloads the resource given.

Parameters:

uri - The resource.

username - (Optional) The username that might be used to connect to the resource.

password - (Optional) The password that might be used to connect to the resource.

md5 - (Optional) The MD5 of the resource (to verify).

Returns:

A temp file that stores the resource or null if the given URI doesn't exist.

Throws:

java.io.IOException - If the resource could not be downloaded.

MD5Exception - If the file was downloaded but doesn't match the MD5 sum.