URLConnection.java revision 87548e8585334658c3ee89050ec917a10ca35e5a
1adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project/* 2adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Licensed to the Apache Software Foundation (ASF) under one or more 3adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * contributor license agreements. See the NOTICE file distributed with 4adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * this work for additional information regarding copyright ownership. 5adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * The ASF licenses this file to You under the Apache License, Version 2.0 6adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * (the "License"); you may not use this file except in compliance with 7adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the License. You may obtain a copy of the License at 8adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 9adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 10adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 11adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Unless required by applicable law or agreed to in writing, software 12adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 13adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * See the License for the specific language governing permissions and 15adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * limitations under the License. 16adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 17adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 18adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectpackage java.net; 19adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 20adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectimport java.io.IOException; 21adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectimport java.io.InputStream; 22adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectimport java.io.OutputStream; 23adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectimport java.util.Collections; 24f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilsonimport java.util.Date; 25adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectimport java.util.Hashtable; 26adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectimport java.util.List; 27adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectimport java.util.Map; 28adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectimport java.util.StringTokenizer; 29adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 30adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project/** 3155bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * A connection to a URL for reading or writing. For HTTP connections, see 3255bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * {@link HttpURLConnection} for documentation of HTTP-specific features. 3355bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * 3455bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * <p>For example, to retrieve {@code 3555bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * ftp://mirror.csclub.uwaterloo.ca/index.html}: <pre> {@code 3655bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * URL url = new URL("ftp://mirror.csclub.uwaterloo.ca/index.html"); 3755bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * URLConnection urlConnection = url.openConnection(); 3855bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * InputStream in = new BufferedInputStream(urlConnection.getInputStream()); 3955bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * try { 4055bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * readStream(in); 4155bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * } finally { 4255bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * in.close(); 4355bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * } 4455bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * }</pre> 4555bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * 4655bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * <p>{@code URLConnection} must be configured before it has connected to the 47ac277be6a146ade8f150236edf730431a7e12482Jesse Wilson * remote resource. Instances of {@code URLConnection} are not reusable: you 48ac277be6a146ade8f150236edf730431a7e12482Jesse Wilson * must use a different instance for each connection to a resource. 4955bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * 5055bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * <h3>Timeouts</h3> 5155bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * {@code URLConnection} supports two timeouts: a {@link #setConnectTimeout 5255bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * connect timeout} and a {@link #setReadTimeout read timeout}. By default, 5355bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * operations never time out. 5455bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * 5555bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * <h3>Built-in Protocols</h3> 5655bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * <ul> 5755bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * <li><strong>File</strong><br> 5855bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * Resources from the local file system can be loaded using {@code file:} 5955bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * URIs. File connections can only be used for input. 6055bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * <li><strong>FTP</strong><br> 6155bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * File Transfer Protocol (<a href="http://www.ietf.org/rfc/rfc959.txt">RFC 6255bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * 959</a>) is supported, but with no public subclass. FTP connections can 6355bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * be used for input or output but not both. 6455bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * <p>By default, FTP connections will be made using {@code anonymous} as 6555bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * the username and the empty string as the password. Specify alternate 6655bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * usernames and passwords in the URL: {@code 6755bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * ftp://username:password@host/path}. 6855bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * <li><strong>HTTP and HTTPS</strong><br> 6955bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * Refer to the {@link HttpURLConnection} and {@link 7055bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * javax.net.ssl.HttpsURLConnection HttpsURLConnection} subclasses. 7155bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * <li><strong>Jar</strong><br> 7255bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * Refer to the {@link JarURLConnection} subclass. 7355bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * </ul> 7455bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * 7555bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * <h3>Registering Additional Protocols</h3> 7655bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * Use {@link URL#setURLStreamHandlerFactory} to register handlers for other 7755bbb57dc76ab0231583460f5af4083f4f48f8f5Jesse Wilson * protocol types. 78adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 79adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectpublic abstract class URLConnection { 80adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 81adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 82adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * The URL which represents the remote target of this {@code URLConnection}. 83adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 84adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project protected URL url; 85adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 86adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project private String contentType; 87adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 88adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project private static boolean defaultAllowUserInteraction; 89adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 90adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project private static boolean defaultUseCaches = true; 91adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 92adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project ContentHandler defaultHandler = new DefaultContentHandler(); 93adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 94adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project private long lastModified = -1; 95adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 96adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 97adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * The data must be modified more recently than this time in milliseconds 98adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * since January 1, 1970, GMT to be transmitted. 99adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 100adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project protected long ifModifiedSince; 101adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 102adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 103adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Specifies whether the using of caches is enabled or the data has to be 104adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * recent for every request. 105adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 106adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project protected boolean useCaches = defaultUseCaches; 107adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 108adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 109adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Specifies whether this {@code URLConnection} is already connected to the 110adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * remote resource. If this field is set to {@code true} the flags for 111adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * setting up the connection are not changeable anymore. 112adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 113adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project protected boolean connected; 114adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 115adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 116adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Specifies whether this {@code URLConnection} allows sending data. 117adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 118adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project protected boolean doOutput; 119adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 120adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 121adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Specifies whether this {@code URLConnection} allows receiving data. 122adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 123adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project protected boolean doInput = true; 124adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 125adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 126adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Specifies whether this {@code URLConnection} allows user interaction as 127adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * it is needed for authentication purposes. 128adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 129adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project protected boolean allowUserInteraction = defaultAllowUserInteraction; 130adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 131adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project private static ContentHandlerFactory contentHandlerFactory; 132adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 133adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project private int readTimeout = 0; 134adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 135adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project private int connectTimeout = 0; 136adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 137adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 138adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Cache for storing content handler 139adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 140adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project static Hashtable<String, Object> contentHandlers = new Hashtable<String, Object>(); 141adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 142adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 143adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * A hashtable that maps the filename extension (key) to a MIME-type 144adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * (element) 145adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 146adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project private static FileNameMap fileNameMap; 147adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 148adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 149adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Creates a new {@code URLConnection} instance pointing to the resource 150adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * specified by the given URL. 151f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 152adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param url 153adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the URL which represents the resource this {@code 154adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * URLConnection} will point to. 155adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 156adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project protected URLConnection(URL url) { 157adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project this.url = url; 158adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 159adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 160adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 161ac277be6a146ade8f150236edf730431a7e12482Jesse Wilson * Opens a connection to the resource. This method will <strong>not</strong> 162ac277be6a146ade8f150236edf730431a7e12482Jesse Wilson * reconnect to a resource after the initial connection has been closed. 163f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 164adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IOException 165adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if an error occurs while connecting to the resource. 166adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 167adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public abstract void connect() throws IOException; 168adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 169adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 1706247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the option value which indicates whether user interaction is allowed 171adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * on this {@code URLConnection}. 172f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 173adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the option {@code allowUserInteraction}. 174adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #allowUserInteraction 175adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 176adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public boolean getAllowUserInteraction() { 177adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return allowUserInteraction; 178adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 179adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 180adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 1816247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns an object representing the content of the resource this {@code 182adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * URLConnection} is connected to. First, it attempts to get the content 183adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * type from the method {@code getContentType()} which looks at the response 184adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * header field "Content-Type". If none is found it will guess the content 185adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * type from the filename extension. If that fails the stream itself will be 186adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * used to guess the content type. 187f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 188adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the content representing object. 189adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IOException 190adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if an error occurs obtaining the content. 191adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 192adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public Object getContent() throws java.io.IOException { 193adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (!connected) { 194adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project connect(); 195adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 196adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 197adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if ((contentType = getContentType()) == null) { 198adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if ((contentType = guessContentTypeFromName(url.getFile())) == null) { 199adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project contentType = guessContentTypeFromStream(getInputStream()); 200adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 201adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 202adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (contentType != null) { 203adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return getContentHandler(contentType).getContent(this); 204adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 205adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return null; 206adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 207adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 208adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 2096247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns an object representing the content of the resource this {@code 210adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * URLConnection} is connected to. First, it attempts to get the content 211adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * type from the method {@code getContentType()} which looks at the response 212adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * header field "Content-Type". If none is found it will guess the content 213adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * type from the filename extension. If that fails the stream itself will be 214adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * used to guess the content type. The content type must match with one of 215adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the list {@code types}. 216f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 217adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param types 218adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the list of acceptable content types. 219adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the content representing object or {@code null} if the content 220adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * type does not match with one of the specified types. 221adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IOException 222adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if an error occurs obtaining the content. 223adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 224adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project // Param is not generic in spec 225adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project @SuppressWarnings("unchecked") 226adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public Object getContent(Class[] types) throws IOException { 227adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (!connected) { 228adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project connect(); 229adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 230adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 231adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if ((contentType = getContentType()) == null) { 232adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if ((contentType = guessContentTypeFromName(url.getFile())) == null) { 233adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project contentType = guessContentTypeFromStream(getInputStream()); 234adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 235adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 236adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (contentType != null) { 237adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return getContentHandler(contentType).getContent(this, types); 238adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 239adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return null; 240adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 241adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 242adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 2436247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the content encoding type specified by the response header field 244adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@code content-encoding} or {@code null} if this field is not set. 245f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 246adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the response header field {@code content-encoding}. 247adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 248adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public String getContentEncoding() { 249f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes return getHeaderField("Content-Encoding"); 250adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 251adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 252adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 253adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns the specific ContentHandler that will handle the type {@code 254adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * contentType}. 255f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 256adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param type 257adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * The type that needs to be handled 258adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return An instance of the Content Handler 259adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 260adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project private ContentHandler getContentHandler(String type) throws IOException { 261adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project // Replace all non-alphanumeric character by '_' 262adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project final String typeString = parseTypeString(type.replace('/', '.')); 263adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 264adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project // if there's a cached content handler, use it 265adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project Object cHandler = contentHandlers.get(type); 266adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (cHandler != null) { 267adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return (ContentHandler) cHandler; 268adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 269adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 270adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (contentHandlerFactory != null) { 271adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project cHandler = contentHandlerFactory.createContentHandler(type); 272adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project contentHandlers.put(type, cHandler); 273adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return (ContentHandler) cHandler; 274adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 275adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 276adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project // search through the package list for the right class for the Content 277adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project // Type 278ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes String packageList = System.getProperty("java.content.handler.pkgs"); 279adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (packageList != null) { 280f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes final StringTokenizer st = new StringTokenizer(packageList, "|"); 281adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project while (st.countTokens() > 0) { 282adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project try { 283f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes Class<?> cl = Class.forName(st.nextToken() + "." 284adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project + typeString, true, ClassLoader 285adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project .getSystemClassLoader()); 286adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project cHandler = cl.newInstance(); 287adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } catch (ClassNotFoundException e) { 288adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } catch (IllegalAccessException e) { 289adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } catch (InstantiationException e) { 290adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 291adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 292adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 293adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 294adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (cHandler == null) { 295ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes try { 296ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes // Try looking up AWT image content handlers 297ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes String className = "org.apache.harmony.awt.www.content." + typeString; 298ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes cHandler = Class.forName(className).newInstance(); 299ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes } catch (ClassNotFoundException e) { 300ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes } catch (IllegalAccessException e) { 301ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes } catch (InstantiationException e) { 302ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes } 303adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 304adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (cHandler != null) { 305adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (!(cHandler instanceof ContentHandler)) { 306adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project throw new UnknownServiceException(); 307adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 308adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project contentHandlers.put(type, cHandler); // if we got the handler, 309adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project // cache it for next time 310adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return (ContentHandler) cHandler; 311adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 312adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 313adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return defaultHandler; 314adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 315adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 316adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 3176247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the content length in bytes specified by the response header field 318adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@code content-length} or {@code -1} if this field is not set. 319f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 320adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the response header field {@code content-length}. 321adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 322adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public int getContentLength() { 323f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes return getHeaderFieldInt("Content-Length", -1); 324adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 325adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 326adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 3276247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the MIME-type of the content specified by the response header field 328adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@code content-type} or {@code null} if type is unknown. 329f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 330adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the response header field {@code content-type}. 331adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 332adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public String getContentType() { 333f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes return getHeaderField("Content-Type"); 334adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 335adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 336adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 3376247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the timestamp when this response has been sent as a date in 338adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * milliseconds since January 1, 1970 GMT or {@code 0} if this timestamp is 339adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * unknown. 340f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 341adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the sending timestamp of the current response. 342adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 343adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public long getDate() { 344f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes return getHeaderFieldDate("Date", 0); 345adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 346adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 347adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 3486247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the default setting whether this connection allows user interaction. 349f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 350adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the default setting {@code 351adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * defaultAllowUserInteraction}. 352adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #allowUserInteraction 353adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 354adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public static boolean getDefaultAllowUserInteraction() { 355adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return defaultAllowUserInteraction; 356adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 357adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 358adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 3596247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the default value for the specified request {@code field} or {@code 3606247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * null} if the field could not be found. The base implementation of this 361adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * method returns always {@code null}. 362f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 363adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param field 364adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the request field whose default value shall be returned. 365adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the default value for the given field. 366adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @deprecated Use {@link #getRequestProperty} 367adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 368adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project @Deprecated 369adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public static String getDefaultRequestProperty(String field) { 370adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return null; 371adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 372adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 373adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 3746247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the default setting whether this connection allows using caches. 375f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 376adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the default setting {@code defaultUseCaches}. 377adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #useCaches 378adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 379adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public boolean getDefaultUseCaches() { 380adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return defaultUseCaches; 381adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 382adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 383adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 3846247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the value of the option {@code doInput} which specifies whether this 385adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * connection allows to receive data. 386f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 387adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return {@code true} if this connection allows input, {@code false} 388adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * otherwise. 389adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #doInput 390adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 391adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public boolean getDoInput() { 392adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return doInput; 393adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 394adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 395adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 3966247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the value of the option {@code doOutput} which specifies whether 397adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * this connection allows to send data. 398f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 399adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return {@code true} if this connection allows output, {@code false} 400adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * otherwise. 401adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #doOutput 402adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 403adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public boolean getDoOutput() { 404adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return doOutput; 405adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 406adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 407adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 4086247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the timestamp when this response will be expired in milliseconds 409adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * since January 1, 1970 GMT or {@code 0} if this timestamp is unknown. 410f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 411adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the response header field {@code expires}. 412adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 413adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public long getExpiration() { 414f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes return getHeaderFieldDate("Expires", 0); 415adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 416adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 417adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 4186247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the table which is used by all {@code URLConnection} instances to 419adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * determine the MIME-type according to a file extension. 420f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 421adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the file name map to determine the MIME-type. 422adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 423adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public static FileNameMap getFileNameMap() { 42455392539fea537abfb6581b474918f9d611fba27Jesse Wilson synchronized (URLConnection.class) { 42555392539fea537abfb6581b474918f9d611fba27Jesse Wilson if (fileNameMap == null) { 4267b3ebefcdf79a251cf2a5619dd2354952fc67665Elliott Hughes fileNameMap = new DefaultFileNameMap(); 42755392539fea537abfb6581b474918f9d611fba27Jesse Wilson } 42855392539fea537abfb6581b474918f9d611fba27Jesse Wilson return fileNameMap; 429adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 430adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 431adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 432adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 4336247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the header value at the field position {@code pos} or {@code null} 4346247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * if the header has fewer than {@code pos} fields. The base 435adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * implementation of this method returns always {@code null}. 436f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 4376247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * <p>Some implementations (notably {@code HttpURLConnection}) include a mapping 4386247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * for the null key; in HTTP's case, this maps to the HTTP status line and is 4396247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * treated as being at position 0 when indexing into the header fields. 4406247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * 441adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param pos 442adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the field position of the response header. 443adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the field at position {@code pos}. 444adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 445adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public String getHeaderField(int pos) { 446adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return null; 447adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 448adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 449adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 4506247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns an unchangeable map of the response-header fields and values. The 451adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * response-header field names are the key values of the map. The map values 452adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * are lists of header field values associated with a particular key name. 453f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 4546247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * <p>Some implementations (notably {@code HttpURLConnection}) include a mapping 4556247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * for the null key; in HTTP's case, this maps to the HTTP status line and is 4566247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * treated as being at position 0 when indexing into the header fields. 4576247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * 458adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the response-header representing generic map. 459f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * @since 1.4 460adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 461adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public Map<String, List<String>> getHeaderFields() { 462adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return Collections.emptyMap(); 463adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 464adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 465adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 4666247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns an unchangeable map of general request properties used by this 467adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * connection. The request property names are the key values of the map. The 468adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * map values are lists of property values of the corresponding key name. 469f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 470adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the request-property representing generic map. 471f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * @since 1.4 472adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 473adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public Map<String, List<String>> getRequestProperties() { 474b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes checkNotConnected(); 475b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes return Collections.emptyMap(); 476b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes } 477b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes 478b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes private void checkNotConnected() { 479adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (connected) { 480b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes throw new IllegalStateException("Already connected"); 481adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 482adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 483adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 484adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 485adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Adds the given property to the request header. Existing properties with 486adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the same name will not be overwritten by this method. 487f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 488adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param field 489adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the request property field name to add. 490adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param newValue 491adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the value of the property which is to add. 492adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalStateException 493adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if the connection has been already established. 494adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws NullPointerException 495adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if the property name is {@code null}. 496f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * @since 1.4 497adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 498adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void addRequestProperty(String field, String newValue) { 499b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes checkNotConnected(); 500adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (field == null) { 501b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes throw new NullPointerException("field == null"); 502adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 503adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 504adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 505adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 5066247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the value of the header field specified by {@code key} or {@code 5076247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * null} if there is no field with this name. The base implementation of 508adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * this method returns always {@code null}. 509f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 5106247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * <p>Some implementations (notably {@code HttpURLConnection}) include a mapping 5116247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * for the null key; in HTTP's case, this maps to the HTTP status line and is 5126247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * treated as being at position 0 when indexing into the header fields. 5136247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * 514adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param key 515adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the name of the header field. 516adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the header field. 517adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 518adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public String getHeaderField(String key) { 519adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return null; 520adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 521adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 522adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 5236247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the specified header value as a date in milliseconds since January 524adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 1, 1970 GMT. Returns the {@code defaultValue} if no such header field 525adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * could be found. 526f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 527adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param field 528adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the header field name whose value is needed. 529adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param defaultValue 530adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the default value if no field has been found. 531adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the specified header field as a date in 532adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * milliseconds. 533adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 534f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson @SuppressWarnings("deprecation") 535adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public long getHeaderFieldDate(String field, long defaultValue) { 536adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project String date = getHeaderField(field); 537adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (date == null) { 538adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return defaultValue; 539adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 540f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson try { 541f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson return Date.parse(date); 542f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } catch (Exception e) { 543f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson return defaultValue; 544f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } 545adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 546adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 547adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 5486247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the specified header value as a number. Returns the {@code 549adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * defaultValue} if no such header field could be found or the value could 550adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * not be parsed as an {@code Integer}. 551f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 552adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param field 553adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the header field name whose value is needed. 554adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param defaultValue 555adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the default value if no field has been found. 556adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the specified header field as a number. 557adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 558adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public int getHeaderFieldInt(String field, int defaultValue) { 559adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project try { 560adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return Integer.parseInt(getHeaderField(field)); 561adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } catch (NumberFormatException e) { 562adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return defaultValue; 563adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 564adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 565adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 566adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 5676247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the name of the header field at the given position {@code posn} or 5686247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * {@code null} if there are fewer than {@code posn} fields. The base 569adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * implementation of this method returns always {@code null}. 570f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 5716247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * <p>Some implementations (notably {@code HttpURLConnection}) include a mapping 5726247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * for the null key; in HTTP's case, this maps to the HTTP status line and is 5736247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * treated as being at position 0 when indexing into the header fields. 5746247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * 575adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param posn 576adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the position of the header field which has to be returned. 577adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the header field name at the given position. 578adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 579adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public String getHeaderFieldKey(int posn) { 580adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return null; 581adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 582adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 583adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 5846247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the point of time since when the data must be modified to be 585adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * transmitted. Some protocols transmit data only if it has been modified 586adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * more recently than a particular time. 587f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 588adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the time in milliseconds since January 1, 1970 GMT. 589adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #ifModifiedSince 590adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 591adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public long getIfModifiedSince() { 592adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return ifModifiedSince; 593adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 594adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 595adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 5966247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns an {@code InputStream} for reading data from the resource pointed by 597adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * this {@code URLConnection}. It throws an UnknownServiceException by 598adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * default. This method must be overridden by its subclasses. 599f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 600adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the InputStream to read data from. 601adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IOException 602adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if no InputStream could be created. 603adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 604adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public InputStream getInputStream() throws IOException { 605b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes throw new UnknownServiceException("Does not support writing to the input stream"); 606adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 607adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 608adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 6096247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the value of the response header field {@code last-modified} or 610adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@code 0} if this value is not set. 611f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 612adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the {@code last-modified} header field. 613adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 614adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public long getLastModified() { 615adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (lastModified != -1) { 616adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return lastModified; 617adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 618f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes return lastModified = getHeaderFieldDate("Last-Modified", 0); 619adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 620adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 621adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 6226247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns an {@code OutputStream} for writing data to this {@code 623adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * URLConnection}. It throws an {@code UnknownServiceException} by default. 624adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * This method must be overridden by its subclasses. 625f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 626adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the OutputStream to write data. 627adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IOException 628adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if no OutputStream could be created. 629adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 630adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public OutputStream getOutputStream() throws IOException { 631b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes throw new UnknownServiceException("Does not support writing to the output stream"); 632adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 633adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 634adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 6356247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns a {@code Permission} object representing all needed permissions to 636adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * open this connection. The returned permission object depends on the state 637adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * of the connection and will be {@code null} if no permissions are 638adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * necessary. By default, this method returns {@code AllPermission}. 639adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Subclasses should overwrite this method to return an appropriate 640adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * permission object. 641f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 642adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the permission object representing the needed permissions to open 643adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * this connection. 644adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IOException 645adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if an I/O error occurs while creating the permission object. 646adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 647adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public java.security.Permission getPermission() throws IOException { 648adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return new java.security.AllPermission(); 649adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 650adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 651adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 6526247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the value of the request header property specified by {code field} 6536247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * or {@code null} if there is no field with this name. The base 654adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * implementation of this method returns always {@code null}. 655f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 656adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param field 657adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the name of the request header property. 658adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the property. 659adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalStateException 660adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if the connection has been already established. 661adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 662adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public String getRequestProperty(String field) { 663b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes checkNotConnected(); 664adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return null; 665adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 666adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 667adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 6686247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the URL represented by this {@code URLConnection}. 669f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 670adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the URL of this connection. 671adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 672adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public URL getURL() { 673adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return url; 674adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 675adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 676adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 6776247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the value of the flag which specifies whether this {@code 678adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * URLConnection} allows to use caches. 679f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 680adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return {@code true} if using caches is allowed, {@code false} otherwise. 681adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 682adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public boolean getUseCaches() { 683adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return useCaches; 684adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 685adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 686adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 687adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Determines the MIME-type of the given resource {@code url} by resolving 688adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the filename extension with the internal FileNameMap. Any fragment 689adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * identifier is removed before processing. 690f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 691adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param url 692adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the URL with the filename to get the MIME type. 693adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the guessed content type or {@code null} if the type could not be 694adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * determined. 695adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 696adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public static String guessContentTypeFromName(String url) { 697adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return getFileNameMap().getContentTypeFor(url); 698adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 699adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 700adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 701adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Determines the MIME-type of the resource represented by the input stream 702adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@code is} by reading its first few characters. 703f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 704adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param is 705adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the resource representing input stream to determine the 706adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * content type. 707adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the guessed content type or {@code null} if the type could not be 708adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * determined. 709adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IOException 710adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if an I/O error occurs while reading from the input stream. 711adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 712f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson @SuppressWarnings("nls") 713adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public static String guessContentTypeFromStream(InputStream is) 714adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project throws IOException { 715f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson 716adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (!is.markSupported()) { 717adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return null; 718adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 719f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson // Look ahead up to 64 bytes for the longest encoded header 720f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson is.mark(64); 721f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson byte[] bytes = new byte[64]; 722f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson int length = is.read(bytes); 723adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project is.reset(); 724f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson 7250b2836e81d354e9bb7df9d43cda5ccfb9c199450Elliott Hughes // If there is no data from the input stream, we can't determine content type. 7260b2836e81d354e9bb7df9d43cda5ccfb9c199450Elliott Hughes if (length == -1) { 7270b2836e81d354e9bb7df9d43cda5ccfb9c199450Elliott Hughes return null; 7280b2836e81d354e9bb7df9d43cda5ccfb9c199450Elliott Hughes } 7290b2836e81d354e9bb7df9d43cda5ccfb9c199450Elliott Hughes 730f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson // Check for Unicode BOM encoding indicators 731e810d3b49631329b11440aa5b7a54db181d42ed1Elliott Hughes String encoding = "US-ASCII"; 732f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson int start = 0; 733f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if (length > 1) { 734f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if ((bytes[0] == (byte) 0xFF) && (bytes[1] == (byte) 0xFE)) { 735f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson encoding = "UTF-16LE"; 736f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson start = 2; 737f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson length -= length & 1; 738f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } 739f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if ((bytes[0] == (byte) 0xFE) && (bytes[1] == (byte) 0xFF)) { 740f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson encoding = "UTF-16BE"; 741f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson start = 2; 742f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson length -= length & 1; 743f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } 744f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if (length > 2) { 745f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if ((bytes[0] == (byte) 0xEF) && (bytes[1] == (byte) 0xBB) 746f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson && (bytes[2] == (byte) 0xBF)) { 747f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson encoding = "UTF-8"; 748f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson start = 3; 749f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } 750f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if (length > 3) { 751f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if ((bytes[0] == (byte) 0x00) && (bytes[1] == (byte) 0x00) 752f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson && (bytes[2] == (byte) 0xFE) 753f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson && (bytes[3] == (byte) 0xFF)) { 754f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson encoding = "UTF-32BE"; 755f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson start = 4; 756f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson length -= length & 3; 757f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } 758f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if ((bytes[0] == (byte) 0xFF) && (bytes[1] == (byte) 0xFE) 759f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson && (bytes[2] == (byte) 0x00) 760f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson && (bytes[3] == (byte) 0x00)) { 761f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson encoding = "UTF-32LE"; 762f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson start = 4; 763f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson length -= length & 3; 764f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } 765f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } 766f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } 767adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 768f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson 769f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson String header = new String(bytes, start, length - start, encoding); 770f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson 771f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson // Check binary types 772f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if (header.startsWith("PK")) { 773f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson return "application/zip"; 774adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 775f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if (header.startsWith("GI")) { 776f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson return "image/gif"; 777adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 778f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson 779f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson // Check text types 780f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson String textHeader = header.trim().toUpperCase(); 781f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if (textHeader.startsWith("<!DOCTYPE HTML") || 782f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson textHeader.startsWith("<HTML") || 783f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson textHeader.startsWith("<HEAD") || 784f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson textHeader.startsWith("<BODY") || 785f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson textHeader.startsWith("<HEAD")) { 786f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson return "text/html"; 787f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } 788f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson 789f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if (textHeader.startsWith("<?XML")) { 790f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson return "application/xml"; 791f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } 792f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson 793f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson // Give up 794adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return null; 795adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 796adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 797adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 798adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Performs any necessary string parsing on the input string such as 799adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * converting non-alphanumeric character into underscore. 800f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 801adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param typeString 802adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the parsed string 803adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the string to be parsed 804adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 805adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project private String parseTypeString(String typeString) { 806a389b4a499f40379b0b204d7ba1c2057663d95c0Jesse Wilson StringBuilder typeStringBuffer = new StringBuilder(typeString); 807adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project for (int i = 0; i < typeStringBuffer.length(); i++) { 808adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project // if non-alphanumeric, replace it with '_' 809adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project char c = typeStringBuffer.charAt(i); 810adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (!(Character.isLetter(c) || Character.isDigit(c) || c == '.')) { 811adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project typeStringBuffer.setCharAt(i, '_'); 812adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 813adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 814adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return typeStringBuffer.toString(); 815adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 816adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 817adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 818adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the flag indicating whether this connection allows user interaction 819adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * or not. This method can only be called prior to the connection 820adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * establishment. 821f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 822adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param newValue 823adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the value of the flag to be set. 824adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalStateException 825adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if this method attempts to change the flag after the 826adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * connection has been established. 827adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #allowUserInteraction 828adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 829adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void setAllowUserInteraction(boolean newValue) { 830b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes checkNotConnected(); 831adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project this.allowUserInteraction = newValue; 832adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 833adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 834adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 835adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the internally used content handler factory. The content factory can 83687548e8585334658c3ee89050ec917a10ca35e5aElliott Hughes * only be set once during the lifetime of the application. 837f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 838adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param contentFactory 839adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the content factory to be set. 840adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws Error 841ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes * if the factory has been already set. 842adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 843ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes public static synchronized void setContentHandlerFactory(ContentHandlerFactory contentFactory) { 844adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (contentHandlerFactory != null) { 845b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes throw new Error("Factory already set"); 846adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 847adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project contentHandlerFactory = contentFactory; 848adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 849adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 850adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 851adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the default value for the flag indicating whether this connection 852adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * allows user interaction or not. Existing {@code URLConnection}s are 853adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * unaffected. 854f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 855adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param allows 856adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the default value of the flag to be used for new connections. 857adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #defaultAllowUserInteraction 858adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #allowUserInteraction 859adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 860adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public static void setDefaultAllowUserInteraction(boolean allows) { 861adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project defaultAllowUserInteraction = allows; 862adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 863adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 864adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 865adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the default value of the specified request header field. This value 866adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * will be used for the specific field of every newly created connection. 8676247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * The base implementation of this method does nothing. 868f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 869adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param field 870adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the request header field to be set. 871adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param value 872adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the default value to be used. 873adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @deprecated Use {@link #setRequestProperty} of an existing {@code 874adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * URLConnection} instance. 875adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 876adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project @Deprecated 877adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public static void setDefaultRequestProperty(String field, String value) { 878adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 879adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 880adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 881adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the default value for the flag indicating whether this connection 882adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * allows to use caches. Existing {@code URLConnection}s are unaffected. 883f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 884adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param newValue 885adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the default value of the flag to be used for new connections. 886adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #defaultUseCaches 887adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #useCaches 888adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 889adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void setDefaultUseCaches(boolean newValue) { 890adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project defaultUseCaches = newValue; 891adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 892adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 893adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 894adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the flag indicating whether this {@code URLConnection} allows input. 895adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * It cannot be set after the connection is established. 896f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 897adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param newValue 898adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the new value for the flag to be set. 899adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalAccessError 900adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if this method attempts to change the value after the 901adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * connection has been already established. 902adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #doInput 903adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 904adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void setDoInput(boolean newValue) { 905b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes checkNotConnected(); 906adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project this.doInput = newValue; 907adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 908adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 909adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 910adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the flag indicating whether this {@code URLConnection} allows 911adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * output. It cannot be set after the connection is established. 912f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 913adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param newValue 914adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the new value for the flag to be set. 915adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalAccessError 916adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if this method attempts to change the value after the 917adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * connection has been already established. 918adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #doOutput 919adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 920adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void setDoOutput(boolean newValue) { 921b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes checkNotConnected(); 922adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project this.doOutput = newValue; 923adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 924adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 925adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 926adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the internal map which is used by all {@code URLConnection} 927adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * instances to determine the MIME-type according to a filename extension. 928f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 929adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param map 930adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the MIME table to be set. 931adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 932adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public static void setFileNameMap(FileNameMap map) { 93355392539fea537abfb6581b474918f9d611fba27Jesse Wilson synchronized (URLConnection.class) { 93455392539fea537abfb6581b474918f9d611fba27Jesse Wilson fileNameMap = map; 93555392539fea537abfb6581b474918f9d611fba27Jesse Wilson } 936adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 937adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 938adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 939adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the point of time since when the data must be modified to be 940adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * transmitted. Some protocols transmit data only if it has been modified 941adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * more recently than a particular time. The data will be transmitted 942adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * regardless of its timestamp if this option is set to {@code 0}. 943f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 944adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param newValue 945adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the time in milliseconds since January 1, 1970 GMT. 946adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalStateException 947adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if this {@code URLConnection} has already been connected. 948adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #ifModifiedSince 949adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 950adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void setIfModifiedSince(long newValue) { 951b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes checkNotConnected(); 952adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project this.ifModifiedSince = newValue; 953adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 954adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 955adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 956adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the value of the specified request header field. The value will only 957adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * be used by the current {@code URLConnection} instance. This method can 958adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * only be called before the connection is established. 959f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 960adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param field 961adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the request header field to be set. 962adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param newValue 963adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the new value of the specified property. 964adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalStateException 965adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if the connection has been already established. 966adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws NullPointerException 967adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if the parameter {@code field} is {@code null}. 968adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 969adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void setRequestProperty(String field, String newValue) { 970b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes checkNotConnected(); 971adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (field == null) { 972b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes throw new NullPointerException("field == null"); 973adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 974adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 975adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 976adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 977adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the flag indicating whether this connection allows to use caches or 978adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * not. This method can only be called prior to the connection 979adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * establishment. 980f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 981adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param newValue 982adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the value of the flag to be set. 983adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalStateException 984adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if this method attempts to change the flag after the 985adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * connection has been established. 986adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #useCaches 987adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 988adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void setUseCaches(boolean newValue) { 989b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes checkNotConnected(); 990adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project this.useCaches = newValue; 991adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 992adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 993adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 994adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the timeout value in milliseconds for establishing the connection to 995adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the resource pointed by this {@code URLConnection} instance. A {@code 996adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * SocketTimeoutException} is thrown if the connection could not be 997adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * established in this time. Default is {@code 0} which stands for an 998adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * infinite timeout. 999f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 1000adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param timeout 1001adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the connecting timeout in milliseconds. 1002adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalArgumentException 1003adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if the parameter {@code timeout} is less than zero. 1004adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 1005adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void setConnectTimeout(int timeout) { 1006b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes if (timeout < 0) { 1007b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes throw new IllegalArgumentException("timeout < 0"); 1008adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1009adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project this.connectTimeout = timeout; 1010adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1011adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 1012adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 10136247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the configured connecting timeout. 1014f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 1015adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the connecting timeout value in milliseconds. 1016adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 1017adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public int getConnectTimeout() { 1018adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return connectTimeout; 1019adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1020adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 1021adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 1022adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the timeout value in milliseconds for reading from the input stream 1023adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * of an established connection to the resource. A {@code 1024adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * SocketTimeoutException} is thrown if the connection could not be 1025adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * established in this time. Default is {@code 0} which stands for an 1026adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * infinite timeout. 1027f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 1028adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param timeout 1029adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the reading timeout in milliseconds. 1030adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalArgumentException 1031adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if the parameter {@code timeout} is less than zero. 1032adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 1033adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void setReadTimeout(int timeout) { 1034b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes if (timeout < 0) { 1035b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes throw new IllegalArgumentException("timeout < 0"); 1036adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1037adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project this.readTimeout = timeout; 1038adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1039adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 1040adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 10416247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the configured timeout for reading from the input stream of an 1042adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * established connection to the resource. 1043f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 1044adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the reading timeout value in milliseconds. 1045adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 1046adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public int getReadTimeout() { 1047adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return readTimeout; 1048adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1049adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 1050adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 1051adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns the string representation containing the name of this class and 1052adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the URL. 1053f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 1054adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the string representation of this {@code URLConnection} instance. 1055adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 1056adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project @Override 1057adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public String toString() { 10586247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes return getClass().getName() + ":" + url.toString(); 1059adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1060adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 1061adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project static class DefaultContentHandler extends java.net.ContentHandler { 1062adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project @Override 1063adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public Object getContent(URLConnection u) throws IOException { 1064adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return u.getInputStream(); 1065adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1066adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1067adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project} 1068