public Class FileURLConnection

Implements abstract java.net.URLConnection.connect.

If already connected, then this method is a no-op. If not already connected, then this method does readability checks for the File.

If the File is a directory then the readability check is done by verifying that File.list() does not return null. On the other hand, if the File is not a directory, then this method constructs a temporary FileInputStream for the File and lets the FileInputStream's constructor implementation do the necessary readability checks. That temporary FileInputStream is closed before returning from this method.

In either case, if the readability checks fail, then an IOException is thrown from this method and the FileURLConnection stays unconnected.

A normal return from this method implies that the FileURLConnection is connected and the readability checks have passed for the File.

Annotations

@Override

Exceptions

IOException:

Doc from java.net.URLConnection.connect.

if an I/O error occurs while opening the connection.

Overrides sun.net.www.URLConnection.getContentLength.

Doc from sun.net.www.URLConnection.getContentLength.

Call this routine to get the content-length associated with this object.

Annotations

@Override

Overrides java.net.URLConnection.getContentLengthLong.

Doc from java.net.URLConnection.getContentLengthLong.

Returns the value of the content-length header field as a long.

Annotations

@Override

Overrides sun.net.www.URLConnection.getHeaderField.

Doc from java.net.URLConnection.getHeaderField.

Returns the value of the named header field.

If called on a connection that sets the same header multiple times with possibly different values, only the last value is returned.

Annotations

@Override

Overrides sun.net.www.URLConnection.getHeaderField.

Doc from sun.net.www.URLConnection.getHeaderField.

Return the value for the nth header field. Returns null if there are fewer than n fields. This can be used in conjunction with getHeaderFieldKey to iterate through all the headers in the message.

Annotations

@Override

Overrides sun.net.www.URLConnection.getHeaderFieldKey.

Doc from sun.net.www.URLConnection.getHeaderFieldKey.

Return the key for the nth header field. Returns null if there are fewer than n fields. This can be used to iterate through all the headers in the message.

Annotations

@Override

Overrides sun.net.www.URLConnection.getHeaderFields.

Doc from java.net.URLConnection.getHeaderFields.

Returns an unmodifiable Map of the header fields. The Map keys are Strings that represent the response-header field names. Each Map value is an unmodifiable List of Strings that represents the corresponding field values. This method is overridden by the subclasses of URLConnection. In the implementation of these methods, if a given key has multiple corresponding values, they must be returned in the order they were added, preserving the insertion-order.

Annotations

@Override

Overrides java.net.URLConnection.getInputStream.

Doc from java.net.URLConnection.getInputStream.

Returns an input stream that reads from this open connection. A SocketTimeoutException can be thrown when reading from the returned input stream if the read timeout expires before data is available for read.

Annotations

@Override

Exceptions

IOException:

if an I/O error occurs while creating the input stream.

Overrides java.net.URLConnection.getLastModified.

Doc from java.net.URLConnection.getLastModified.

Returns the value of the last-modified header field. The result is the number of milliseconds since January 1, 1970 GMT.

Annotations

@Override

Overrides java.net.URLConnection.getPermission.

Doc from java.net.URLConnection.getPermission.

Returns a permission object representing the permission necessary to make the connection represented by this object. This method returns null if no permission is required to make the connection. By default, this method returns java.security.AllPermission. Subclasses should override this method and return the permission that best represents the permission required to make a connection to the URL. For example, a URLConnection representing a file: URL would return a java.io.FilePermission object.

The permission returned may dependent upon the state of the connection. For example, the permission before connecting may be different from that after connecting. For example, an HTTP sever, say foo.com, may redirect the connection to a different host, say bar.com. Before connecting the permission returned by the connection will represent the permission needed to connect to foo.com, while the permission returned after connecting will be to bar.com.

Permissions are generally used for two purposes: to protect caches of objects obtained through URLConnections, and to check the right of a recipient to learn about a particular URL. In the first case, the permission should be obtained after the object has been obtained. For example, in an HTTP connection, this will represent the permission to connect to the host from which the data was ultimately fetched. In the second case, the permission should be obtained and tested before connecting.

Annotations

@Override

@Deprecated

since:25

forRemoval:true

@SuppressWarnings:removal

Exceptions

IOException:

if the computation of the permission requires network or file I/O and an exception occurs while computing it.

Overrides sun.net.www.URLConnection.getProperties.

Doc from sun.net.www.URLConnection.getProperties.

Call this routine to get the property list for this object. Properties (like content-type) that have explicit getXX() methods associated with them should be accessed using those methods.

Annotations

@Override