org.silvertunnel_ng.netlib.adapter.url.URLUtil Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of netlib Show documentation

SilverTunnel-NG Netlib is a free library for the Java programming language that implements and encapsulates all the complex network protocol stuff needed for anonymous communication over the Tor anonymity network. Netlib can be easily integrated in almost every existing and new Java application. The library requires Java 1.6/Java SE 6 or a newer version. The original silvertunnel Netlib can be found here : silvertunnel.org

There is a newer version: 0.0.5

Show newest version

/*
 * silvertunnel.org Netlib - Java library to easily access anonymity networks
 * Copyright (c) 2009-2012 silvertunnel.org
 *
 * This program is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by the Free
 * Software Foundation; either version 2 of the License, or (at your option)
 * any later version.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
 * more details.
 *
 * You should have received a copy of the GNU General Public License along
 * with this program; if not, see .
 */
/*
 * silvertunnel-ng.org Netlib - Java library to easily access anonymity networks
 * Copyright (c) 2013 silvertunnel-ng.org
 *
 * This program is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by the Free
 * Software Foundation; either version 2 of the License, or (at your option)
 * any later version.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
 * more details.
 *
 * You should have received a copy of the GNU General Public License along
 * with this program; if not, see .
 */

package org.silvertunnel_ng.netlib.adapter.url;

import java.io.IOException;
import java.net.URL;
import java.net.URLConnection;
import java.net.URLStreamHandler;
import java.net.URLStreamHandlerFactory;

import org.silvertunnel_ng.netlib.adapter.url.impl.net.http.HttpHandler;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

/**
 * Support of URL handling.
 * 
 * @author hapke
 * @author Tobias Boese
 */
public class URLUtil
{
	/** */
	private static final Logger LOG = LoggerFactory.getLogger(URLUtil.class);

	/**
	 * Returns a {@link java.net.URLConnection URLConnection} instance that
	 * represents a connection to the remote object referred to by the
	 * {@code URL}.
	 * 
	 * @param factory
	 * @param url
	 *            http or https URL
	 * @return a {@link java.net.URLConnection URLConnection} linking to the
	 *         URL.
	 * @exception IOException
	 *                if an I/O exception occurs.
	 * @see java.net.URL#openConnection()
	 */
	public static URLConnection openConnection(final URLStreamHandlerFactory factory, final URL url) throws IOException
	{
		LOG.info("openConnection start with url={}", url);
		final URLStreamHandler handler = factory.createURLStreamHandler(url.getProtocol());
		final URLConnection result = ((HttpHandler) handler).openConnection(url, null);
		LOG.info("openConnection end with result={}", result);
		return result;
	}
}