深入剖析 `java.lang.IllegalArgumentException: URI is not absolute`

简介

在 Java 开发过程中，处理 URI（统一资源标识符）时，你可能会遇到 java.lang.IllegalArgumentException: URI is not absolute 这个异常。这个异常表明程序尝试使用一个非绝对的 URI 来执行某些需要绝对 URI 的操作。理解这个异常的产生原因、处理方法以及最佳实践对于编写健壮的 Java 代码至关重要。

基础概念

URI 简介

URI 是用于标识互联网资源的字符串。它分为绝对 URI 和相对 URI。绝对 URI 包含完整的信息，能够独立定位资源，例如：https://www.example.com/index.html。相对 URI 则是相对于某个基础 URI 的路径，例如：../images/logo.png。

`java.lang.IllegalArgumentException`

这是一个运行时异常，当方法接收到一个不合法或不合适的参数时抛出。在处理 URI 时，如果方法期望一个绝对 URI 但接收到的是相对 URI，就会抛出 java.lang.IllegalArgumentException: URI is not absolute。

异常产生原因

当 Java 中的某些 API（如 java.net.URI 类的一些方法）期望一个绝对 URI，但传递给它的却是一个相对 URI 时，就会抛出这个异常。例如，以下代码会抛出该异常：

import java.net.URI;
import java.net.URISyntaxException;

public class Main {
    public static void main(String[] args) {
        try {
            URI uri = new URI("images/logo.png");
            // 这里的 URI 是相对的，会抛出异常
        } catch (URISyntaxException e) {
            e.printStackTrace();
        }
    }
}

在上述代码中，new URI("images/logo.png") 创建的是一个相对 URI，而许多 URI 相关的操作需要绝对 URI，所以会抛出 java.lang.IllegalArgumentException: URI is not absolute 异常。

使用方法（避免异常的正确做法）

要避免这个异常，需要确保传递给相关方法的是绝对 URI。可以通过多种方式创建绝对 URI。

使用完整的 URL 创建

import java.net.URI;
import java.net.URISyntaxException;

public class Main {
    public static void main(String[] args) {
        try {
            URI uri = new URI("https://www.example.com/images/logo.png");
            System.out.println("Valid absolute URI: " + uri);
        } catch (URISyntaxException e) {
            e.printStackTrace();
        }
    }
}

基于基础 URI 创建绝对 URI

import java.net.URI;
import java.net.URISyntaxException;

public class Main {
    public static void main(String[] args) {
        try {
            URI baseUri = new URI("https://www.example.com/");
            URI relativeUri = new URI("images/logo.png");
            URI absoluteUri = baseUri.resolve(relativeUri);
            System.out.println("Resolved absolute URI: " + absoluteUri);
        } catch (URISyntaxException e) {
            e.printStackTrace();
        }
    }
}

在上述代码中，通过 baseUri.resolve(relativeUri) 方法将相对 URI 解析为绝对 URI，从而避免了异常的抛出。

常见实践（错误示例与分析）

错误示例

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.io.IOException;
import java.net.URISyntaxException;

public class Main {
    public static void main(String[] args) throws IOException, InterruptedException {
        try {
            URI uri = new URI("index.html");
            // 尝试使用相对 URI 创建 HTTP 请求
            HttpRequest request = HttpRequest.newBuilder()
                  .uri(uri)
                  .GET()
                  .build();
            HttpClient client = HttpClient.newHttpClient();
            HttpResponse<String> response = client.send(request, BodyHandlers.ofString());
            System.out.println(response.body());
        } catch (URISyntaxException e) {
            e.printStackTrace();
        }
    }
}

分析

在上述代码中，new URI("index.html") 创建了一个相对 URI，而 HttpRequest.newBuilder().uri(uri) 方法期望一个绝对 URI。这会导致 java.lang.IllegalArgumentException: URI is not absolute 异常抛出，使得 HTTP 请求无法正确构建。

最佳实践

输入验证：在接收可能是 URI 的输入时，先进行验证。可以使用正则表达式或 java.net.URI 的 isAbsolute() 方法来判断是否为绝对 URI。

import java.net.URI;
import java.net.URISyntaxException;

public class Main {
    public static void main(String[] args) {
        String uriString = "https://www.example.com/index.html";
        try {
            URI uri = new URI(uriString);
            if (uri.isAbsolute()) {
                // 可以进行后续操作
                System.out.println("Valid absolute URI for further processing: " + uri);
            } else {
                System.out.println("URI is not absolute.");
            }
        } catch (URISyntaxException e) {
            e.printStackTrace();
        }
    }
}

标准化 URI：在使用 URI 之前，将其标准化为绝对 URI。可以使用基础 URI 来解析相对 URI，确保所有操作都基于绝对 URI 进行。
日志记录：在捕获到 java.lang.IllegalArgumentException: URI is not absolute 异常时，记录详细的日志信息，包括引发异常的 URI 字符串，以便于调试。

import java.net.URI;
import java.net.URISyntaxException;
import java.util.logging.Level;
import java.util.logging.Logger;

public class Main {
    private static final Logger LOGGER = Logger.getLogger(Main.class.getName());

    public static void main(String[] args) {
        try {
            URI uri = new URI("relative/path");
        } catch (URISyntaxException e) {
            LOGGER.log(Level.SEVERE, "Invalid URI: " + e.getMessage(), e);
        }
    }
}

小结

java.lang.IllegalArgumentException: URI is not absolute 异常是在 Java 处理 URI 时常见的问题，主要是由于使用了相对 URI 而 API 期望绝对 URI 导致的。通过正确创建绝对 URI、输入验证、标准化 URI 和日志记录等方法，可以有效避免和处理这个异常，从而提高程序的稳定性和健壮性。

参考资料

希望这篇博客能帮助你更好地理解和处理 java.lang.IllegalArgumentException: URI is not absolute 异常。在实际开发中，注意 URI 的使用规范，确保程序的正确性和可靠性。

深入剖析 java.lang.IllegalArgumentException: URI is not absolute

简介

目录