net.sf.fsp.fsplib

Class FSPURLConnection

java.lang.Object

java.net.URLConnection

net.sf.fsp.fsplib.FSPURLConnection

public class FSPURLConnection
extends URLConnection

class for operations on FSP URL.

Since:

1.0

Version:

1.0rc11

Author:

Radim Kolar

Field Summary

Fields inherited from class java.net.URLConnection

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

Constructor Summary

Constructors

Constructor and Description
FSPURLConnection(URL u) creates a new URL connection with FSP protocol.

Method Summary

Modifier and Type	Method and Description
void	connect() gets file status from FSP server throws IOException if there is problem with server communication
int	getConnectTimeout() Get connection timeout.
String	getContentEncoding() FSP do not have concept of transfer encodings.
int	getContentLength() Get content-length.
String	getContentType() Get content type.
long	getDate() Get date of sending server.
static boolean	getDefaultAllowUserInteraction() Returns default value for allowUserInteraction field.
boolean	getDefaultUseCaches() Returns default value for useCaches.
long	getExpiration() Get value of Expires: header.
String	getHeaderField(int n) Returns value of nth header field.
String	getHeaderField(String name) Returns value of specified header field.
long	getHeaderFieldDate(String name, long Default) Return value of header field parsed as date.
int	getHeaderFieldInt(String name, int Default) Return value of header field parsed as integer.
String	getHeaderFieldKey(int n) Return field (header) name for nth header field.
Map	getHeaderFields() Return unmodifiable Map of header fields.
InputStream	getInputStream() returns input stream of file from FSPserver.
long	getLastModified() Return last-modified value for file or 0 if not known
OutputStream	getOutputStream() Returns an output stream that writes to this URL
Permission	getPermission() Permission needed for creating connection to this URL
boolean	getUseCaches() Get value of useCaches property

Methods inherited from class java.net.URLConnection

addRequestProperty, getAllowUserInteraction, getContent, getContent, getContentLengthLong, getDefaultRequestProperty, getDoInput, getDoOutput, getFileNameMap, getHeaderFieldLong, getIfModifiedSince, getReadTimeout, getRequestProperties, getRequestProperty, getURL, 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, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

FSPURLConnection

public FSPURLConnection(URL u)

creates a new URL connection with FSP protocol.

Parameters:

u - FSP URL of target

Since:

1.0

Method Detail

connect

public void connect()
             throws IOException

gets file status from FSP server throws IOException if there is problem with server communication

Specified by:

connect in class URLConnection

Throws:

IOException

Since:

1.0

getConnectTimeout

public int getConnectTimeout()

Get connection timeout.

Overrides:

getConnectTimeout in class URLConnection

Returns:

FSP session timeout (ms)

Since:

1.0rc8

getContentEncoding

public String getContentEncoding()

FSP do not have concept of transfer encodings. All files are transfered in 8bit binary. This encoding is usually called "identity". Because this encoding should not be used in Content-Encoding http/1.1 reply header we return null here.

Overrides:

getContentEncoding in class URLConnection

Returns:

null

Since:

1.0rc8

getContentLength

public int getContentLength()

Get content-length. FSP v2 protocol support files up to 4 GB long. This function is not 64-bit LFS safe, it will return negative number for files 2-4GB long.

Overrides:

getContentLength in class URLConnection

Returns:

file size in bytes

Since:

1.0rc8

getContentType

public String getContentType()

Get content type. FSP v2 protocol does not supports content-type.

Overrides:

getContentType in class URLConnection

Returns:

null - content type not known

Since:

1.0rc8

getDate

public long getDate()

Get date of sending server. FSP protocol does not support it.

Overrides:

getDate in class URLConnection

Returns:

0

Since:

1.0rc8

getDefaultAllowUserInteraction

public static boolean getDefaultAllowUserInteraction()

Returns default value for allowUserInteraction field. Because there is no password support, default value is false.

Returns:

false

Since:

1.0rc8

getDefaultUseCaches

public boolean getDefaultUseCaches()

Returns default value for useCaches. We don't support caches.

Overrides:

getDefaultUseCaches in class URLConnection

Returns:

false

Since:

1.0rc8

getExpiration

public long getExpiration()

Get value of Expires: header. FSP protocol does not support headers.

Overrides:

getExpiration in class URLConnection

Returns:

0

Since:

1.0rc8

getHeaderField

public String getHeaderField(int n)

Returns value of nth header field.

Overrides:

getHeaderField in class URLConnection

Parameters:

n - field index, starting at zero

Returns:

null if there are fewer than n+1 fields

Since:

1.0rc8

getHeaderField

public String getHeaderField(String name)

Returns value of specified header field.

Only "last-modified" and "content-length" are supported.

Overrides:

getHeaderField in class URLConnection

Parameters:

name - header field name in lower case

Returns:

header field value or null if no such header is found

Since:

1.0

getHeaderFieldDate

public long getHeaderFieldDate(String name,
                               long Default)

Return value of header field parsed as date.

Overrides:

getHeaderFieldDate in class URLConnection

Parameters:

name - field name. Only "last-modified" is supported

Default - default value returned if no such header exists

Returns:

header value in standard Java time units (ms)

Since:

1.0rc8

getHeaderFieldInt

public int getHeaderFieldInt(String name,
                             int Default)

Return value of header field parsed as integer.

Overrides:

getHeaderFieldInt in class URLConnection

Parameters:

name - field name. only "content-length" is supported

Default - default value returned if no such header exists

Returns:

integer value of header

Since:

1.0rc8

getHeaderFieldKey

public String getHeaderFieldKey(int n)

Return field (header) name for nth header field.

Overrides:

getHeaderFieldKey in class URLConnection

Parameters:

n - field index, starting at zero

Returns:

header field name or null if there are fewer than n+1 fields

Since:

1.0rc8

getHeaderFields

public Map getHeaderFields()

Return unmodifiable Map of header fields.

Overrides:

getHeaderFields in class URLConnection

Returns:

Map <String,List<String>>

Since:

1.0rc8

getInputStream

public InputStream getInputStream()
                           throws IOException

returns input stream of file from FSPserver.

Overrides:

getInputStream in class URLConnection

Throws:

IOException

Since:

1.0

getLastModified

public long getLastModified()

Return last-modified value for file or 0 if not known

Overrides:

getLastModified in class URLConnection

Since:

1.0rc8

getOutputStream

public OutputStream getOutputStream()

Returns an output stream that writes to this URL

Overrides:

getOutputStream in class URLConnection

Since:

1.0rc8

getPermission

public Permission getPermission()

Permission needed for creating connection to this URL

Overrides:

getPermission in class URLConnection

Since:

1.0rc8

getUseCaches

public boolean getUseCaches()

Get value of useCaches property

Overrides:

getUseCaches in class URLConnection

Returns:

false. Cache is not supported

Since:

1.0rc8