UnsupportedFlavorException不支持的风格

🍨 UnsupportedFlavorException （不支持的风格异常） 详解

什么是 UnsupportedFlavorException？

这是一个在 Java 的 剪贴板/数据传输系统 中常见的异常，属于 java.awt.datatransfer 包。

常见出现场景

主要发生在剪贴板操作或拖放操作时：

// 1️⃣ 从系统剪贴板获取数据时
Clipboard clipboard = Toolkit.getDefaultToolkit().getSystemClipboard();
Transferable contents = clipboard.getContents(this);
String text = (String) contents.getTransferData(DataFlavor.stringFlavor);
// ↑ 如果剪贴板里的数据不支持字符串格式，就会抛出此异常

为什么会发生？

解决方案 ✅

方法 1：检查是否支持该格式

if (contents.isDataFlavorSupported(DataFlavor.stringFlavor)) {
    String text = (String) contents.getTransferData(DataFlavor.stringFlavor);
} else {
    // 处理不支持的情况
    System.out.println("剪贴板中不支持文本格式");
}

方法 2：使用支持的数据格式列表

DataFlavor[] flavors = contents.getTransferDataFlavors();
for (DataFlavor flavor : flavors) {
    if (flavor.isFlavorJavaFileListType()) {
        // 处理文件列表
    } else if (DataFlavor.stringFlavor.equals(flavor)) {
        // 处理文本
    }
}

方法 3：捕获异常并优雅处理

try {
    String text = (String) contents.getTransferData(DataFlavor.stringFlavor);
} catch (UnsupportedFlavorException e) {
    // 记录日志或使用备用方案
    log.warn("当前剪贴板内容不支持文本格式");
    text = "";
}

完整示例代码

import java.awt.*;
import java.awt.datatransfer.*;
public class ClipboardReader {
    public static String readClipboardText() {
        try {
            Clipboard clipboard = Toolkit.getDefaultToolkit().getSystemClipboard();
            Transferable contents = clipboard.getContents(null);
            if (contents != null && 
                contents.isDataFlavorSupported(DataFlavor.stringFlavor)) {
                return (String) contents.getTransferData(DataFlavor.stringFlavor);
            }
        } catch (UnsupportedFlavorException e) {
            System.err.println("不支持的数据格式: " + e.getMessage());
        } catch (IOException e) {
            System.err.println("读取剪贴板数据失败: " + e.getMessage());
        }
        return null;
    }
}

🔍 调试建议

1. 打印所有支持的格式：

   DataFlavor[] flavors = contents.getTransferDataFlavors();
   for (DataFlavor f : flavors) {
       System.out.println(f.getHumanPresentableName());
   }

2. 常见的 DataFlavor：

   • DataFlavor.stringFlavor - 文本
   • DataFlavor.imageFlavor - 图片
   • DataFlavor.javaFileListFlavor - 文件列表
   • DataFlavor.plainTextFlavor - 纯文本（已弃用）

💡 最佳实践

• 总是先检查 isDataFlavorSupported()
• 使用 try-catch 包裹数据读取操作
• 提供备用方案（如返回空字符串或提示用户）
• 考虑多格式支持，提高兼容性

通过遵循这些实践,你可以有效避免 UnsupportedFlavorException 并构建更健壮的剪贴板交互功能。