com.partnersoft.net

Class UrlLib

java.lang.Object

com.partnersoft.net.UrlLib

public class UrlLib
extends java.lang.Object

Copyright 2012 Partner Software, Inc.

Author:

Jeremy Tarver

Constructor Summary

Constructors

Constructor and Description
UrlLib()

Method Summary

Methods

Modifier and Type	Method and Description
static java.net.URL	createURL(java.io.File file)
static java.net.URL	createURL(java.lang.String urlString) Creates a new URL.
static java.net.URL	createURL(java.net.URL base, java.lang.String path) Creates a new URL from a base URL.
static java.lang.String	decode(java.lang.String string)
static Naming<java.lang.String>	decodeFormParameters(java.lang.String coded) Decodes parameters from the HTTP GET format.
static long	download(java.net.URL source, java.io.File dest) Downloads a file from URL source to File destination.
static long	download(java.net.URL source, VfsFile dest) Downloads a file from URL source to File destination.
static java.lang.String	encode(java.lang.String string)
static boolean	exists(java.net.URL url) Checks for existence of a file at the given URL.
static boolean	exists(java.net.URL base, java.lang.String path)
static java.util.List<java.lang.String>	parseFileLinks(java.net.URL source)
static java.lang.String	readLine(java.net.URL source)
static java.lang.String	readLine(java.net.URL base, java.lang.String path)
static java.util.List<java.lang.String>	readLines(java.net.URL source)
static java.util.List<java.lang.String>	readLines(java.net.URL base, java.lang.String path)
static long	upload(java.io.File source, java.net.URL dest) Uploads a file from local store to a URL destination.
static long	upload(VfsFile source, java.net.URL dest) Uploads a file from local store to a URL destination.
static long	uploadQuietly(VfsFile source, java.net.URL dest) Similar to upload(), but does not resolve the host name via HostsLib.resolveHost(), and never prints the URL.

Methods inherited from class java.lang.Object

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

Constructor Detail

UrlLib

public UrlLib()

Method Detail

encode

public static java.lang.String encode(java.lang.String string)

decode

public static java.lang.String decode(java.lang.String string)

decodeFormParameters

public static Naming<java.lang.String> decodeFormParameters(java.lang.String coded)

Decodes parameters from the HTTP GET format.

createURL

public static java.net.URL createURL(java.lang.String urlString)
                              throws java.net.MalformedURLException

Creates a new URL. Takes care of space encoding etc.

Throws:

java.net.MalformedURLException

createURL

public static java.net.URL createURL(java.net.URL base,
                     java.lang.String path)
                              throws java.net.MalformedURLException

Creates a new URL from a base URL. Takes care of space encoding etc.

Throws:

java.net.MalformedURLException

createURL

public static java.net.URL createURL(java.io.File file)
                              throws java.io.IOException

Throws:

java.io.IOException

download

public static long download(java.net.URL source,
            java.io.File dest)
                     throws java.io.IOException

Downloads a file from URL source to File destination. Creates directories if needed. Returns number of bytes copied.

Throws:

java.io.IOException

download

public static long download(java.net.URL source,
            VfsFile dest)
                     throws java.io.IOException

Downloads a file from URL source to File destination. Creates directories if needed. Returns number of bytes copied.

Throws:

java.io.IOException

upload

public static long upload(java.io.File source,
          java.net.URL dest)
                   throws java.io.IOException

Uploads a file from local store to a URL destination. Returns number of bytes copied.

Throws:

java.io.IOException

upload

public static long upload(VfsFile source,
          java.net.URL dest)
                   throws java.io.IOException

Uploads a file from local store to a URL destination. Returns number of bytes copied.

Throws:

java.io.IOException

uploadQuietly

public static long uploadQuietly(VfsFile source,
                 java.net.URL dest)
                          throws java.io.IOException

Similar to upload(), but does not resolve the host name via HostsLib.resolveHost(), and never prints the URL. Use this is you have an explicit URL and don't want the log to contain it (e.g. so you don't show an FTP password). Returns number of bytes copied.

Throws:

java.io.IOException

readLine

public static java.lang.String readLine(java.net.URL source)
                                 throws java.io.IOException

Throws:

java.io.IOException

readLines

public static java.util.List<java.lang.String> readLines(java.net.URL source)
                                                  throws java.io.IOException

Throws:

java.io.IOException

parseFileLinks

public static java.util.List<java.lang.String> parseFileLinks(java.net.URL source)
                                                       throws java.io.IOException

Throws:

java.io.IOException

readLine

public static java.lang.String readLine(java.net.URL base,
                        java.lang.String path)
                                 throws java.io.IOException

Throws:

java.io.IOException

readLines

public static java.util.List<java.lang.String> readLines(java.net.URL base,
                                         java.lang.String path)
                                                  throws java.io.IOException

Throws:

java.io.IOException

exists

public static boolean exists(java.net.URL url)
                      throws java.io.IOException

Checks for existence of a file at the given URL.

Throws:

java.io.IOException

exists

public static boolean exists(java.net.URL base,
             java.lang.String path)
                      throws java.io.IOException

Throws:

java.io.IOException