com.cedarsoftware.util

Class UrlUtilities

java.lang.Object

com.cedarsoftware.util.UrlUtilities

public class UrlUtilities
extends Object

Useful utilities for working with UrlConnections and IO.

Author:

John DeRegnaucourt ([email protected]) & Ken Partlow
Copyright (c) John DeRegnaucourt

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Field Summary

Fields

Modifier and Type	Field and Description
static String	COOKIE
static String	COOKIE_VALUE_DELIMITER
static SafeSimpleDateFormat	DATE_FORMAT
static char	DOT
static String	EXPIRES
static char	NAME_VALUE_SEPARATOR
static String	PATH
static String	SET_COOKIE
static String	SET_COOKIE_SEPARATOR

Method Summary

Methods

Modifier and Type	Method and Description
static void	disconnect(HttpURLConnection c)
static URLConnection	getConnection(String url, boolean input, boolean output, boolean cache)
static URLConnection	getConnection(URL url, boolean input, boolean output, boolean cache)
static URLConnection	getConnection(URL url, String proxyServer, int port, Map inCookies, Map outCookies, boolean input, boolean output, boolean cache, boolean ignoreSec)
static String	getContentFromUrl(String url) Get content from the passed in URL.
static String	getContentFromUrl(String url, String proxyServer, int port, Map inCookies, Map outCookies, boolean ignoreSec) Get content from the passed in URL.
static String	getCookieDomainFromHost(String host)
static void	getCookies(URLConnection conn, Map store) Retrieves and stores cookies returned by the host on the other side of the open java.net.URLConnection.
static String	getHostName()
static String	getUserAgent()
static void	readErrorResponse(URLConnection c)
static void	setCookies(URLConnection conn, Map store) Prior to opening a URLConnection, calling this method will set all unexpired cookies that match the path or subpaths for thi underlying URL The connection MUST NOT have been opened method or an IOException will be thrown.
static void	setReferer(String referer)
static void	setTimeouts(URLConnection c, int read, int connect)
static void	setUserAgent(String userAgent)

Methods inherited from class java.lang.Object

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

Field Detail

SET_COOKIE

public static final String SET_COOKIE

See Also:

Constant Field Values

COOKIE_VALUE_DELIMITER

public static final String COOKIE_VALUE_DELIMITER

See Also:

Constant Field Values

PATH

public static final String PATH

See Also:

Constant Field Values

EXPIRES

public static final String EXPIRES

See Also:

Constant Field Values

DATE_FORMAT

public static final SafeSimpleDateFormat DATE_FORMAT

SET_COOKIE_SEPARATOR

public static final String SET_COOKIE_SEPARATOR

See Also:

Constant Field Values

COOKIE

public static final String COOKIE

See Also:

Constant Field Values

NAME_VALUE_SEPARATOR

public static final char NAME_VALUE_SEPARATOR

See Also:

Constant Field Values

DOT

public static final char DOT

See Also:

Constant Field Values

Method Detail

setReferer

public static void setReferer(String referer)

setUserAgent

public static void setUserAgent(String userAgent)

getUserAgent

public static String getUserAgent()

getConnection

public static URLConnection getConnection(String url,
                          boolean input,
                          boolean output,
                          boolean cache)
                                   throws IOException

Throws:

IOException

getConnection

public static URLConnection getConnection(URL url,
                          boolean input,
                          boolean output,
                          boolean cache)
                                   throws IOException

Throws:

IOException

setTimeouts

public static void setTimeouts(URLConnection c,
               int read,
               int connect)

readErrorResponse

public static void readErrorResponse(URLConnection c)

disconnect

public static void disconnect(HttpURLConnection c)

getCookies

public static void getCookies(URLConnection conn,
              Map store)

Retrieves and stores cookies returned by the host on the other side of the open java.net.URLConnection.

The connection MUST have been opened using the connect() method or a IOException will be thrown.

Parameters:

conn - a java.net.URLConnection - must be open, or IOException will be thrown

Throws:

IOException - Thrown if conn is not open.

setCookies

public static void setCookies(URLConnection conn,
              Map store)
                       throws IOException

Prior to opening a URLConnection, calling this method will set all unexpired cookies that match the path or subpaths for thi underlying URL

The connection MUST NOT have been opened method or an IOException will be thrown.

Parameters:

conn - a java.net.URLConnection - must NOT be open, or IOException will be thrown

Throws:

IOException - Thrown if conn has already been opened.

getCookieDomainFromHost

public static String getCookieDomainFromHost(String host)

getContentFromUrl

public static String getContentFromUrl(String url)

Get content from the passed in URL. This code will open a connection to the passed in server, fetch the requested content, and return it as a String.

Parameters:

url - URL to hit

Returns:

UTF-8 String read from URL or null in the case of error.

getContentFromUrl

public static String getContentFromUrl(String url,
                       String proxyServer,
                       int port,
                       Map inCookies,
                       Map outCookies,
                       boolean ignoreSec)

Get content from the passed in URL. This code will open a connection to the passed in server, fetch the requested content, and return it as a String.

Parameters:

url - URL to hit

proxyServer - String named of proxy server

port - port to access proxy server

inCookies - Map of session cookies (or null if not needed)

outCookies - Map of session cookies (or null if not needed)

ignoreSec - if true, SSL connection will always be trusted.

Returns:

UTF-8 String read from URL or null in the case of error.

getConnection

public static URLConnection getConnection(URL url,
                          String proxyServer,
                          int port,
                          Map inCookies,
                          Map outCookies,
                          boolean input,
                          boolean output,
                          boolean cache,
                          boolean ignoreSec)
                                   throws IOException

Throws:

IOException

getHostName

public static String getHostName()