Methods Summary |
---|
public void | addRequestProperty(java.lang.String key, java.lang.String value)Adds a general request property specified by a
key-value pair. This method will not overwrite
existing values associated with the same key.
if (connected)
throw new IllegalStateException("Already connected");
if (key == null)
throw new NullPointerException ("key is null");
|
private static boolean | checkfpx(java.io.InputStream is)Check for FlashPix image data in InputStream is. Return true if
the stream has FlashPix data, false otherwise. Before calling this
method, the stream should have already been checked to be sure it
contains Microsoft Structured Storage data.
/* Test for FlashPix image data in Microsoft Structured Storage format.
* In general, should do this with calls to an SS implementation.
* Lacking that, need to dig via offsets to get to the FlashPix
* ClassID. Details:
*
* Offset to Fpx ClsID from beginning of stream should be:
*
* FpxClsidOffset = rootEntryOffset + clsidOffset
*
* where: clsidOffset = 0x50.
* rootEntryOffset = headerSize + sectorSize*sectDirStart
* + 128*rootEntryDirectory
*
* where: headerSize = 0x200 (always)
* sectorSize = 2 raised to power of uSectorShift,
* which is found in the header at
* offset 0x1E.
* sectDirStart = found in the header at offset 0x30.
* rootEntryDirectory = in general, should search for
* directory labelled as root.
* We will assume value of 0 (i.e.,
* rootEntry is in first directory)
*/
// Mark the stream so we can reset it. 0x100 is enough for the first
// few reads, but the mark will have to be reset and set again once
// the offset to the root directory entry is computed. That offset
// can be very large and isn't know until the stream has been read from
is.mark(0x100);
// Get the byte ordering located at 0x1E. 0xFE is Intel,
// 0xFF is other
long toSkip = (long)0x1C;
long posn;
if ((posn = skipForward(is, toSkip)) < toSkip) {
is.reset();
return false;
}
int c[] = new int[16];
if (readBytes(c, 2, is) < 0) {
is.reset();
return false;
}
int byteOrder = c[0];
posn+=2;
int uSectorShift;
if (readBytes(c, 2, is) < 0) {
is.reset();
return false;
}
if(byteOrder == 0xFE) {
uSectorShift = c[0];
uSectorShift += c[1] << 8;
}
else {
uSectorShift = c[0] << 8;
uSectorShift += c[1];
}
posn += 2;
toSkip = (long)0x30 - posn;
long skipped = 0;
if ((skipped = skipForward(is, toSkip)) < toSkip) {
is.reset();
return false;
}
posn += skipped;
if (readBytes(c, 4, is) < 0) {
is.reset();
return false;
}
int sectDirStart;
if(byteOrder == 0xFE) {
sectDirStart = c[0];
sectDirStart += c[1] << 8;
sectDirStart += c[2] << 16;
sectDirStart += c[3] << 24;
} else {
sectDirStart = c[0] << 24;
sectDirStart += c[1] << 16;
sectDirStart += c[2] << 8;
sectDirStart += c[3];
}
posn += 4;
is.reset(); // Reset back to the beginning
toSkip = (long)0x200 +
(long)((int)1<<uSectorShift)*sectDirStart + (long)0x50;
// Sanity check!
if (toSkip < 0) {
return false;
}
/*
* How far can we skip? Is there any performance problem here?
* This skip can be fairly long, at least 0x4c650 in at least
* one case. Have to assume that the skip will fit in an int.
* Leave room to read whole root dir
*/
is.mark((int)toSkip+0x30);
if ((skipForward(is, toSkip)) < toSkip) {
is.reset();
return false;
}
/* should be at beginning of ClassID, which is as follows
* (in Intel byte order):
* 00 67 61 56 54 C1 CE 11 85 53 00 AA 00 A1 F9 5B
*
* This is stored from Windows as long,short,short,char[8]
* so for byte order changes, the order only changes for
* the first 8 bytes in the ClassID.
*
* Test against this, ignoring second byte (Intel) since
* this could change depending on part of Fpx file we have.
*/
if (readBytes(c, 16, is) < 0) {
is.reset();
return false;
}
// intel byte order
if (byteOrder == 0xFE &&
c[0] == 0x00 && c[2] == 0x61 && c[3] == 0x56 &&
c[4] == 0x54 && c[5] == 0xC1 && c[6] == 0xCE &&
c[7] == 0x11 && c[8] == 0x85 && c[9] == 0x53 &&
c[10]== 0x00 && c[11]== 0xAA && c[12]== 0x00 &&
c[13]== 0xA1 && c[14]== 0xF9 && c[15]== 0x5B) {
is.reset();
return true;
}
// non-intel byte order
else if (c[3] == 0x00 && c[1] == 0x61 && c[0] == 0x56 &&
c[5] == 0x54 && c[4] == 0xC1 && c[7] == 0xCE &&
c[6] == 0x11 && c[8] == 0x85 && c[9] == 0x53 &&
c[10]== 0x00 && c[11]== 0xAA && c[12]== 0x00 &&
c[13]== 0xA1 && c[14]== 0xF9 && c[15]== 0x5B) {
is.reset();
return true;
}
is.reset();
return false;
|
public abstract void | connect()Opens a communications link to the resource referenced by this
URL, if such a connection has not already been established.
If the connect method is called when the connection
has already been opened (indicated by the connected
field having the value true ), the call is ignored.
URLConnection objects go through two phases: first they are
created, then they are connected. After being created, and
before being connected, various options can be specified
(e.g., doInput and UseCaches). After connecting, it is an
error to try to set them. Operations that depend on being
connected, like getContentLength, will implicitly perform the
connection, if necessary.
|
public boolean | getAllowUserInteraction()Returns the value of the allowUserInteraction field for
this object.
return allowUserInteraction;
|
public int | getConnectTimeout()Returns setting for connect timeout.
0 return implies that the option is disabled
(i.e., timeout of infinity).
return connectTimeout;
|
public java.lang.Object | getContent()Retrieves the contents of this URL connection.
This method first determines the content type of the object by
calling the getContentType method. If this is
the first time that the application has seen that specific content
type, a content handler for that content type is created:
- If the application has set up a content handler factory instance
using the
setContentHandlerFactory method, the
createContentHandler method of that instance is called
with the content type as an argument; the result is a content
handler for that content type.
- If no content handler factory has yet been set up, or if the
factory's
createContentHandler method returns
null , then the application loads the class named:
sun.net.www.content.<contentType>
where <contentType> is formed by taking the
content-type string, replacing all slash characters with a
period ('.'), and all other non-alphanumeric characters
with the underscore character '_ '. The alphanumeric
characters are specifically the 26 uppercase ASCII letters
'A ' through 'Z ', the 26 lowercase ASCII
letters 'a ' through 'z ', and the 10 ASCII
digits '0 ' through '9 '. If the specified
class does not exist, or is not a subclass of
ContentHandler , then an
UnknownServiceException is thrown.
// Must call getInputStream before GetHeaderField gets called
// so that FileNotFoundException has a chance to be thrown up
// from here without being caught.
getInputStream();
return getContentHandler().getContent(this);
|
public java.lang.Object | getContent(java.lang.Class[] classes)Retrieves the contents of this URL connection.
// Must call getInputStream before GetHeaderField gets called
// so that FileNotFoundException has a chance to be thrown up
// from here without being caught.
getInputStream();
return getContentHandler().getContent(this, classes);
|
public java.lang.String | getContentEncoding()Returns the value of the content-encoding header field.
return getHeaderField("content-encoding");
|
synchronized java.net.ContentHandler | getContentHandler()Gets the Content Handler appropriate for this connection.
String contentType = stripOffParameters(getContentType());
ContentHandler handler = null;
if (contentType == null)
throw new UnknownServiceException("no content-type");
try {
handler = (ContentHandler) handlers.get(contentType);
if (handler != null)
return handler;
} catch(Exception e) {
}
if (factory != null)
handler = factory.createContentHandler(contentType);
if (handler == null) {
try {
handler = lookupContentHandlerClassFor(contentType);
} catch(Exception e) {
e.printStackTrace();
handler = UnknownContentHandlerP;
}
handlers.put(contentType, handler);
}
return handler;
|
private java.lang.String | getContentHandlerPkgPrefixes()Returns a vertical bar separated list of package prefixes for potential
content handlers. Tries to get the java.content.handler.pkgs property
to use as a set of package prefixes to search. Whether or not
that property has been defined, the sun.net.www.content is always
the last one on the returned package list.
String packagePrefixList = (String) AccessController.doPrivileged(
new sun.security.action.GetPropertyAction(contentPathProp, ""));
if (packagePrefixList != "") {
packagePrefixList += "|";
}
return packagePrefixList + contentClassPrefix;
|
public int | getContentLength()Returns the value of the content-length header field.
return getHeaderFieldInt("content-length", -1);
|
public java.lang.String | getContentType()Returns the value of the content-type header field.
return getHeaderField("content-type");
|
public long | getDate()Returns the value of the date header field.
return getHeaderFieldDate("date", 0);
|
public static boolean | getDefaultAllowUserInteraction()Returns the default value of the allowUserInteraction
field.
Ths default is "sticky", being a part of the static state of all
URLConnections. This flag applies to the next, and all following
URLConnections that are created.
return defaultAllowUserInteraction;
|
public static java.lang.String | getDefaultRequestProperty(java.lang.String key)Returns the value of the default request property. Default request
properties are set for every connection.
return null;
|
public boolean | getDefaultUseCaches()Returns the default value of a URLConnection 's
useCaches flag.
Ths default is "sticky", being a part of the static state of all
URLConnections. This flag applies to the next, and all following
URLConnections that are created.
return defaultUseCaches;
|
public boolean | getDoInput()Returns the value of this URLConnection 's
doInput flag.
return doInput;
|
public boolean | getDoOutput()Returns the value of this URLConnection 's
doOutput flag.
return doOutput;
|
public long | getExpiration()Returns the value of the expires header field.
return getHeaderFieldDate("expires", 0);
|
public static synchronized java.net.FileNameMap | getFileNameMap()Loads filename map (a mimetable) from a data file. It will
first try to load the user-specific table, defined
by "content.types.user.table" property. If that fails,
it tries to load the default built-in table at
lib/content-types.properties under java home.
if ((fileNameMap == null) && !fileNameMapLoaded) {
fileNameMap = sun.net.www.MimeTable.loadTable();
fileNameMapLoaded = true;
}
return new FileNameMap() {
private FileNameMap map = fileNameMap;
public String getContentTypeFor(String fileName) {
return map.getContentTypeFor(fileName);
}
};
|
public java.lang.String | getHeaderField(java.lang.String name)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.
return null;
|
public java.lang.String | getHeaderField(int n)Returns the value for the n th header field.
It returns null if there are fewer than
n+1 fields.
This method can be used in conjunction with the
{@link #getHeaderFieldKey(int) getHeaderFieldKey} method to iterate through all
the headers in the message.
return null;
|
public long | getHeaderFieldDate(java.lang.String name, long Default)Returns the value of the named field parsed as date.
The result is the number of milliseconds since January 1, 1970 GMT
represented by the named field.
This form of getHeaderField exists because some
connection types (e.g., http-ng ) have pre-parsed
headers. Classes for that connection type can override this method
and short-circuit the parsing.
String value = getHeaderField(name);
try {
return Date.parse(value);
} catch (Exception e) { }
return Default;
|
public int | getHeaderFieldInt(java.lang.String name, int Default)Returns the value of the named field parsed as a number.
This form of getHeaderField exists because some
connection types (e.g., http-ng ) have pre-parsed
headers. Classes for that connection type can override this method
and short-circuit the parsing.
String value = getHeaderField(name);
try {
return Integer.parseInt(value);
} catch (Exception e) { }
return Default;
|
public java.lang.String | getHeaderFieldKey(int n)Returns the key for the n th header field.
It returns null if there are fewer than n+1 fields.
return null;
|
public java.util.Map | 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.
return Collections.EMPTY_MAP;
|
public long | getIfModifiedSince()Returns the value of this object's ifModifiedSince field.
return ifModifiedSince;
|
public java.io.InputStream | 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.
throw new UnknownServiceException("protocol doesn't support input");
|
public long | getLastModified()Returns the value of the last-modified header field.
The result is the number of milliseconds since January 1, 1970 GMT.
return getHeaderFieldDate("last-modified", 0);
|
public java.io.OutputStream | getOutputStream()Returns an output stream that writes to this connection.
throw new UnknownServiceException("protocol doesn't support output");
|
public java.security.Permission | 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
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.
return SecurityConstants.ALL_PERMISSION;
|
public int | getReadTimeout()Returns setting for read timeout. 0 return implies that the
option is disabled (i.e., timeout of infinity).
return readTimeout;
|
public java.util.Map | getRequestProperties()Returns an unmodifiable Map of general request
properties for this connection. The Map keys
are Strings that represent the request-header
field names. Each Map value is a unmodifiable List
of Strings that represents the corresponding
field values.
if (connected)
throw new IllegalStateException("Already connected");
return Collections.EMPTY_MAP;
|
public java.lang.String | getRequestProperty(java.lang.String key)Returns the value of the named general request property for this
connection.
if (connected)
throw new IllegalStateException("Already connected");
return null;
|
public java.net.URL | getURL()Returns the value of this URLConnection 's URL
field.
return url;
|
public boolean | getUseCaches()Returns the value of this URLConnection 's
useCaches field.
return useCaches;
|
public static java.lang.String | guessContentTypeFromName(java.lang.String fname)Tries to determine the content type of an object, based
on the specified "file" component of a URL.
This is a convenience method that can be used by
subclasses that override the getContentType method.
return getFileNameMap().getContentTypeFor(fname);
|
public static java.lang.String | guessContentTypeFromStream(java.io.InputStream is)Tries to determine the type of an input stream based on the
characters at the beginning of the input stream. This method can
be used by subclasses that override the
getContentType method.
Ideally, this routine would not be needed. But many
http servers return the incorrect content type; in
addition, there are many nonstandard extensions. Direct inspection
of the bytes to determine the content type is often more accurate
than believing the content type claimed by the http server.
// If we can't read ahead safely, just give up on guessing
if (!is.markSupported())
return null;
is.mark(12);
int c1 = is.read();
int c2 = is.read();
int c3 = is.read();
int c4 = is.read();
int c5 = is.read();
int c6 = is.read();
int c7 = is.read();
int c8 = is.read();
int c9 = is.read();
int c10 = is.read();
int c11 = is.read();
is.reset();
if (c1 == 0xCA && c2 == 0xFE && c3 == 0xBA && c4 == 0xBE) {
return "application/java-vm";
}
if (c1 == 0xAC && c2 == 0xED) {
// next two bytes are version number, currently 0x00 0x05
return "application/x-java-serialized-object";
}
if (c1 == '<") {
if (c2 == '!"
|| ((c2 == 'h" && (c3 == 't" && c4 == 'm" && c5 == 'l" ||
c3 == 'e" && c4 == 'a" && c5 == 'd") ||
(c2 == 'b" && c3 == 'o" && c4 == 'd" && c5 == 'y"))) ||
((c2 == 'H" && (c3 == 'T" && c4 == 'M" && c5 == 'L" ||
c3 == 'E" && c4 == 'A" && c5 == 'D") ||
(c2 == 'B" && c3 == 'O" && c4 == 'D" && c5 == 'Y")))) {
return "text/html";
}
if (c2 == '?" && c3 == 'x" && c4 == 'm" && c5 == 'l" && c6 == ' ") {
return "application/xml";
}
}
// big and little endian UTF-16 encodings, with byte order mark
if (c1 == 0xfe && c2 == 0xff) {
if (c3 == 0 && c4 == '<" && c5 == 0 && c6 == '?" &&
c7 == 0 && c8 == 'x") {
return "application/xml";
}
}
if (c1 == 0xff && c2 == 0xfe) {
if (c3 == '<" && c4 == 0 && c5 == '?" && c6 == 0 &&
c7 == 'x" && c8 == 0) {
return "application/xml";
}
}
if (c1 == 'G" && c2 == 'I" && c3 == 'F" && c4 == '8") {
return "image/gif";
}
if (c1 == '#" && c2 == 'd" && c3 == 'e" && c4 == 'f") {
return "image/x-bitmap";
}
if (c1 == '!" && c2 == ' " && c3 == 'X" && c4 == 'P" &&
c5 == 'M" && c6 == '2") {
return "image/x-pixmap";
}
if (c1 == 137 && c2 == 80 && c3 == 78 &&
c4 == 71 && c5 == 13 && c6 == 10 &&
c7 == 26 && c8 == 10) {
return "image/png";
}
if (c1 == 0xFF && c2 == 0xD8 && c3 == 0xFF) {
if (c4 == 0xE0) {
return "image/jpeg";
}
/**
* File format used by digital cameras to store images.
* Exif Format can be read by any application supporting
* JPEG. Exif Spec can be found at:
* http://www.pima.net/standards/it10/PIMA15740/Exif_2-1.PDF
*/
if ((c4 == 0xE1) &&
(c7 == 'E" && c8 == 'x" && c9 == 'i" && c10 =='f" &&
c11 == 0)) {
return "image/jpeg";
}
if (c4 == 0xEE) {
return "image/jpg";
}
}
if (c1 == 0xD0 && c2 == 0xCF && c3 == 0x11 && c4 == 0xE0 &&
c5 == 0xA1 && c6 == 0xB1 && c7 == 0x1A && c8 == 0xE1) {
/* Above is signature of Microsoft Structured Storage.
* Below this, could have tests for various SS entities.
* For now, just test for FlashPix.
*/
if (checkfpx(is)) {
return "image/vnd.fpx";
}
}
if (c1 == 0x2E && c2 == 0x73 && c3 == 0x6E && c4 == 0x64) {
return "audio/basic"; // .au format, big endian
}
if (c1 == 0x64 && c2 == 0x6E && c3 == 0x73 && c4 == 0x2E) {
return "audio/basic"; // .au format, little endian
}
if (c1 == 'R" && c2 == 'I" && c3 == 'F" && c4 == 'F") {
/* I don't know if this is official but evidence
* suggests that .wav files start with "RIFF" - brown
*/
return "audio/x-wav";
}
return null;
|
private java.net.ContentHandler | lookupContentHandlerClassFor(java.lang.String contentType)Looks for a content handler in a user-defineable set of places.
By default it looks in sun.net.www.content, but users can define a
vertical-bar delimited set of class prefixes to search through in
addition by defining the java.content.handler.pkgs property.
The class name must be of the form:
{package-prefix}.{major}.{minor}
e.g.
YoyoDyne.experimental.text.plain
String contentHandlerClassName = typeToPackageName(contentType);
String contentHandlerPkgPrefixes =getContentHandlerPkgPrefixes();
StringTokenizer packagePrefixIter =
new StringTokenizer(contentHandlerPkgPrefixes, "|");
while (packagePrefixIter.hasMoreTokens()) {
String packagePrefix = packagePrefixIter.nextToken().trim();
try {
String clsName = packagePrefix + "." + contentHandlerClassName;
Class cls = null;
try {
cls = Class.forName(clsName);
} catch (ClassNotFoundException e) {
ClassLoader cl = ClassLoader.getSystemClassLoader();
if (cl != null) {
cls = cl.loadClass(clsName);
}
}
if (cls != null) {
ContentHandler handler =
(ContentHandler)cls.newInstance();
return handler;
}
} catch(Exception e) {
}
}
return UnknownContentHandlerP;
|
private static int | readBytes(int[] c, int len, java.io.InputStream is)Tries to read the specified number of bytes from the stream
Returns -1, If EOF is reached before len bytes are read, returns 0
otherwise
byte buf[] = new byte[len];
if (is.read(buf, 0, len) < len) {
return -1;
}
// fill the passed in int array
for (int i = 0; i < len; i++) {
c[i] = buf[i] & 0xff;
}
return 0;
|
public void | setAllowUserInteraction(boolean allowuserinteraction)Set the value of the allowUserInteraction field of
this URLConnection .
if (connected)
throw new IllegalStateException("Already connected");
allowUserInteraction = allowuserinteraction;
|
public void | setConnectTimeout(int timeout)Sets a specified timeout value, in milliseconds, to be used
when opening a communications link to the resource referenced
by this URLConnection. If the timeout expires before the
connection can be established, a
java.net.SocketTimeoutException is raised. A timeout of zero is
interpreted as an infinite timeout.
Some non-standard implmentation of this method may ignore
the specified timeout. To see the connect timeout set, please
call getConnectTimeout().
if (timeout < 0) {
throw new IllegalArgumentException("timeout can not be negative");
}
connectTimeout = timeout;
|
public static synchronized void | setContentHandlerFactory(java.net.ContentHandlerFactory fac)Sets the ContentHandlerFactory of an
application. It can be called at most once by an application.
The ContentHandlerFactory instance is used to
construct a content handler from a content type
If there is a security manager, this method first calls
the security manager's checkSetFactory method
to ensure the operation is allowed.
This could result in a SecurityException.
if (factory != null) {
throw new Error("factory already defined");
}
SecurityManager security = System.getSecurityManager();
if (security != null) {
security.checkSetFactory();
}
factory = fac;
|
public static void | setDefaultAllowUserInteraction(boolean defaultallowuserinteraction)Sets the default value of the
allowUserInteraction field for all future
URLConnection objects to the specified value.
defaultAllowUserInteraction = defaultallowuserinteraction;
|
public static void | setDefaultRequestProperty(java.lang.String key, java.lang.String value)Sets the default value of a general request property. When a
URLConnection is created, it is initialized with
these properties.
|
public void | setDefaultUseCaches(boolean defaultusecaches)Sets the default value of the useCaches field to the
specified value.
defaultUseCaches = defaultusecaches;
|
public void | setDoInput(boolean doinput)Sets the value of the doInput field for this
URLConnection to the specified value.
A URL connection can be used for input and/or output. Set the DoInput
flag to true if you intend to use the URL connection for input,
false if not. The default is true.
if (connected)
throw new IllegalStateException("Already connected");
doInput = doinput;
|
public void | setDoOutput(boolean dooutput)Sets the value of the doOutput field for this
URLConnection to the specified value.
A URL connection can be used for input and/or output. Set the DoOutput
flag to true if you intend to use the URL connection for output,
false if not. The default is false.
if (connected)
throw new IllegalStateException("Already connected");
doOutput = dooutput;
|
public static void | setFileNameMap(java.net.FileNameMap map)Sets the FileNameMap.
If there is a security manager, this method first calls
the security manager's checkSetFactory method
to ensure the operation is allowed.
This could result in a SecurityException.
SecurityManager sm = System.getSecurityManager();
if (sm != null) sm.checkSetFactory();
fileNameMap = map;
|
public void | setIfModifiedSince(long ifmodifiedsince)Sets the value of the ifModifiedSince field of
this URLConnection to the specified value.
if (connected)
throw new IllegalStateException("Already connected");
ifModifiedSince = ifmodifiedsince;
|
public void | setReadTimeout(int timeout)Sets the read timeout to a specified timeout, in
milliseconds. A non-zero value specifies the timeout when
reading from Input stream when a connection is established to a
resource. If the timeout expires before there is data available
for read, a java.net.SocketTimeoutException is raised. A
timeout of zero is interpreted as an infinite timeout.
Some non-standard implementation of this method ignores the
specified timeout. To see the read timeout set, please call
getReadTimeout().
if (timeout < 0) {
throw new IllegalArgumentException("timeout can not be negative");
}
readTimeout = timeout;
|
public void | setRequestProperty(java.lang.String key, java.lang.String value)Sets the general request property. If a property with the key already
exists, overwrite its value with the new value.
NOTE: HTTP requires all request properties which can
legally have multiple instances with the same key
to use a comma-seperated list syntax which enables multiple
properties to be appended into a single property.
if (connected)
throw new IllegalStateException("Already connected");
if (key == null)
throw new NullPointerException ("key is null");
|
public void | setUseCaches(boolean usecaches)Sets the value of the useCaches field of this
URLConnection to the specified value.
Some protocols do caching of documents. Occasionally, it is important
to be able to "tunnel through" and ignore the caches (e.g., the
"reload" button in a browser). If the UseCaches flag on a connection
is true, the connection is allowed to use whatever caches it can.
If false, caches are to be ignored.
The default value comes from DefaultUseCaches, which defaults to
true.
if (connected)
throw new IllegalStateException("Already connected");
useCaches = usecaches;
|
private static long | skipForward(java.io.InputStream is, long toSkip)Skips through the specified number of bytes from the stream
until either EOF is reached, or the specified
number of bytes have been skipped
long eachSkip = 0;
long skipped = 0;
while (skipped != toSkip) {
eachSkip = is.skip(toSkip - skipped);
// check if EOF is reached
if (eachSkip <= 0) {
if (is.read() == -1) {
return skipped ;
} else {
skipped++;
}
}
skipped += eachSkip;
}
return skipped;
|
private java.lang.String | stripOffParameters(java.lang.String contentType)
if (contentType == null)
return null;
int index = contentType.indexOf(';");
if (index > 0)
return contentType.substring(0, index);
else
return contentType;
|
public java.lang.String | toString()Returns a String representation of this URL connection.
return this.getClass().getName() + ":" + url;
|
private java.lang.String | typeToPackageName(java.lang.String contentType)Utility function to map a MIME content type into an equivalent
pair of class name components. For example: "text/html" would
be returned as "text.html"
// make sure we canonicalize the class name: all lower case
contentType = contentType.toLowerCase();
int len = contentType.length();
char nm[] = new char[len];
contentType.getChars(0, len, nm, 0);
for (int i = 0; i < len; i++) {
char c = nm[i];
if (c == '/") {
nm[i] = '.";
} else if (!('A" <= c && c <= 'Z" ||
'a" <= c && c <= 'z" ||
'0" <= c && c <= '9")) {
nm[i] = '_";
}
}
return new String(nm);
|