oracle.ide.net

Class HttpURLFileSystemHelper

java.lang.Object

oracle.ide.net.URLFileSystemHelper

oracle.ide.net.HttpURLFileSystemHelper

public class HttpURLFileSystemHelper
extends URLFileSystemHelper

The HttpURLFileSystemHelper class provides an implementation of URLFileSystemHelper for http URLs.

Constructor Summary

Constructors

Modifier	Constructor and Description
	HttpURLFileSystemHelper() Create the default version of this operation that accesses information using a GET.
protected	HttpURLFileSystemHelper(java.lang.String requestMethod, java.lang.String quickMethod) Allow the client to specify the HTTP methods used for the request and metadata operations.

Method Summary

Modifier and Type	Method and Description
boolean	canCreate(java.net.URL url) Tests whether the application can create the resource at the specified URL.
boolean	exists(java.net.URL url) Returns true if the specified URL points to a resource that currently exists; returns false otherwise.
static int	getConnectionTimeout()
long	getLength(java.net.URL url) Returns the number of bytes contained in the resource that the specified URL points to.
java.net.URL	getParent(java.net.URL url) Returns the URL representing the parent directory of the specified URL.
protected int	getPort(java.net.URL url)
java.lang.String	getSystemDisplayName(java.net.URL url) Returns the name of a resource as it would be displayed in a system file browser.
static boolean	isUnreachable(java.net.URL url)
long	lastModified(java.net.URL url) Returns the last modification time (timestamp) of the resource indicated by the specified URL in milliseconds since 00:00:00 GMT, Jan 1, 1970.
static void	markUnreachable(java.net.URL url)
protected java.net.URLConnection	openConnection(java.net.URL url) Open a HttpURConnection, it might be required to clear up the protocol of the URL if we are using one of the extended types such as http-OPTIONS.
java.io.InputStream	openInputStream(java.net.URL url) Opens an InputStream on the specified URL.

Methods inherited from class oracle.ide.net.URLFileSystemHelper

addURLFileSystemListener, appendRelativePath, areEqual, areEqualPathElems, canDelete, canonicalize, canRead, canWrite, code, convertSuffix, createReader, createTempFile, delete, ensureSuffix, equals, getBaseParent, getDefaultIcon, getFileName, getName, getPath, getPathNoExt, getPlatformPathName, getSuffix, getSystemIcon, getTempDirectory, hashCode, hasSuffix, haveSameAuthority, haveSameHost, haveSamePath, haveSamePort, haveSameProtocol, haveSameQuery, haveSameRef, haveSameUserInfo, isBaseURLFor, isDirectory, isDirectoryPath, isHidden, isLocal, isReadOnly, isRegularFile, isValid, list, list, list, listRoots, ls, ls, lsCached, lsCached, mkdir, mkdirs, openOutputStream, removeURLFileSystemListener, rename, setLastModified, setReadOnly, toDisplayString, toEncodedString, toEncodedString, toRelativeSpec, toRelativeSpec, verifyList

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpURLFileSystemHelper

public HttpURLFileSystemHelper()

Create the default version of this operation that accesses information using a GET.

HttpURLFileSystemHelper

protected HttpURLFileSystemHelper(java.lang.String requestMethod,
                                  java.lang.String quickMethod)

Allow the client to specify the HTTP methods used for the request and metadata operations. Primary usecase is the Jersey WADL that is fetched using the OPTIONS operation.

Method Detail

getConnectionTimeout

public static int getConnectionTimeout()

Returns:

the default connection timeout for http request in milliseconds

getSystemDisplayName

public java.lang.String getSystemDisplayName(java.net.URL url)

Returns the name of a resource as it would be displayed in a system file browser.

Overrides:

getSystemDisplayName in class URLFileSystemHelper

Parameters:

url - the URL of the resource

Returns:

the display name as a string

See Also:

URLFileSystemHelper.getSystemIcon(URL)

getLength

public long getLength(java.net.URL url)

Returns the number of bytes contained in the resource that the specified URL points to. If the length cannot be determined, -1 is returned.

The default implementation attempts to get the content length from the URLConnection associated with the URL. If that fails for some reason (e.g. the resource does not exist, there was some other an I/O exception, etc.), -1 is returned.

Overrides:

getLength in class URLFileSystemHelper

See Also:

URLConnection

lastModified

public long lastModified(java.net.URL url)

Returns the last modification time (timestamp) of the resource indicated by the specified URL in milliseconds since 00:00:00 GMT, Jan 1, 1970. If the timestamp can't be determined, -1 is returned.

The default implementation attemps to get the last modified time from the URLConnection associated with the URL. If that fails for some reason (e.g. the resource does not exist, there was some other I/O exception, etc.), -1 is returned.

Overrides:

lastModified in class URLFileSystemHelper

See Also:

URLConnection

exists

public boolean exists(java.net.URL url)

Description copied from class: URLFileSystemHelper

Returns true if the specified URL points to a resource that currently exists; returns false otherwise.

The default implementation simply returns false without doing anything.

Overrides:

exists in class URLFileSystemHelper

canCreate

public boolean canCreate(java.net.URL url)

Tests whether the application can create the resource at the specified URL.

Overrides:

canCreate in class URLFileSystemHelper

Returns:

true if the resource at the specified URL exists or can be created; false otherwise.

getParent

public java.net.URL getParent(java.net.URL url)

Description copied from class: URLFileSystemHelper

Returns the URL representing the parent directory of the specified URL. If there is no parent directory, then null is returned.

The default implementation returns the value of invoking URLFactory.newURL( url, ".." ), removing the reference portion of the URL.

Overrides:

getParent in class URLFileSystemHelper

openInputStream

public java.io.InputStream openInputStream(java.net.URL url)
                                    throws java.io.IOException

Opens an InputStream on the specified URL.

The default implementation attempts to open the InputStream through the URLConnection associated with the URL. If the URLConnection implementation does not support an InputStream then an UnknownServiceException (a runtime exception) will be thrown.

Overrides:

openInputStream in class URLFileSystemHelper

Throws:

java.io.FileNotFoundException - if the resource at the specified URL does not exist.

java.io.IOException - if an I/O error occurs when trying to open the InputStream.

java.net.UnknownServiceException - if the URLConnection backing the specified URL does not support an InputStream.

See Also:

IOException, URLConnection, UnknownServiceException

openConnection

protected java.net.URLConnection openConnection(java.net.URL url)
                                         throws java.io.IOException

Open a HttpURConnection, it might be required to clear up the protocol of the URL if we are using one of the extended types such as http-OPTIONS. Default the request method to be the default request method for this type.

Parameters:

url -

Returns:

the open connection

Throws:

java.io.IOException

isUnreachable

public static boolean isUnreachable(java.net.URL url)

Parameters:

url - The host to check

Returns:

Whether the given host has been marked as unreachable for the current proxy

markUnreachable

public static void markUnreachable(java.net.URL url)

Parameters:

url - the host to note as unreachable

getPort

protected int getPort(java.net.URL url)

Overrides:

getPort in class URLFileSystemHelper