URLConnection.java revision 953df613522e12a418cb7cb73248594d6c9f53d4
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; 2778e3320540c8bdcbefba5ae1222ee18f6679ab33Elliott Hughesimport java.util.Locale; 28adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectimport java.util.Map; 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> 61ae394a866dd86df8819b652dfe00b3d2c7ee204cElliott Hughes * File Transfer Protocol (<a href="http://www.ietf.org/rfc/rfc959.txt">RFC 959</a>) 62ae394a866dd86df8819b652dfe00b3d2c7ee204cElliott Hughes * 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 276118abc3050371812703e4fabf03f4399d01fb28cElliott Hughes // search through the package list for the right class for the Content Type 277ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes String packageList = System.getProperty("java.content.handler.pkgs"); 278adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (packageList != null) { 279118abc3050371812703e4fabf03f4399d01fb28cElliott Hughes for (String packageName : packageList.split("\\|")) { 280118abc3050371812703e4fabf03f4399d01fb28cElliott Hughes String className = packageName + "." + typeString; 281adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project try { 282118abc3050371812703e4fabf03f4399d01fb28cElliott Hughes Class<?> klass = Class.forName(className, true, ClassLoader.getSystemClassLoader()); 283118abc3050371812703e4fabf03f4399d01fb28cElliott Hughes cHandler = klass.newInstance(); 284adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } catch (ClassNotFoundException e) { 285adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } catch (IllegalAccessException e) { 286adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } catch (InstantiationException e) { 287adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 288adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 289adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 290adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 291adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (cHandler == null) { 292ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes try { 293ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes // Try looking up AWT image content handlers 294ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes String className = "org.apache.harmony.awt.www.content." + typeString; 295ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes cHandler = Class.forName(className).newInstance(); 296ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes } catch (ClassNotFoundException e) { 297ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes } catch (IllegalAccessException e) { 298ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes } catch (InstantiationException e) { 299ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes } 300adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 301adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (cHandler != null) { 302adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (!(cHandler instanceof ContentHandler)) { 303adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project throw new UnknownServiceException(); 304adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 305adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project contentHandlers.put(type, cHandler); // if we got the handler, 306adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project // cache it for next time 307adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return (ContentHandler) cHandler; 308adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 309adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 310adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return defaultHandler; 311adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 312adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 313adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 3146247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the content length in bytes specified by the response header field 315adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@code content-length} or {@code -1} if this field is not set. 316f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 317adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the response header field {@code content-length}. 318adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 319adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public int getContentLength() { 320f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes return getHeaderFieldInt("Content-Length", -1); 321adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 322adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 323adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 3246247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the MIME-type of the content specified by the response header field 325adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@code content-type} or {@code null} if type is unknown. 326f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 327adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the response header field {@code content-type}. 328adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 329adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public String getContentType() { 330f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes return getHeaderField("Content-Type"); 331adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 332adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 333adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 3346247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the timestamp when this response has been sent as a date in 335adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * milliseconds since January 1, 1970 GMT or {@code 0} if this timestamp is 336adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * unknown. 337f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 338adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the sending timestamp of the current response. 339adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 340adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public long getDate() { 341f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes return getHeaderFieldDate("Date", 0); 342adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 343adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 344adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 3456247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the default setting whether this connection allows user interaction. 346f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 347adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the default setting {@code 348adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * defaultAllowUserInteraction}. 349adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #allowUserInteraction 350adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 351adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public static boolean getDefaultAllowUserInteraction() { 352adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return defaultAllowUserInteraction; 353adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 354adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 355adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 3566247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the default value for the specified request {@code field} or {@code 3576247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * null} if the field could not be found. The base implementation of this 358adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * method returns always {@code null}. 359f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 360adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param field 361adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the request field whose default value shall be returned. 362adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the default value for the given field. 363adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @deprecated Use {@link #getRequestProperty} 364adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 365adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project @Deprecated 366adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public static String getDefaultRequestProperty(String field) { 367adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return null; 368adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 369adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 370adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 3716247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the default setting whether this connection allows using caches. 372f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 373adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the default setting {@code defaultUseCaches}. 374adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #useCaches 375adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 376adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public boolean getDefaultUseCaches() { 377adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return defaultUseCaches; 378adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 379adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 380adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 3816247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the value of the option {@code doInput} which specifies whether this 382adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * connection allows to receive data. 383f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 384adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return {@code true} if this connection allows input, {@code false} 385adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * otherwise. 386adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #doInput 387adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 388adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public boolean getDoInput() { 389adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return doInput; 390adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 391adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 392adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 3936247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the value of the option {@code doOutput} which specifies whether 394adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * this connection allows to send data. 395f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 396adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return {@code true} if this connection allows output, {@code false} 397adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * otherwise. 398adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #doOutput 399adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 400adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public boolean getDoOutput() { 401adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return doOutput; 402adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 403adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 404adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 4056247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the timestamp when this response will be expired in milliseconds 406adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * since January 1, 1970 GMT or {@code 0} if this timestamp is unknown. 407f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 408adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the response header field {@code expires}. 409adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 410adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public long getExpiration() { 411f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes return getHeaderFieldDate("Expires", 0); 412adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 413adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 414adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 4156247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the table which is used by all {@code URLConnection} instances to 416adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * determine the MIME-type according to a file extension. 417f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 418adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the file name map to determine the MIME-type. 419adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 420adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public static FileNameMap getFileNameMap() { 42155392539fea537abfb6581b474918f9d611fba27Jesse Wilson synchronized (URLConnection.class) { 42255392539fea537abfb6581b474918f9d611fba27Jesse Wilson if (fileNameMap == null) { 4237b3ebefcdf79a251cf2a5619dd2354952fc67665Elliott Hughes fileNameMap = new DefaultFileNameMap(); 42455392539fea537abfb6581b474918f9d611fba27Jesse Wilson } 42555392539fea537abfb6581b474918f9d611fba27Jesse Wilson return fileNameMap; 426adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 427adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 428adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 429adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 4306247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the header value at the field position {@code pos} or {@code null} 4316247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * if the header has fewer than {@code pos} fields. The base 432adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * implementation of this method returns always {@code null}. 433f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 4346247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * <p>Some implementations (notably {@code HttpURLConnection}) include a mapping 4356247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * for the null key; in HTTP's case, this maps to the HTTP status line and is 4366247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * treated as being at position 0 when indexing into the header fields. 4376247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * 438adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param pos 439adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the field position of the response header. 440adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the field at position {@code pos}. 441adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 442adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public String getHeaderField(int pos) { 443adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return null; 444adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 445adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 446adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 4470c59055dd24e1659f85d9ff7e2148883f663bd62Jesse Wilson * Returns an unmodifiable map of the response-header fields and values. The 448adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * response-header field names are the key values of the map. The map values 449adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * are lists of header field values associated with a particular key name. 450f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 4516247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * <p>Some implementations (notably {@code HttpURLConnection}) include a mapping 4526247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * for the null key; in HTTP's case, this maps to the HTTP status line and is 4536247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * treated as being at position 0 when indexing into the header fields. 4546247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * 455adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the response-header representing generic map. 456f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * @since 1.4 457adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 458adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public Map<String, List<String>> getHeaderFields() { 459adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return Collections.emptyMap(); 460adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 461adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 462adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 4630c59055dd24e1659f85d9ff7e2148883f663bd62Jesse Wilson * Returns an unmodifiable map of general request properties used by this 464adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * connection. The request property names are the key values of the map. The 465adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * map values are lists of property values of the corresponding key name. 466f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 467adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the request-property representing generic map. 468f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * @since 1.4 469adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 470adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public Map<String, List<String>> getRequestProperties() { 471b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes checkNotConnected(); 472b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes return Collections.emptyMap(); 473b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes } 474b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes 475b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes private void checkNotConnected() { 476adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (connected) { 477b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes throw new IllegalStateException("Already connected"); 478adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 479adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 480adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 481adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 482adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Adds the given property to the request header. Existing properties with 483adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the same name will not be overwritten by this method. 484f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 485adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param field 486adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the request property field name to add. 487adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param newValue 488adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the value of the property which is to add. 489adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalStateException 490adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if the connection has been already established. 491adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws NullPointerException 492adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if the property name is {@code null}. 493f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * @since 1.4 494adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 495adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void addRequestProperty(String field, String newValue) { 496b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes checkNotConnected(); 497adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (field == null) { 498b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes throw new NullPointerException("field == null"); 499adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 500adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 501adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 502adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 5036247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the value of the header field specified by {@code key} or {@code 5046247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * null} if there is no field with this name. The base implementation of 505adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * this method returns always {@code null}. 506f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 5076247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * <p>Some implementations (notably {@code HttpURLConnection}) include a mapping 5086247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * for the null key; in HTTP's case, this maps to the HTTP status line and is 5096247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * treated as being at position 0 when indexing into the header fields. 5106247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * 511adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param key 512adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the name of the header field. 513adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the header field. 514adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 515adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public String getHeaderField(String key) { 516adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return null; 517adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 518adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 519adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 5206247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the specified header value as a date in milliseconds since January 521adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 1, 1970 GMT. Returns the {@code defaultValue} if no such header field 522adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * could be found. 523f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 524adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param field 525adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the header field name whose value is needed. 526adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param defaultValue 527adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the default value if no field has been found. 528adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the specified header field as a date in 529adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * milliseconds. 530adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 531f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson @SuppressWarnings("deprecation") 532adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public long getHeaderFieldDate(String field, long defaultValue) { 533adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project String date = getHeaderField(field); 534adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (date == null) { 535adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return defaultValue; 536adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 537f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson try { 538953df613522e12a418cb7cb73248594d6c9f53d4Jesse Wilson return Date.parse(date); // TODO: use HttpDate.parse() 539f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } catch (Exception e) { 540f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson return defaultValue; 541f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } 542adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 543adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 544adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 5456247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the specified header value as a number. Returns the {@code 546adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * defaultValue} if no such header field could be found or the value could 547adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * not be parsed as an {@code Integer}. 548f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 549adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param field 550adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the header field name whose value is needed. 551adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param defaultValue 552adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the default value if no field has been found. 553adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the specified header field as a number. 554adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 555adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public int getHeaderFieldInt(String field, int defaultValue) { 556adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project try { 557adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return Integer.parseInt(getHeaderField(field)); 558adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } catch (NumberFormatException e) { 559adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return defaultValue; 560adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 561adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 562adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 563adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 5646247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the name of the header field at the given position {@code posn} or 5656247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * {@code null} if there are fewer than {@code posn} fields. The base 566adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * implementation of this method returns always {@code null}. 567f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 5686247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * <p>Some implementations (notably {@code HttpURLConnection}) include a mapping 5696247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * for the null key; in HTTP's case, this maps to the HTTP status line and is 5706247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * treated as being at position 0 when indexing into the header fields. 5716247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * 572adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param posn 573adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the position of the header field which has to be returned. 574adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the header field name at the given position. 575adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 576adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public String getHeaderFieldKey(int posn) { 577adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return null; 578adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 579adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 580adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 5816247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the point of time since when the data must be modified to be 582adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * transmitted. Some protocols transmit data only if it has been modified 583adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * more recently than a particular time. 584f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 585adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the time in milliseconds since January 1, 1970 GMT. 586adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #ifModifiedSince 587adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 588adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public long getIfModifiedSince() { 589adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return ifModifiedSince; 590adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 591adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 592adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 5936247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns an {@code InputStream} for reading data from the resource pointed by 594adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * this {@code URLConnection}. It throws an UnknownServiceException by 595adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * default. This method must be overridden by its subclasses. 596f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 597adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the InputStream to read data from. 598adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IOException 599adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if no InputStream could be created. 600adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 601adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public InputStream getInputStream() throws IOException { 602b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes throw new UnknownServiceException("Does not support writing to the input stream"); 603adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 604adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 605adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 6066247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the value of the response header field {@code last-modified} or 607adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@code 0} if this value is not set. 608f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 609adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the {@code last-modified} header field. 610adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 611adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public long getLastModified() { 612adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (lastModified != -1) { 613adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return lastModified; 614adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 615f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes return lastModified = getHeaderFieldDate("Last-Modified", 0); 616adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 617adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 618adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 6196247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns an {@code OutputStream} for writing data to this {@code 620adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * URLConnection}. It throws an {@code UnknownServiceException} by default. 621adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * This method must be overridden by its subclasses. 622f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 623adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the OutputStream to write data. 624adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IOException 625adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if no OutputStream could be created. 626adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 627adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public OutputStream getOutputStream() throws IOException { 628b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes throw new UnknownServiceException("Does not support writing to the output stream"); 629adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 630adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 631adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 6326247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns a {@code Permission} object representing all needed permissions to 633adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * open this connection. The returned permission object depends on the state 634adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * of the connection and will be {@code null} if no permissions are 635adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * necessary. By default, this method returns {@code AllPermission}. 636adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Subclasses should overwrite this method to return an appropriate 637adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * permission object. 638f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 639adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the permission object representing the needed permissions to open 640adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * this connection. 641adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IOException 642adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if an I/O error occurs while creating the permission object. 643adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 644adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public java.security.Permission getPermission() throws IOException { 645adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return new java.security.AllPermission(); 646adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 647adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 648adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 6496247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the value of the request header property specified by {code field} 6506247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * or {@code null} if there is no field with this name. The base 651adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * implementation of this method returns always {@code null}. 652f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 653adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param field 654adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the name of the request header property. 655adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the property. 656adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalStateException 657adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if the connection has been already established. 658adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 659adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public String getRequestProperty(String field) { 660b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes checkNotConnected(); 661adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return null; 662adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 663adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 664adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 6656247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the URL represented by this {@code URLConnection}. 666f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 667adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the URL of this connection. 668adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 669adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public URL getURL() { 670adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return url; 671adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 672adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 673adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 6746247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the value of the flag which specifies whether this {@code 675adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * URLConnection} allows to use caches. 676f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 677adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return {@code true} if using caches is allowed, {@code false} otherwise. 678adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 679adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public boolean getUseCaches() { 680adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return useCaches; 681adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 682adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 683adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 684adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Determines the MIME-type of the given resource {@code url} by resolving 685adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the filename extension with the internal FileNameMap. Any fragment 686adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * identifier is removed before processing. 687f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 688adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param url 689adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the URL with the filename to get the MIME type. 690adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the guessed content type or {@code null} if the type could not be 691adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * determined. 692adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 693adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public static String guessContentTypeFromName(String url) { 694adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return getFileNameMap().getContentTypeFor(url); 695adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 696adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 697adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 698adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Determines the MIME-type of the resource represented by the input stream 699adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@code is} by reading its first few characters. 700f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 701adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param is 702adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the resource representing input stream to determine the 703adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * content type. 704adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the guessed content type or {@code null} if the type could not be 705adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * determined. 706adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IOException 707adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if an I/O error occurs while reading from the input stream. 708adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 7091c4b8eb0aebfe7f99c10fb1d01716946e8e74ad7Elliott Hughes public static String guessContentTypeFromStream(InputStream is) throws IOException { 710adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (!is.markSupported()) { 711adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return null; 712adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 713f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson // Look ahead up to 64 bytes for the longest encoded header 714f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson is.mark(64); 715f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson byte[] bytes = new byte[64]; 716f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson int length = is.read(bytes); 717adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project is.reset(); 718f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson 7190b2836e81d354e9bb7df9d43cda5ccfb9c199450Elliott Hughes // If there is no data from the input stream, we can't determine content type. 7200b2836e81d354e9bb7df9d43cda5ccfb9c199450Elliott Hughes if (length == -1) { 7210b2836e81d354e9bb7df9d43cda5ccfb9c199450Elliott Hughes return null; 7220b2836e81d354e9bb7df9d43cda5ccfb9c199450Elliott Hughes } 7230b2836e81d354e9bb7df9d43cda5ccfb9c199450Elliott Hughes 724f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson // Check for Unicode BOM encoding indicators 725e810d3b49631329b11440aa5b7a54db181d42ed1Elliott Hughes String encoding = "US-ASCII"; 726f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson int start = 0; 727f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if (length > 1) { 728f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if ((bytes[0] == (byte) 0xFF) && (bytes[1] == (byte) 0xFE)) { 729f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson encoding = "UTF-16LE"; 730f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson start = 2; 731f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson length -= length & 1; 732f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } 733f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if ((bytes[0] == (byte) 0xFE) && (bytes[1] == (byte) 0xFF)) { 734f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson encoding = "UTF-16BE"; 735f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson start = 2; 736f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson length -= length & 1; 737f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } 738f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if (length > 2) { 739f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if ((bytes[0] == (byte) 0xEF) && (bytes[1] == (byte) 0xBB) 740f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson && (bytes[2] == (byte) 0xBF)) { 741f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson encoding = "UTF-8"; 742f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson start = 3; 743f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } 744f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if (length > 3) { 745f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if ((bytes[0] == (byte) 0x00) && (bytes[1] == (byte) 0x00) 746f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson && (bytes[2] == (byte) 0xFE) 747f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson && (bytes[3] == (byte) 0xFF)) { 748f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson encoding = "UTF-32BE"; 749f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson start = 4; 750f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson length -= length & 3; 751f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } 752f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if ((bytes[0] == (byte) 0xFF) && (bytes[1] == (byte) 0xFE) 753f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson && (bytes[2] == (byte) 0x00) 754f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson && (bytes[3] == (byte) 0x00)) { 755f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson encoding = "UTF-32LE"; 756f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson start = 4; 757f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson length -= length & 3; 758f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } 759f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } 760f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } 761adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 762f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson 763f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson String header = new String(bytes, start, length - start, encoding); 764f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson 765f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson // Check binary types 766f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if (header.startsWith("PK")) { 767f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson return "application/zip"; 768adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 769f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if (header.startsWith("GI")) { 770f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson return "image/gif"; 771adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 772f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson 773f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson // Check text types 77478e3320540c8bdcbefba5ae1222ee18f6679ab33Elliott Hughes String textHeader = header.trim().toUpperCase(Locale.US); 775f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if (textHeader.startsWith("<!DOCTYPE HTML") || 776f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson textHeader.startsWith("<HTML") || 777f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson textHeader.startsWith("<HEAD") || 778f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson textHeader.startsWith("<BODY") || 779f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson textHeader.startsWith("<HEAD")) { 780f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson return "text/html"; 781f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } 782f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson 783f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson if (textHeader.startsWith("<?XML")) { 784f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson return "application/xml"; 785f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson } 786f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson 787f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson // Give up 788adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return null; 789adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 790adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 791adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 792adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Performs any necessary string parsing on the input string such as 793adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * converting non-alphanumeric character into underscore. 794f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 795adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param typeString 796adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the parsed string 797adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the string to be parsed 798adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 799adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project private String parseTypeString(String typeString) { 8008216dc1fd9d31867770439985c3d66570330e4c7Elliott Hughes StringBuilder result = new StringBuilder(typeString); 8018216dc1fd9d31867770439985c3d66570330e4c7Elliott Hughes for (int i = 0; i < result.length(); i++) { 802adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project // if non-alphanumeric, replace it with '_' 8038216dc1fd9d31867770439985c3d66570330e4c7Elliott Hughes char c = result.charAt(i); 804adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (!(Character.isLetter(c) || Character.isDigit(c) || c == '.')) { 8058216dc1fd9d31867770439985c3d66570330e4c7Elliott Hughes result.setCharAt(i, '_'); 806adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 807adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 8088216dc1fd9d31867770439985c3d66570330e4c7Elliott Hughes return result.toString(); 809adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 810adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 811adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 812adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the flag indicating whether this connection allows user interaction 813adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * or not. This method can only be called prior to the connection 814adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * establishment. 815f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 816adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param newValue 817adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the value of the flag to be set. 818adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalStateException 819adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if this method attempts to change the flag after the 820adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * connection has been established. 821adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #allowUserInteraction 822adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 823adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void setAllowUserInteraction(boolean newValue) { 824b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes checkNotConnected(); 825adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project this.allowUserInteraction = newValue; 826adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 827adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 828adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 829adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the internally used content handler factory. The content factory can 83087548e8585334658c3ee89050ec917a10ca35e5aElliott Hughes * only be set once during the lifetime of the application. 831f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 832adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param contentFactory 833adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the content factory to be set. 834adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws Error 835ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes * if the factory has been already set. 836adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 837ad41624e761bcf1af9c8008eb45187fc13983717Elliott Hughes public static synchronized void setContentHandlerFactory(ContentHandlerFactory contentFactory) { 838adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (contentHandlerFactory != null) { 839b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes throw new Error("Factory already set"); 840adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 841adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project contentHandlerFactory = contentFactory; 842adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 843adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 844adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 845adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the default value for the flag indicating whether this connection 846adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * allows user interaction or not. Existing {@code URLConnection}s are 847adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * unaffected. 848f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 849adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param allows 850adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the default value of the flag to be used for new connections. 851adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #defaultAllowUserInteraction 852adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #allowUserInteraction 853adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 854adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public static void setDefaultAllowUserInteraction(boolean allows) { 855adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project defaultAllowUserInteraction = allows; 856adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 857adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 858adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 859adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the default value of the specified request header field. This value 860adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * will be used for the specific field of every newly created connection. 8616247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * The base implementation of this method does nothing. 862f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 863adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param field 864adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the request header field to be set. 865adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param value 866adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the default value to be used. 867adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @deprecated Use {@link #setRequestProperty} of an existing {@code 868adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * URLConnection} instance. 869adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 870adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project @Deprecated 871adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public static void setDefaultRequestProperty(String field, String value) { 872adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 873adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 874adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 875adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the default value for the flag indicating whether this connection 876adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * allows to use caches. Existing {@code URLConnection}s are unaffected. 877f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 878adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param newValue 879adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the default value of the flag to be used for new connections. 880adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #useCaches 881adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 882adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void setDefaultUseCaches(boolean newValue) { 883adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project defaultUseCaches = newValue; 884adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 885adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 886adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 887adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the flag indicating whether this {@code URLConnection} allows input. 888adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * It cannot be set after the connection is established. 889f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 890adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param newValue 891adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the new value for the flag to be set. 892adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalAccessError 893adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if this method attempts to change the value after the 894adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * connection has been already established. 895adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #doInput 896adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 897adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void setDoInput(boolean newValue) { 898b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes checkNotConnected(); 899adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project this.doInput = newValue; 900adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 901adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 902adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 903adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the flag indicating whether this {@code URLConnection} allows 904adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * output. It cannot be set after the connection is established. 905f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 906adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param newValue 907adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the new value for the flag to be set. 908adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalAccessError 909adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if this method attempts to change the value after the 910adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * connection has been already established. 911adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #doOutput 912adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 913adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void setDoOutput(boolean newValue) { 914b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes checkNotConnected(); 915adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project this.doOutput = newValue; 916adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 917adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 918adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 919adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the internal map which is used by all {@code URLConnection} 920adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * instances to determine the MIME-type according to a filename extension. 921f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 922adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param map 923adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the MIME table to be set. 924adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 925adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public static void setFileNameMap(FileNameMap map) { 92655392539fea537abfb6581b474918f9d611fba27Jesse Wilson synchronized (URLConnection.class) { 92755392539fea537abfb6581b474918f9d611fba27Jesse Wilson fileNameMap = map; 92855392539fea537abfb6581b474918f9d611fba27Jesse Wilson } 929adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 930adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 931adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 932adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the point of time since when the data must be modified to be 933adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * transmitted. Some protocols transmit data only if it has been modified 934adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * more recently than a particular time. The data will be transmitted 935adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * regardless of its timestamp if this option is set to {@code 0}. 936f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 937adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param newValue 938adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the time in milliseconds since January 1, 1970 GMT. 939adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalStateException 940adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if this {@code URLConnection} has already been connected. 941adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #ifModifiedSince 942adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 943adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void setIfModifiedSince(long newValue) { 944b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes checkNotConnected(); 945adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project this.ifModifiedSince = newValue; 946adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 947adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 948adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 949adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the value of the specified request header field. The value will only 950adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * be used by the current {@code URLConnection} instance. This method can 951adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * only be called before the connection is established. 952f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 953adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param field 954adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the request header field to be set. 955adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param newValue 956adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the new value of the specified property. 957adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalStateException 958adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if the connection has been already established. 959adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws NullPointerException 960adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if the parameter {@code field} is {@code null}. 961adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 962adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void setRequestProperty(String field, String newValue) { 963b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes checkNotConnected(); 964adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (field == null) { 965b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes throw new NullPointerException("field == null"); 966adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 967adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 968adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 969adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 970adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the flag indicating whether this connection allows to use caches or 971adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * not. This method can only be called prior to the connection 972adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * establishment. 973f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 974adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param newValue 975adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the value of the flag to be set. 976adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalStateException 977adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if this method attempts to change the flag after the 978adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * connection has been established. 979adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #useCaches 980adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 981adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void setUseCaches(boolean newValue) { 982b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes checkNotConnected(); 983adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project this.useCaches = newValue; 984adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 985adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 986adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 987adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the timeout value in milliseconds for establishing the connection to 988adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the resource pointed by this {@code URLConnection} instance. A {@code 989adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * SocketTimeoutException} is thrown if the connection could not be 990adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * established in this time. Default is {@code 0} which stands for an 991adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * infinite timeout. 992f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 993adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param timeout 994adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the connecting timeout in milliseconds. 995adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalArgumentException 996adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if the parameter {@code timeout} is less than zero. 997adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 998adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void setConnectTimeout(int timeout) { 999b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes if (timeout < 0) { 1000b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes throw new IllegalArgumentException("timeout < 0"); 1001adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1002adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project this.connectTimeout = timeout; 1003adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1004adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 1005adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 10066247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the configured connecting timeout. 1007f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 1008adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the connecting timeout value in milliseconds. 1009adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 1010adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public int getConnectTimeout() { 1011adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return connectTimeout; 1012adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1013adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 1014adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 1015adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the timeout value in milliseconds for reading from the input stream 1016adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * of an established connection to the resource. A {@code 1017adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * SocketTimeoutException} is thrown if the connection could not be 1018adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * established in this time. Default is {@code 0} which stands for an 1019adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * infinite timeout. 1020f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 1021adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param timeout 1022adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the reading timeout in milliseconds. 1023adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalArgumentException 1024adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if the parameter {@code timeout} is less than zero. 1025adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 1026adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void setReadTimeout(int timeout) { 1027b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes if (timeout < 0) { 1028b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes throw new IllegalArgumentException("timeout < 0"); 1029adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1030adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project this.readTimeout = timeout; 1031adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1032adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 1033adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 10346247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes * Returns the configured timeout for reading from the input stream of an 1035adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * established connection to the resource. 1036f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 1037adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the reading timeout value in milliseconds. 1038adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 1039adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public int getReadTimeout() { 1040adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return readTimeout; 1041adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1042adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 1043adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 1044adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns the string representation containing the name of this class and 1045adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the URL. 1046f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * 1047adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the string representation of this {@code URLConnection} instance. 1048adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 1049adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project @Override 1050adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public String toString() { 10516247987eb505a482a67f5f19678260d9e7240a5fElliott Hughes return getClass().getName() + ":" + url.toString(); 1052adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1053adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 1054adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project static class DefaultContentHandler extends java.net.ContentHandler { 1055adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project @Override 1056adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public Object getContent(URLConnection u) throws IOException { 1057adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return u.getInputStream(); 1058adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1059adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1060adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project} 1061