/*
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
package org.apache.batik.util;
import java.io.BufferedInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.MalformedURLException;
import java.net.URL;
import java.net.URLConnection;
import java.util.Iterator;
import java.util.LinkedList;
import java.util.List;
import java.util.zip.GZIPInputStream;
import java.util.zip.InflaterInputStream;
import java.util.zip.ZipException;
Holds the data for more URLs.
Author: Thomas DeWeese Version: $Id: ParsedURLData.java 1831630 2018-05-15 12:56:55Z ssteiner $
/**
* Holds the data for more URLs.
*
* @author <a href="mailto:deweese@apache.org">Thomas DeWeese</a>
* @version $Id: ParsedURLData.java 1831630 2018-05-15 12:56:55Z ssteiner $
*/
public class ParsedURLData {
protected static final String HTTP_USER_AGENT_HEADER = "User-Agent";
protected static final String HTTP_ACCEPT_HEADER = "Accept";
protected static final String HTTP_ACCEPT_LANGUAGE_HEADER = "Accept-Language";
protected static final String HTTP_ACCEPT_ENCODING_HEADER = "Accept-Encoding";
protected static List acceptedEncodings = new LinkedList();
static {
acceptedEncodings.add("gzip");
}
GZIP header magic number bytes, like found in a gzipped
files, which are encoded in Intel format (i.e. little indian).
/**
* GZIP header magic number bytes, like found in a gzipped
* files, which are encoded in Intel format (i.e. little indian).
*/
public static final byte[] GZIP_MAGIC = {(byte)0x1f, (byte)0x8b};
This is a utility function others can call that checks if
is is a GZIP stream if so it returns a GZIPInputStream that
will decode the contents, otherwise it returns (or a
buffered version of is) untouched.
Params: - is – Stream that may potentially be a GZIP stream.
/**
* This is a utility function others can call that checks if
* is is a GZIP stream if so it returns a GZIPInputStream that
* will decode the contents, otherwise it returns (or a
* buffered version of is) untouched.
* @param is Stream that may potentially be a GZIP stream.
*/
public static InputStream checkGZIP(InputStream is)
throws IOException {
if (!is.markSupported())
is = new BufferedInputStream(is);
byte[] data = new byte[2];
try {
is.mark(2);
is.read(data);
is.reset();
} catch (Exception ex) {
is.reset();
return is;
}
if ((data[0] == GZIP_MAGIC[0]) &&
(data[1] == GZIP_MAGIC[1]))
return new GZIPInputStream(is);
if (((data[0]&0x0F) == 8) &&
((data[0]>>>4) <= 7)) {
// Check for a zlib (deflate) stream
int chk = ((data[0] &0xFF)*256+
(data[1] &0xFF));
if ((chk %31) == 0) {
try {
// I'm not really as certain of this check
// as I would like so I want to force it
// to decode part of the stream.
is.mark(100);
InputStream ret = new InflaterInputStream(is);
if (!ret.markSupported())
ret = new BufferedInputStream(ret);
ret.mark(2);
ret.read(data);
is.reset();
ret = new InflaterInputStream(is);
return ret;
} catch (ZipException ze) {
is.reset();
return is;
}
}
}
return is;
}
Since the Data instance is 'hidden' in the ParsedURL
instance we make all our methods public. This makes it
easy for the various Protocol Handlers to update an
instance as parsing proceeds.
/**
* Since the Data instance is 'hidden' in the ParsedURL
* instance we make all our methods public. This makes it
* easy for the various Protocol Handlers to update an
* instance as parsing proceeds.
*/
public String protocol = null;
public String host = null;
public int port = -1;
public String path = null;
public String ref = null;
public String contentType = null;
public String contentEncoding = null;
public InputStream stream = null;
public boolean hasBeenOpened = false;
The extracted type/subtype from the Content-Type header.
/**
* The extracted type/subtype from the Content-Type header.
*/
protected String contentTypeMediaType;
The extracted charset parameter from the Content-Type header.
/**
* The extracted charset parameter from the Content-Type header.
*/
protected String contentTypeCharset;
The URL that was ultimately used to fetch the resource.
/**
* The URL that was ultimately used to fetch the resource.
*/
protected URL postConnectionURL;
Void constructor
/**
* Void constructor
*/
public ParsedURLData() {
}
Build from an existing URL.
/**
* Build from an existing URL.
*/
public ParsedURLData(URL url) {
protocol = url.getProtocol();
if ((protocol != null) && (protocol.length() == 0))
protocol = null;
host = url.getHost();
if ((host != null) && (host.length() == 0))
host = null;
port = url.getPort();
path = url.getFile();
if ((path != null) && (path.length() == 0))
path = null;
ref = url.getRef();
if ((ref != null) && (ref.length() == 0))
ref = null;
}
Attempts to build a normal java.net.URL instance from this
URL.
/**
* Attempts to build a normal java.net.URL instance from this
* URL.
*/
protected URL buildURL() throws MalformedURLException {
// System.out.println("File: " + file);
// if (ref != null)
// file += "#" + ref;
// System.err.println("Building: " + protocol + " - " +
// host + " - " + path);
if ((protocol != null) && (host != null)) {
String file = "";
if (path != null)
file = path;
if (port == -1)
return new URL(protocol, host, file);
return new URL(protocol, host, port, file);
}
return new URL(toString());
}
Implement Object.hashCode.
/**
* Implement Object.hashCode.
*/
public int hashCode() {
int hc = port;
if (protocol != null)
hc ^= protocol.hashCode();
if (host != null)
hc ^= host.hashCode();
// For some URLs path and ref can get fairly long
// and the most unique part is towards the end
// so we grab that part for HC purposes
if (path != null) {
int len = path.length();
if (len > 20)
hc ^= path.substring(len-20).hashCode();
else
hc ^= path.hashCode();
}
if (ref != null) {
int len = ref.length();
if (len > 20)
hc ^= ref.substring(len-20).hashCode();
else
hc ^= ref.hashCode();
}
return hc;
}
Implement Object.equals for ParsedURLData.
/**
* Implement Object.equals for ParsedURLData.
*/
public boolean equals(Object obj) {
if (obj == null) return false;
if (! (obj instanceof ParsedURLData))
return false;
ParsedURLData ud = (ParsedURLData)obj;
if (ud.port != port)
return false;
if (ud.protocol==null) {
if (protocol != null)
return false;
} else if (protocol == null)
return false;
else if (!ud.protocol.equals(protocol))
return false;
if (ud.host==null) {
if (host !=null)
return false;
} else if (host == null)
return false;
else if (!ud.host.equals(host))
return false;
if (ud.ref==null) {
if (ref !=null)
return false;
} else if (ref == null)
return false;
else if (!ud.ref.equals(ref))
return false;
if (ud.path==null) {
if (path !=null)
return false;
} else if (path == null)
return false;
else if (!ud.path.equals(path))
return false;
return true;
}
Returns the content type if available. This is only available
for some protocols.
/**
* Returns the content type if available. This is only available
* for some protocols.
*/
public String getContentType(String userAgent) {
if (contentType != null)
return contentType;
if (!hasBeenOpened) {
try {
openStreamInternal(userAgent, null, null);
} catch (IOException ioe) { /* nothing */ }
}
return contentType;
}
Returns the content type's type/subtype, if available. This is
only available for some protocols.
/**
* Returns the content type's type/subtype, if available. This is
* only available for some protocols.
*/
public String getContentTypeMediaType(String userAgent) {
if (contentTypeMediaType != null) {
return contentTypeMediaType;
}
extractContentTypeParts(userAgent);
return contentTypeMediaType;
}
Returns the content type's charset parameter, if available. This is
only available for some protocols.
/**
* Returns the content type's charset parameter, if available. This is
* only available for some protocols.
*/
public String getContentTypeCharset(String userAgent) {
if (contentTypeMediaType != null) {
return contentTypeCharset;
}
extractContentTypeParts(userAgent);
return contentTypeCharset;
}
Returns whether the Content-Type header has the given parameter.
/**
* Returns whether the Content-Type header has the given parameter.
*/
public boolean hasContentTypeParameter(String userAgent, String param) {
getContentType(userAgent);
if (contentType == null) {
return false;
}
int i = 0;
int len = contentType.length();
int plen = param.length();
loop1: while (i < len) {
switch (contentType.charAt(i)) {
case ' ':
case ';':
break loop1;
}
i++;
}
if (i == len) {
contentTypeMediaType = contentType;
} else {
contentTypeMediaType = contentType.substring(0, i);
}
loop2: for (;;) {
while (i < len && contentType.charAt(i) != ';') {
i++;
}
if (i == len) {
return false;
}
i++;
while (i < len && contentType.charAt(i) == ' ') {
i++;
}
if (i >= len - plen - 1) {
return false;
}
for (int j = 0; j < plen; j++) {
if (!(contentType.charAt(i++) == param.charAt(j))) {
continue loop2;
}
}
if (contentType.charAt(i) == '=') {
return true;
}
}
}
Extracts the type/subtype and charset parameter from the Content-Type
header.
/**
* Extracts the type/subtype and charset parameter from the Content-Type
* header.
*/
protected void extractContentTypeParts(String userAgent) {
getContentType(userAgent);
if (contentType == null) {
return;
}
int i = 0;
int len = contentType.length();
loop1: while (i < len) {
switch (contentType.charAt(i)) {
case ' ':
case ';':
break loop1;
}
i++;
}
if (i == len) {
contentTypeMediaType = contentType;
} else {
contentTypeMediaType = contentType.substring(0, i);
}
for (;;) {
while (i < len && contentType.charAt(i) != ';') {
i++;
}
if (i == len) {
return;
}
i++;
while (i < len && contentType.charAt(i) == ' ') {
i++;
}
if (i >= len - 8) {
return;
}
if (contentType.charAt(i++) == 'c') {
if (contentType.charAt(i++) != 'h') continue;
if (contentType.charAt(i++) != 'a') continue;
if (contentType.charAt(i++) != 'r') continue;
if (contentType.charAt(i++) != 's') continue;
if (contentType.charAt(i++) != 'e') continue;
if (contentType.charAt(i++) != 't') continue;
if (contentType.charAt(i++) != '=') continue;
int j = i;
loop2: while (i < len) {
switch (contentType.charAt(i)) {
case ' ':
case ';':
break loop2;
}
i++;
}
contentTypeCharset = contentType.substring(j, i);
return;
}
}
}
Returns the content encoding if available. This is only available
for some protocols.
/**
* Returns the content encoding if available. This is only available
* for some protocols.
*/
public String getContentEncoding(String userAgent) {
if (contentEncoding != null)
return contentEncoding;
if (!hasBeenOpened) {
try {
openStreamInternal(userAgent, null, null);
} catch (IOException ioe) { /* nothing */ }
}
return contentEncoding;
}
Returns true if the URL looks well formed and complete.
This does not garuntee that the stream can be opened but
is a good indication that things aren't totally messed up.
/**
* Returns true if the URL looks well formed and complete.
* This does not garuntee that the stream can be opened but
* is a good indication that things aren't totally messed up.
*/
public boolean complete() {
try {
buildURL();
} catch (MalformedURLException mue) {
return false;
}
return true;
}
Open the stream and check for common compression types. If
the stream is found to be compressed with a standard
compression type it is automatically decompressed.
Params: - userAgent – The user agent opening the stream (may be null).
- mimeTypes – The expected mime types of the content
in the returned InputStream (mapped to Http accept
header among other possability). The elements of
the iterator must be strings (may be null)
/**
* Open the stream and check for common compression types. If
* the stream is found to be compressed with a standard
* compression type it is automatically decompressed.
* @param userAgent The user agent opening the stream (may be null).
* @param mimeTypes The expected mime types of the content
* in the returned InputStream (mapped to Http accept
* header among other possability). The elements of
* the iterator must be strings (may be null)
*/
public InputStream openStream(String userAgent, Iterator mimeTypes)
throws IOException {
InputStream raw = openStreamInternal(userAgent, mimeTypes,
acceptedEncodings.iterator());
if (raw == null)
return null;
stream = null;
return checkGZIP(raw);
}
Open the stream and returns it. No checks are made to see
if the stream is compressed or encoded in any way.
Params: - userAgent – The user agent opening the stream (may be null).
- mimeTypes – The expected mime types of the content
in the returned InputStream (mapped to Http accept
header among other possability). The elements of
the iterator must be strings (may be null)
/**
* Open the stream and returns it. No checks are made to see
* if the stream is compressed or encoded in any way.
* @param userAgent The user agent opening the stream (may be null).
* @param mimeTypes The expected mime types of the content
* in the returned InputStream (mapped to Http accept
* header among other possability). The elements of
* the iterator must be strings (may be null)
*/
public InputStream openStreamRaw(String userAgent, Iterator mimeTypes)
throws IOException {
InputStream ret = openStreamInternal(userAgent, mimeTypes, null);
stream = null;
return ret;
}
protected InputStream openStreamInternal(String userAgent,
Iterator mimeTypes,
Iterator encodingTypes)
throws IOException {
if (stream != null)
return stream;
hasBeenOpened = true;
URL url = null;
try {
url = buildURL();
} catch (MalformedURLException mue) {
throw new IOException
("Unable to make sense of URL for connection");
}
if (url == null)
return null;
URLConnection urlC = url.openConnection();
if (urlC instanceof HttpURLConnection) {
if (userAgent != null)
urlC.setRequestProperty(HTTP_USER_AGENT_HEADER, userAgent);
if (mimeTypes != null) {
String acceptHeader = "";
while (mimeTypes.hasNext()) {
acceptHeader += mimeTypes.next();
if (mimeTypes.hasNext())
acceptHeader += ",";
}
urlC.setRequestProperty(HTTP_ACCEPT_HEADER, acceptHeader);
}
if (encodingTypes != null) {
String encodingHeader = "";
while (encodingTypes.hasNext()) {
encodingHeader += encodingTypes.next();
if (encodingTypes.hasNext())
encodingHeader += ",";
}
urlC.setRequestProperty(HTTP_ACCEPT_ENCODING_HEADER,
encodingHeader);
}
contentType = urlC.getContentType();
contentEncoding = urlC.getContentEncoding();
postConnectionURL = urlC.getURL();
}
try {
return (stream = urlC.getInputStream());
} catch (IOException e) {
if (urlC instanceof HttpURLConnection) {
// bug 49889: if available, return the error stream
// (allow interpretation of content in the HTTP error response)
stream = ((HttpURLConnection) urlC).getErrorStream();
if (stream == null) {
throw e;
}
return stream;
} else {
throw e;
}
}
}
Returns the URL up to and include the port number on
the host. Does not include the path or fragment pieces.
/**
* Returns the URL up to and include the port number on
* the host. Does not include the path or fragment pieces.
*/
public String getPortStr() {
String portStr ="";
if (protocol != null)
portStr += protocol + ":";
if ((host != null) || (port != -1)) {
portStr += "//";
if (host != null) portStr += host;
if (port != -1) portStr += ":" + port;
}
return portStr;
}
protected boolean sameFile(ParsedURLData other) {
if (this == other) return true;
// Check if the rest of the two PURLs matche other than
// the 'ref'
if ((port == other.port) &&
((path == other.path)
|| ((path!=null) && path.equals(other.path))) &&
((host == other.host)
|| ((host!=null) && host.equals(other.host))) &&
((protocol == other.protocol)
|| ((protocol!=null) && protocol.equals(other.protocol))))
return true;
return false;
}
Return a string representation of the data.
/**
* Return a string representation of the data.
*/
public String toString() {
String ret = getPortStr();
if (path != null)
ret += path;
if (ref != null)
ret += "#" + ref;
return ret;
}
Returns the URL that was ultimately used to fetch the resource
represented by the ParsedURL
.
/**
* Returns the URL that was ultimately used to fetch the resource
* represented by the <code>ParsedURL</code>.
*/
public String getPostConnectionURL() {
if (postConnectionURL != null) {
if (ref != null) {
return postConnectionURL.toString() + '#' + ref;
}
return postConnectionURL.toString();
}
return toString();
}
}