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; 215292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilsonimport libcore.net.url.UrlUtils; 226186821cb13f4ac7ff50950c813394367e021eaeJesse Wilsonimport libcore.util.Objects; 23adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 24adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project/** 25adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * The abstract class {@code URLStreamHandler} is the base for all classes which 26adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * can handle the communication with a URL object over a particular protocol 27adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * type. 28adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 29adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectpublic abstract class URLStreamHandler { 30adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 31adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Establishes a new connection to the resource specified by the URL {@code 32adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * u}. Since different protocols also have unique ways of connecting, it 33adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * must be overwritten by the subclass. 34f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 35adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param u 36adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the URL to the resource where a connection has to be opened. 37adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the opened URLConnection to the specified resource. 38adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IOException 39adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if an I/O error occurs during opening the connection. 40adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 41adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project protected abstract URLConnection openConnection(URL u) throws IOException; 42adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 43adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 44adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Establishes a new connection to the resource specified by the URL {@code 45adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * u} using the given {@code proxy}. Since different protocols also have 46adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * unique ways of connecting, it must be overwritten by the subclass. 47f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 48adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param u 49adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the URL to the resource where a connection has to be opened. 50adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param proxy 51adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the proxy that is used to make the connection. 52adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the opened URLConnection to the specified resource. 53adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IOException 54adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if an I/O error occurs during opening the connection. 55adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalArgumentException 56adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if any argument is {@code null} or the type of proxy is 57adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * wrong. 58adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws UnsupportedOperationException 59adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if the protocol handler doesn't support this method. 60adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 61b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes protected URLConnection openConnection(URL u, Proxy proxy) throws IOException { 62b1396870f92135aa140bd2b86221768dea5bc11dElliott Hughes throw new UnsupportedOperationException(); 63adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 64adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 65adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 66adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Parses the clear text URL in {@code str} into a URL object. URL strings 67adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * generally have the following format: 68adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * <p> 69adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * http://www.company.com/java/file1.java#reference 70f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * <p> 71adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * The string is parsed in HTTP format. If the protocol has a different URL 72adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * format this method must be overridden. 73f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 745292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson * @param url 75adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the URL to fill in the parsed clear text URL parts. 765292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson * @param spec 77adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the URL string that is to be parsed. 78adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param start 79adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the string position from where to begin parsing. 80adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param end 81adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the string position to stop parsing. 82adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #toExternalForm 83adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see URL 84adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 855292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson protected void parseURL(URL url, String spec, int start, int end) { 865292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson if (this != url.streamHandler) { 875292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson throw new SecurityException("Only a URL's stream handler is permitted to mutate it"); 88adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 89adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (end < start) { 905292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson throw new StringIndexOutOfBoundsException(spec, start, end - start); 91adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 92adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 935292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson int fileStart; 945292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson String authority; 955292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson String userInfo; 965292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson String host; 975292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson int port = -1; 985292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson String path; 995292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson String query; 1005292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson String ref; 1015292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson if (spec.regionMatches(start, "//", 0, 2)) { 1025292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson // Parse the authority from the spec. 1035292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson int authorityStart = start + 2; 104ce257b03a1e5ff6075967e6a84cdb439cb2b01c8Jesse Wilson fileStart = UrlUtils.findFirstOf(spec, "/?#", authorityStart, end); 1055292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson authority = spec.substring(authorityStart, fileStart); 106ce257b03a1e5ff6075967e6a84cdb439cb2b01c8Jesse Wilson int userInfoEnd = UrlUtils.findFirstOf(spec, "@", authorityStart, fileStart); 1075292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson int hostStart; 1085292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson if (userInfoEnd != fileStart) { 1095292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson userInfo = spec.substring(authorityStart, userInfoEnd); 1105292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson hostStart = userInfoEnd + 1; 1118fd0225a5c3918fe0cd4680258388985c25533e5Jesse Wilson } else { 1125292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson userInfo = null; 1135292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson hostStart = authorityStart; 114adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 115adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 1165292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson /* 1175292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson * Extract the host and port. The host may be an IPv6 address with 1185292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson * colons like "[::1]", in which case we look for the port delimiter 1195292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson * colon after the ']' character. 1205292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson */ 12198c564c72480313ae2954a7f0b666ff94345a2f1Jesse Wilson int colonSearchFrom = hostStart; 122ce257b03a1e5ff6075967e6a84cdb439cb2b01c8Jesse Wilson int ipv6End = UrlUtils.findFirstOf(spec, "]", hostStart, fileStart); 12398c564c72480313ae2954a7f0b666ff94345a2f1Jesse Wilson if (ipv6End != fileStart) { 12498c564c72480313ae2954a7f0b666ff94345a2f1Jesse Wilson if (UrlUtils.findFirstOf(spec, ":", hostStart, ipv6End) == ipv6End) { 12598c564c72480313ae2954a7f0b666ff94345a2f1Jesse Wilson throw new IllegalArgumentException("Expected an IPv6 address: " 12698c564c72480313ae2954a7f0b666ff94345a2f1Jesse Wilson + spec.substring(hostStart, ipv6End + 1)); 12798c564c72480313ae2954a7f0b666ff94345a2f1Jesse Wilson } 12898c564c72480313ae2954a7f0b666ff94345a2f1Jesse Wilson colonSearchFrom = ipv6End; 12998c564c72480313ae2954a7f0b666ff94345a2f1Jesse Wilson } 130ce257b03a1e5ff6075967e6a84cdb439cb2b01c8Jesse Wilson int hostEnd = UrlUtils.findFirstOf(spec, ":", colonSearchFrom, fileStart); 1315292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson host = spec.substring(hostStart, hostEnd); 1325292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson int portStart = hostEnd + 1; 1335292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson if (portStart < fileStart) { 1345292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson port = Integer.parseInt(spec.substring(portStart, fileStart)); 1355292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson if (port < 0) { 1365292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson throw new IllegalArgumentException("port < 0: " + port); 137adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 138adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1395292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson path = null; 140adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project query = null; 1415292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson ref = null; 1425292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson } else { 1435292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson // Get the authority from the context URL. 1445292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson fileStart = start; 1455292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson authority = url.getAuthority(); 1465292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson userInfo = url.getUserInfo(); 1475292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson host = url.getHost(); 1485292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson if (host == null) { 1495292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson host = ""; 1505292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson } 1515292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson port = url.getPort(); 1525292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson path = url.getPath(); 1535292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson query = url.getQuery(); 1545292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson ref = url.getRef(); 155adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 156adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 1575292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson /* 1585292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson * Extract the path, query and fragment. Each part has its own leading 1595292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson * delimiter character. The query can contain slashes and the fragment 1605292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson * can contain slashes and question marks. 1615292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson * / path ? query # fragment 1625292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson */ 1635292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson int pos = fileStart; 1645292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson while (pos < end) { 1655292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson int nextPos; 1665292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson switch (spec.charAt(pos)) { 1675292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson case '#': 1685292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson nextPos = end; 1695292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson ref = spec.substring(pos + 1, nextPos); 1705292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson break; 1715292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson case '?': 172ce257b03a1e5ff6075967e6a84cdb439cb2b01c8Jesse Wilson nextPos = UrlUtils.findFirstOf(spec, "#", pos, end); 1735292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson query = spec.substring(pos + 1, nextPos); 1745292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson ref = null; 1755292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson break; 1765292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson default: 177ce257b03a1e5ff6075967e6a84cdb439cb2b01c8Jesse Wilson nextPos = UrlUtils.findFirstOf(spec, "?#", pos, end); 1785292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson path = relativePath(path, spec.substring(pos, nextPos)); 1795292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson query = null; 1805292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson ref = null; 1815292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson break; 182adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1835292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson pos = nextPos; 184adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 1855292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson 1865292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson if (path == null) { 1875292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson path = ""; 188adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 189adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 1902d99ef561304174b8ae01a0a68d5b96d5edb9f10Jesse Wilson path = UrlUtils.authoritySafePath(authority, path); 191adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 1925292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson setURL(url, url.getProtocol(), host, port, authority, userInfo, path, query, ref); 1935292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson } 1945292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson 1955292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson /** 1965292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson * Returns a new path by resolving {@code path} relative to {@code base}. 1975292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson */ 1985292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson private static String relativePath(String base, String path) { 1995292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson if (path.startsWith("/")) { 200c5727263001f1eae068f7821063d7bfb2da8e24cJesse Wilson return UrlUtils.canonicalizePath(path, true); 2015292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson } else if (base != null) { 2025292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson String combined = base.substring(0, base.lastIndexOf('/') + 1) + path; 203c5727263001f1eae068f7821063d7bfb2da8e24cJesse Wilson return UrlUtils.canonicalizePath(combined, true); 2045292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson } else { 2055292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson return path; 2065292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson } 207adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 208adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 209adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 210adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the fields of the URL {@code u} to the values of the supplied 211adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * arguments. 212f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 213adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param u 214adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the non-null URL object to be set. 215adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param protocol 216adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the protocol. 217adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param host 218adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the host name. 219adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param port 220adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the port number. 221adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param file 222adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the file component. 223adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param ref 224adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the reference. 22599b4489d0555c6e0e5df941cbfad4cf250c8f0b8Elliott Hughes * @deprecated Use setURL(URL, String String, int, String, String, String, 226adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * String, String) instead. 227adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 228adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project @Deprecated 229adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project protected void setURL(URL u, String protocol, String host, int port, 230adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project String file, String ref) { 2318f99aa098c6a06b8be788abbca1c1d1060342709Jesse Wilson if (this != u.streamHandler) { 232adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project throw new SecurityException(); 233adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 234adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project u.set(protocol, host, port, file, ref); 235adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 236adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 237adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 238adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the fields of the URL {@code u} to the values of the supplied 239adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * arguments. 240adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 241adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project protected void setURL(URL u, String protocol, String host, int port, 2425292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson String authority, String userInfo, String path, String query, 243adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project String ref) { 2448f99aa098c6a06b8be788abbca1c1d1060342709Jesse Wilson if (this != u.streamHandler) { 245adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project throw new SecurityException(); 246adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 2475292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson u.set(protocol, host, port, authority, userInfo, path, query, ref); 248adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 249adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 250adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 251adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns the clear text representation of a given URL using HTTP format. 252f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 253adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param url 254adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the URL object to be converted. 255adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the clear text representation of the specified URL. 256adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #parseURL 257adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see URL#toExternalForm() 258adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 259adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project protected String toExternalForm(URL url) { 260d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson return toExternalForm(url, false); 261d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson } 262d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson 263d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson String toExternalForm(URL url, boolean escapeIllegalCharacters) { 264d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson StringBuilder result = new StringBuilder(); 265d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson result.append(url.getProtocol()); 266d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson result.append(':'); 267d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson 268adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project String authority = url.getAuthority(); 2695292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson if (authority != null) { 270d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson result.append("//"); 271d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson if (escapeIllegalCharacters) { 27232559028b14b9b321b10eede050afd554a376569Jesse Wilson URI.AUTHORITY_ENCODER.appendPartiallyEncoded(result, authority); 27332559028b14b9b321b10eede050afd554a376569Jesse Wilson } else { 27432559028b14b9b321b10eede050afd554a376569Jesse Wilson result.append(authority); 275d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson } 276adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 277adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 278d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson String fileAndQuery = url.getFile(); 279d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson if (fileAndQuery != null) { 280d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson if (escapeIllegalCharacters) { 28132559028b14b9b321b10eede050afd554a376569Jesse Wilson URI.FILE_AND_QUERY_ENCODER.appendPartiallyEncoded(result, fileAndQuery); 28232559028b14b9b321b10eede050afd554a376569Jesse Wilson } else { 28332559028b14b9b321b10eede050afd554a376569Jesse Wilson result.append(fileAndQuery); 284d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson } 285a389b4a499f40379b0b204d7ba1c2057663d95c0Jesse Wilson } 286d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson 287d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson String ref = url.getRef(); 288adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (ref != null) { 289d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson result.append('#'); 290d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson if (escapeIllegalCharacters) { 29132559028b14b9b321b10eede050afd554a376569Jesse Wilson URI.ALL_LEGAL_ENCODER.appendPartiallyEncoded(result, ref); 29232559028b14b9b321b10eede050afd554a376569Jesse Wilson } else { 29332559028b14b9b321b10eede050afd554a376569Jesse Wilson result.append(ref); 294d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson } 295adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 296d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson 297d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson return result.toString(); 298d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson } 299d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson 300d1b5e5da828434388e486a388710d21e4306dae0Jesse Wilson /** 3017e00db4156e50ce5f20fefb820dca339299134d3Jesse Wilson * Returns true if {@code a} and {@code b} have the same protocol, host, 3027e00db4156e50ce5f20fefb820dca339299134d3Jesse Wilson * port, file, and reference. 303adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 3047e00db4156e50ce5f20fefb820dca339299134d3Jesse Wilson protected boolean equals(URL a, URL b) { 3057e00db4156e50ce5f20fefb820dca339299134d3Jesse Wilson return sameFile(a, b) 3067e00db4156e50ce5f20fefb820dca339299134d3Jesse Wilson && Objects.equal(a.getRef(), b.getRef()) 3077e00db4156e50ce5f20fefb820dca339299134d3Jesse Wilson && Objects.equal(a.getQuery(), b.getQuery()); 308adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 309adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 310adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 311adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns the default port of the protocol used by the handled URL. The 3127e00db4156e50ce5f20fefb820dca339299134d3Jesse Wilson * default implementation always returns {@code -1}. 313adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 314adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project protected int getDefaultPort() { 315adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return -1; 316adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 317adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 318adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 3197e00db4156e50ce5f20fefb820dca339299134d3Jesse Wilson * Returns the host address of {@code url}. 320adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 321adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project protected InetAddress getHostAddress(URL url) { 322adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project try { 323adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project String host = url.getHost(); 324adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (host == null || host.length() == 0) { 325adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return null; 326adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 327adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return InetAddress.getByName(host); 328adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } catch (UnknownHostException e) { 329adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return null; 330adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 331adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 332adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 333adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 3347e00db4156e50ce5f20fefb820dca339299134d3Jesse Wilson * Returns the hash code of {@code url}. 335adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 336adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project protected int hashCode(URL url) { 337adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return toExternalForm(url).hashCode(); 338adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 339adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 340adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 3417e00db4156e50ce5f20fefb820dca339299134d3Jesse Wilson * Returns true if the hosts of {@code a} and {@code b} are equal. 342adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 34367db542e53c47a28e3f96beb7c9e46330483dc40Jesse Wilson protected boolean hostsEqual(URL a, URL b) { 3447e00db4156e50ce5f20fefb820dca339299134d3Jesse Wilson // URLs with the same case-insensitive host name have equal hosts 3455292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson String aHost = a.getHost(); 3465292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson String bHost = b.getHost(); 3475292410e4ebf7fb5149eefd2f52fcb94c46690a6Jesse Wilson return (aHost == bHost) || aHost != null && aHost.equalsIgnoreCase(bHost); 348adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 349adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 350adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 3517e00db4156e50ce5f20fefb820dca339299134d3Jesse Wilson * Returns true if {@code a} and {@code b} have the same protocol, host, 3527e00db4156e50ce5f20fefb820dca339299134d3Jesse Wilson * port and file. 353adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 3547e00db4156e50ce5f20fefb820dca339299134d3Jesse Wilson protected boolean sameFile(URL a, URL b) { 3557e00db4156e50ce5f20fefb820dca339299134d3Jesse Wilson return Objects.equal(a.getProtocol(), b.getProtocol()) 3567e00db4156e50ce5f20fefb820dca339299134d3Jesse Wilson && hostsEqual(a, b) 3577e00db4156e50ce5f20fefb820dca339299134d3Jesse Wilson && a.getEffectivePort() == b.getEffectivePort() 3587e00db4156e50ce5f20fefb820dca339299134d3Jesse Wilson && Objects.equal(a.getFile(), b.getFile()); 359adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 360adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project} 361