aQute.bnd.service.url.URLConnector Maven / Gradle / Ivy

Go to download

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

The bndlib project is a general library to be used with OSGi bundles. It contains lots of cool functionality that calculates dependencies, etc.

There is a newer version: 2.4.0

Show newest version

package aQute.bnd.service.url;

import java.io.*;
import java.net.*;

public interface URLConnector {

	/**
	 * Connect to the specified URL.
	 * 
	 * @param url
	 * @return
	 * @throws IOException
	 */
	InputStream connect(URL url) throws IOException;

	/**
	 * Connect to the specified URL, also returning the ETag if available.
	 * 
	 * @param url
	 *            The remote URL.
	 * @return An instance of {@link TaggedData}; note that the
	 *         {@link TaggedData#getTag()} method may return
	 *         {@code null} if the resource has no tag.
	 * @throws IOException
	 * @since 1.1
	 */
	TaggedData connectTagged(URL url) throws IOException;

	/**
	 * Connect to the specified URL while providing the last known tag for the
	 * remote resource; the response will be {@code null} if the remote resource
	 * is unchanged.
	 * 
	 * @param url
	 *            The remote URL.
	 * @param tag
	 *            The last known tag value for the resource.
	 * @return An instance of {@link TaggedData}, or {@code null} if the
	 *         resource has not modified (i.e., if it has the same tag value).
	 * @throws IOException
	 * @since 1.1
	 */
	TaggedData connectTagged(URL url, String tag) throws IOException;

}