151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski/* 23a6411ec91b24e73f36301d0075bc7b052894ae9Yi Kong * Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved. 351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This code is free software; you can redistribute it and/or modify it 651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * under the terms of the GNU General Public License version 2 only, as 751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * published by the Free Software Foundation. Oracle designates this 851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * particular file as subject to the "Classpath" exception as provided 951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * by Oracle in the LICENSE file that accompanied this code. 1051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 1151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This code is distributed in the hope that it will be useful, but WITHOUT 1251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 1351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 1451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * version 2 for more details (a copy is included in the LICENSE file that 1551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * accompanied this code). 1651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 1751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * You should have received a copy of the GNU General Public License version 1851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 2 along with this work; if not, write to the Free Software Foundation, 1951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 2051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 2151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 2251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * or visit www.oracle.com if you need additional information or have any 2351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * questions. 2451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 2551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 2651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebskipackage java.net; 2751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 2851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 2951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski/** 3051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Checked exception thrown to indicate that a string could not be parsed as a 3151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * URI reference. 3251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 3351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @author Mark Reinhold 3451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see URI 3551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @since 1.4 3651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 3751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 3851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebskipublic class URISyntaxException 3951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski extends Exception 4051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski{ 4151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski private static final long serialVersionUID = 2137979680897488891L; 4251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 4351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski private String input; 4451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski private int index; 4551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 4651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 4751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Constructs an instance from the given input string, reason, and error 4851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * index. 4951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 5051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param input The input string 5151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param reason A string explaining why the input could not be parsed 5251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param index The index at which the parse error occurred, 533a6411ec91b24e73f36301d0075bc7b052894ae9Yi Kong * or {@code -1} if the index is not known 5451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 5551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @throws NullPointerException 563a6411ec91b24e73f36301d0075bc7b052894ae9Yi Kong * If either the input or reason strings are {@code null} 5751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 5851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @throws IllegalArgumentException 593a6411ec91b24e73f36301d0075bc7b052894ae9Yi Kong * If the error index is less than {@code -1} 6051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 6151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public URISyntaxException(String input, String reason, int index) { 6251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski super(reason); 6351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if ((input == null) || (reason == null)) 6451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw new NullPointerException(); 6551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (index < -1) 6651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw new IllegalArgumentException(); 6751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski this.input = input; 6851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski this.index = index; 6951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 7051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 7151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 7251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Constructs an instance from the given input string and reason. The 733a6411ec91b24e73f36301d0075bc7b052894ae9Yi Kong * resulting object will have an error index of {@code -1}. 7451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 7551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param input The input string 7651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param reason A string explaining why the input could not be parsed 7751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 7851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @throws NullPointerException 793a6411ec91b24e73f36301d0075bc7b052894ae9Yi Kong * If either the input or reason strings are {@code null} 8051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 8151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public URISyntaxException(String input, String reason) { 8251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski this(input, reason, -1); 8351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 8451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 8551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 8651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Returns the input string. 8751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 8851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return The input string 8951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 9051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public String getInput() { 9151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return input; 9251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 9351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 9451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 9551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Returns a string explaining why the input string could not be parsed. 9651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 9751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return The reason string 9851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 9951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public String getReason() { 10051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return super.getMessage(); 10151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 10251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 10351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 10451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Returns an index into the input string of the position at which the 1053a6411ec91b24e73f36301d0075bc7b052894ae9Yi Kong * parse error occurred, or {@code -1} if this position is not known. 10651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 10751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return The error index 10851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 10951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public int getIndex() { 11051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return index; 11151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 11251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 11351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 11451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Returns a string describing the parse error. The resulting string 11551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * consists of the reason string followed by a colon character 1163a6411ec91b24e73f36301d0075bc7b052894ae9Yi Kong * ({@code ':'}), a space, and the input string. If the error index is 1173a6411ec91b24e73f36301d0075bc7b052894ae9Yi Kong * defined then the string {@code " at index "} followed by the index, in 11851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * decimal, is inserted after the reason string and before the colon 11951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * character. 12051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 12151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return A string describing the parse error 12251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 12351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public String getMessage() { 12451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski StringBuffer sb = new StringBuffer(); 12551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski sb.append(getReason()); 12651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (index > -1) { 12751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski sb.append(" at index "); 12851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski sb.append(index); 12951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 13051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski sb.append(": "); 13151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski sb.append(input); 13251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return sb.toString(); 13351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 13451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 13551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski} 136