2024年04月30日
URISyntaxException (Java SE 21 & JDK 21) の使用例まとめです。
だいたいのメソッドを網羅済みです。
API仕様書のおともにどうぞ。
概要
文字列をURI参照として解析できなかったことを示すためにスローされたチェック例外です。
URISyntaxException は、URI 構文が間違っているときに発生するチェック例外です。
try {
final var uri = new URI("★://example.com/");
} catch (URISyntaxException e) {
System.out.println("URISyntaxException! : " + e.getMessage());
}
// 結果
// ↓
//URISyntaxException! : Illegal character in scheme name at index 0: ★://example.com/
コンストラクタ
URISyntaxException (String input, String reason)
指定された入力文字列と理由からインスタンスを構築します。
final var e = new URISyntaxException("abc", "XYZ");
System.out.println(e); // java.net.URISyntaxException: XYZ: abc
URISyntaxException (String input, String reason, int index)
指定された入力文字列、理由、およびエラー・インデックスからインスタンスを構築します。
final var e = new URISyntaxException("abc", "XYZ", 123);
System.out.println(e); // java.net.URISyntaxException: XYZ at index 123: abc
メソッド
int getIndex ()
解析エラーが発生した入力文字列内の位置を示すインデックスを返します。位置が不明な場合は-1を返します。
final var e = new URISyntaxException("abc", "XYZ", 123);
System.out.println(e.getMessage()); // XYZ at index 123: abc
System.out.println(e.getInput()); // abc
System.out.println(e.getReason()); // XYZ
System.out.println(e.getIndex()); // 123
String getInput ()
入力文字列を返します。
final var e = new URISyntaxException("abc", "XYZ", 123);
System.out.println(e.getMessage()); // XYZ at index 123: abc
System.out.println(e.getInput()); // abc
System.out.println(e.getReason()); // XYZ
System.out.println(e.getIndex()); // 123
String getMessage ()
解析エラーを記述する文字列を返します。
final var e = new URISyntaxException("abc", "XYZ", 123);
System.out.println(e.getMessage()); // XYZ at index 123: abc
System.out.println(e.getInput()); // abc
System.out.println(e.getReason()); // XYZ
System.out.println(e.getIndex()); // 123
String getReason ()
入力文字列を解析できなかった理由を説明する文字列を返します。
final var e = new URISyntaxException("abc", "XYZ", 123);
System.out.println(e.getMessage()); // XYZ at index 123: abc
System.out.println(e.getInput()); // abc
System.out.println(e.getReason()); // XYZ
System.out.println(e.getIndex()); // 123
Throwableで宣言されたメソッド
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
「Java API 使用例 : Throwable」をご参照ください。