本文旨在解决在使用 JTextPane 显示从 properties 文件读取的 HTML 内容时，图片无法正确加载的问题。文章将深入分析相对 URL 的概念，并提供两种解决方案：一是通过设置 HTMLDocument 的 base URL 来解决相对路径问题，二是使用 JLabel 和 ImageIcon 手动构建内容，以更灵活地控制显示效果。
在使用 JTextPane 显示 HTML 内容时，如果 HTML 中包含图片，而图片路径是相对路径，可能会遇到图片无法加载的问题。这通常是因为 JTextPane 无法正确解析相对路径导致的。本文将介绍两种解决此问题的方法。
问题分析：相对 URL 与 Base URL
当 HTML 中的 标签的 src 属性使用相对 URL (例如 icons/roles/seer_icon.png) 时，浏览器会根据 HTML 文档的 base URL 来解析图片的完整路径。如果 HTML 内容是从 URL 加载的，那么 base URL 就是该 URL。但如果 HTML 内容是从字符串加载的（例如从 properties 文件读取），则默认情况下没有 base URL。 这会导致 JTextPane 无法找到图片资源。
解决方案一：设置 HTMLDocument 的 Base URL
HTMLDocument 类有一个 setBase() 方法，可以用来设置 HTML 文档的 base URL。 通过设置 base URL，我们可以告诉 JTextPane 如何解析相对路径。
立即学习“Java免费学习笔记（深入）”；
以下是示例代码：
import javax.swing.*;
import javax.swing.text.html.HTMLDocument;
import java.net.URL;
public class ImageLoadingExample {
public static void main(String[] args) {
JFrame frame = new JFrame("JTextPane Image Example");
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
JTextPane textPane = new JTextPane();
textPane.setContentType("text/html");
// 从 properties 文件读取 HTML 内容 (假设已读取到 htmlContent 变量)
String htmlContent = "Seer:
@@##@@";
textPane.setText(htmlContent);
// 获取 HTMLDocument 并设置 Base URL
HTMLDocument doc = (HTMLDocument) textPane.getStyledDocument();
try {
// 假设 icons 目录位于 classpath 的根目录下
URL baseUrl = ImageLoadingExample.class.getResource("/");
doc.setBase(baseUrl);
} catch (Exception e) {
e.printStackTrace();
}
JScrollPane scrollPane = new JScrollPane(textPane);
frame.getContentPane().add(scrollPane);
frame.setSize(400, 300);
frame.setVisible(true);
}
}代码解释：
- textPane.setContentType("text/html"); 设置 JTextPane 的内容类型为 HTML。
- textPane.setText(htmlContent); 将从 properties 文件读取的 HTML 内容设置到 JTextPane 中。
- HTMLDocument doc = (HTMLDocument) textPane.getStyledDocument(); 获取 JTextPane 的 HTMLDocument 对象。
- URL baseUrl = ImageLoadingExample.class.getResource("/"); 获取 classpath 根目录的 URL。 你需要确保 icons 目录位于 classpath 的根目录下。 如果 icons 目录位于其他位置，需要相应地修改 getResource() 方法的参数。
- doc.setBase(baseUrl); 设置 HTMLDocument 的 base URL。
注意事项：
- 确保 icons/roles/seer_icon.png 文件存在，并且位于正确的路径下。
- getResource() 方法返回的是一个 URL 对象，如果资源不存在，则返回 null。 在使用 doc.setBase() 方法之前，应该检查 baseUrl 是否为 null。
解决方案二：使用 JLabel 和 ImageIcon 手动构建内容
如果对 HTML 的渲染要求不高，或者需要更灵活地控制显示效果，可以使用 JLabel 和 ImageIcon 手动构建内容。
以下是示例代码：
import javax.swing.*;
import java.awt.*;
import javax.swing.border.Border;
import javax.swing.border.EmptyBorder;
public class ImageLoadingExample2 {
public static void main(String[] args) {
JFrame frame = new JFrame("JLabel Image Example");
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
JPanel content = new JPanel(new BorderLayout());
// 从 properties 文件读取内容 (假设已读取到 headingText 和 iconPath 变量)
String headingText = "Seer:";
String iconPath = "/icons/roles/seer_icon.png"; // 注意：这里使用绝对路径
JLabel headingLabel = new JLabel(headingText);
Font font = headingLabel.getFont();
font = font.deriveFont(24f);
headingLabel.setFont(font);
//设置边距
Border border = new EmptyBorder(0, 0, 12, 0);
headingLabel.setBorder(border);
ImageIcon icon = new ImageIcon(ImageLoadingExample2.class.getResource(iconPath));
JLabel iconLabel = new JLabel(icon);
content.add(headingLabel, BorderLayout.PAGE_START);
content.add(iconLabel, BorderLayout.CENTER);
JScrollPane scrollPane = new JScrollPane(content);
frame.getContentPane().add(scrollPane);
frame.setSize(400, 300);
frame.setVisible(true);
}
}代码解释：
- 从 properties 文件读取文本和图片路径。
- 创建一个 JLabel 用于显示文本，并设置字体。
- 创建一个 ImageIcon 用于加载图片。
- 创建一个 JLabel 用于显示图片。
- 将文本标签和图片标签添加到 JPanel 中，并设置布局。
- 将 JPanel 添加到 JScrollPane 中。
注意事项：
- 使用 MyApplication.class.getResource(iconPath) 加载图片时，iconPath 应该使用绝对路径，以确保能够正确找到图片资源。 路径应该以 / 开头，表示从 classpath 的根目录开始查找。
- 这种方法可以更灵活地控制文本和图片的位置、大小和样式。
总结
本文介绍了两种解决 JTextPane 中 HTML 图片无法加载的问题的方法。第一种方法是通过设置 HTMLDocument 的 base URL 来解决相对路径问题。第二种方法是使用 JLabel 和 ImageIcon 手动构建内容，以更灵活地控制显示效果。 选择哪种方法取决于具体的需求和场景。 如果需要渲染复杂的 HTML 内容，建议使用第一种方法。 如果只需要显示简单的文本和图片，建议使用第二种方法。 无论选择哪种方法，都需要确保图片资源位于正确的路径下，并且能够被程序访问到。
