Resource.java revision 0
0N/A/*
2362N/A * Copyright 1998-2006 Sun Microsystems, Inc. All Rights Reserved.
0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
0N/A *
0N/A * This code is free software; you can redistribute it and/or modify it
0N/A * under the terms of the GNU General Public License version 2 only, as
0N/A * published by the Free Software Foundation. Sun designates this
0N/A * particular file as subject to the "Classpath" exception as provided
0N/A * by Sun in the LICENSE file that accompanied this code.
0N/A *
0N/A * This code is distributed in the hope that it will be useful, but WITHOUT
0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
0N/A * version 2 for more details (a copy is included in the LICENSE file that
0N/A * accompanied this code).
0N/A *
0N/A * You should have received a copy of the GNU General Public License version
0N/A * 2 along with this work; if not, write to the Free Software Foundation,
2362N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
2362N/A *
2362N/A * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
0N/A * CA 95054 USA or visit www.sun.com if you need additional information or
0N/A * have any questions.
0N/A */
0N/A
0N/Apackage sun.misc;
0N/A
0N/Aimport java.net.URL;
0N/Aimport java.io.IOException;
0N/Aimport java.io.InterruptedIOException;
0N/Aimport java.io.InputStream;
0N/Aimport java.security.CodeSigner;
0N/Aimport java.util.jar.Manifest;
0N/Aimport java.util.jar.Attributes;
0N/Aimport java.nio.ByteBuffer;
0N/Aimport sun.nio.ByteBuffered;
0N/A
0N/A/**
0N/A * This class is used to represent a Resource that has been loaded
0N/A * from the class path.
0N/A *
0N/A * @author David Connelly
0N/A * @since 1.2
0N/A */
0N/Apublic abstract class Resource {
0N/A /**
0N/A * Returns the name of the Resource.
0N/A */
0N/A public abstract String getName();
0N/A
0N/A /**
0N/A * Returns the URL of the Resource.
0N/A */
0N/A public abstract URL getURL();
0N/A
0N/A /**
0N/A * Returns the CodeSource URL for the Resource.
0N/A */
0N/A public abstract URL getCodeSourceURL();
0N/A
0N/A /**
0N/A * Returns an InputStream for reading the Resource data.
0N/A */
0N/A public abstract InputStream getInputStream() throws IOException;
0N/A
0N/A /**
0N/A * Returns the length of the Resource data, or -1 if unknown.
0N/A */
0N/A public abstract int getContentLength() throws IOException;
0N/A
0N/A private InputStream cis;
0N/A
0N/A /* Cache result in case getBytes is called after getByteBuffer. */
0N/A private synchronized InputStream cachedInputStream() throws IOException {
0N/A if (cis == null) {
0N/A cis = getInputStream();
0N/A }
0N/A return cis;
0N/A }
0N/A
0N/A /**
0N/A * Returns the Resource data as an array of bytes.
0N/A */
0N/A public byte[] getBytes() throws IOException {
0N/A byte[] b;
0N/A // Get stream before content length so that a FileNotFoundException
0N/A // can propagate upwards without being caught too early
0N/A InputStream in = cachedInputStream();
0N/A
0N/A // This code has been uglified to protect against interrupts.
0N/A // Even if a thread has been interrupted when loading resources,
0N/A // the IO should not abort, so must carefully retry, failing only
0N/A // if the retry leads to some other IO exception.
0N/A
boolean isInterrupted = Thread.interrupted();
int len;
for (;;) {
try {
len = getContentLength();
break;
} catch (InterruptedIOException iioe) {
Thread.interrupted();
isInterrupted = true;
}
}
try {
if (len != -1) {
// Read exactly len bytes from the input stream
b = new byte[len];
while (len > 0) {
int n = 0;
try {
n = in.read(b, b.length - len, len);
} catch (InterruptedIOException iioe) {
Thread.interrupted();
isInterrupted = true;
}
if (n == -1) {
throw new IOException("unexpected EOF");
}
len -= n;
}
} else {
// Read until end of stream is reached
b = new byte[1024];
int total = 0;
for (;;) {
len = 0;
try {
len = in.read(b, total, b.length - total);
if (len == -1)
break;
} catch (InterruptedIOException iioe) {
Thread.interrupted();
isInterrupted = true;
}
total += len;
if (total >= b.length) {
byte[] tmp = new byte[total * 2];
System.arraycopy(b, 0, tmp, 0, total);
b = tmp;
}
}
// Trim array to correct size, if necessary
if (total != b.length) {
byte[] tmp = new byte[total];
System.arraycopy(b, 0, tmp, 0, total);
b = tmp;
}
}
} finally {
try {
in.close();
} catch (InterruptedIOException iioe) {
isInterrupted = true;
} catch (IOException ignore) {}
if (isInterrupted) {
Thread.currentThread().interrupt();
}
}
return b;
}
/**
* Returns the Resource data as a ByteBuffer, but only if the input stream
* was implemented on top of a ByteBuffer. Return <tt>null</tt> otherwise.
*/
public ByteBuffer getByteBuffer() throws IOException {
InputStream in = cachedInputStream();
if (in instanceof ByteBuffered) {
return ((ByteBuffered)in).getByteBuffer();
}
return null;
}
/**
* Returns the Manifest for the Resource, or null if none.
*/
public Manifest getManifest() throws IOException {
return null;
}
/**
* Returns theCertificates for the Resource, or null if none.
*/
public java.security.cert.Certificate[] getCertificates() {
return null;
}
/**
* Returns the code signers for the Resource, or null if none.
*/
public CodeSigner[] getCodeSigners() {
return null;
}
}