gnu.java.net.protocol.file

Class Connection


public class Connection
extends URLConnection

This subclass of java.net.URLConnection models a URLConnection via the "file" protocol.

Field Summary

Fields inherited from class java.net.URLConnection

allowUserInteraction, connected, doInput, doOutput, ifModifiedSince, url, useCaches

Constructor Summary

Connection(URL url)
Calls superclass constructor to initialize.

Method Summary

void
connect()
"Connects" to the file by opening it.
int
getContentLength()
Get the length of content.
String
getHeaderField(String field)
Get an http-style header field.
InputStream
getInputStream()
Opens the file for reading and returns a stream for it.
long
getLastModified()
Get the last modified time of the resource.
OutputStream
getOutputStream()
Opens the file for writing and returns a stream for it.
Permission
getPermission()
This method returns a Permission object representing the permissions required to access this URL.
static String
unquote(String str)
Unquote "%" + hex quotes characters

Methods inherited from class java.net.URLConnection

addRequestProperty, connect, getAllowUserInteraction, getConnectTimeout, getContent, getContent, getContentEncoding, getContentLength, getContentType, getDate, getDefaultAllowUserInteraction, getDefaultRequestProperty, getDefaultUseCaches, getDoInput, getDoOutput, getExpiration, getFileNameMap, getHeaderField, getHeaderField, getHeaderFieldDate, getHeaderFieldInt, getHeaderFieldKey, getHeaderFields, getIfModifiedSince, getInputStream, getLastModified, getOutputStream, getPermission, getReadTimeout, getRequestProperties, getRequestProperty, getURL, getUseCaches, guessContentTypeFromName, guessContentTypeFromStream, setAllowUserInteraction, setConnectTimeout, setContentHandlerFactory, setDefaultAllowUserInteraction, setDefaultRequestProperty, setDefaultUseCaches, setDoInput, setDoOutput, setFileNameMap, setIfModifiedSince, setReadTimeout, setRequestProperty, setUseCaches, toString

Methods inherited from class java.lang.Object

clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Connection

public Connection(URL url)
Calls superclass constructor to initialize.

Method Details

connect

public void connect()
            throws IOException
"Connects" to the file by opening it.
Overrides:
connect in interface URLConnection

getContentLength

public int getContentLength()
Get the length of content.
Overrides:
getContentLength in interface URLConnection
Returns:
the length of the content.

getHeaderField

public String getHeaderField(String field)
Get an http-style header field. Just handle a few common ones.
Overrides:
getHeaderField in interface URLConnection

getInputStream

public InputStream getInputStream()
            throws IOException
Opens the file for reading and returns a stream for it.
Overrides:
getInputStream in interface URLConnection
Returns:
An InputStream for this connection.
Throws:
IOException - If an error occurs

getLastModified

public long getLastModified()
Get the last modified time of the resource.
Overrides:
getLastModified in interface URLConnection
Returns:
the time since epoch that the resource was modified.

getOutputStream

public OutputStream getOutputStream()
            throws IOException
Opens the file for writing and returns a stream for it.
Overrides:
getOutputStream in interface URLConnection
Returns:
An OutputStream for this connection.
Throws:
IOException - If an error occurs.

getPermission

public Permission getPermission()
            throws IOException
This method returns a Permission object representing the permissions required to access this URL. This method returns a java.io.FilePermission for the file's path with a read permission.
Overrides:
getPermission in interface URLConnection
Returns:
A Permission object

unquote

public static String unquote(String str)
            throws MalformedURLException
Unquote "%" + hex quotes characters
Parameters:
str - The string to unquote or null.
Returns:
The unquoted string or null if str was null.
Throws:
MalformedURLException - If the given string contains invalid escape sequences.

FileURLConnection.java -- URLConnection class for "file" protocol Copyright (C) 1998, 1999, 2003 Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath 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, or (at your option) any later version. GNU Classpath 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 GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.