《Java核心技术 卷I》用户界面中首选项API

首选项API

在桌面程序中，通常都会存储用户首选项，如用户最后处理的文件、窗口的最后位置等。

利用Properties类可以很容易的加载和保存程序的配置信息，但有以下缺点：

• 有些操作系统没有主目录概念，很难为匹配文件找到一个统一的位置。
• 配置文件没有标准命名，用户安装多个Java应用，就更容易发生命名冲突。

操作系统有一个存储配置信息的中心存储库，最著名例子就是Window系统中的注册表。

Preferences类似于一种平台无关的中心存储库，Windows中，Preferences使用注册表存储信息，Linux上信息存储在本地文件系统中。存储库对程序员是透明的。

Preferences有一个树状结构，节点路径类似于/com/mycompany/myapp。

每个节点都有一个单独的键值对表，可存储数值，字符串，字节数组，不建议存储串行化对象。可以有多个树，每个程序用户都有一棵树，类似于操作系统的当前用户概念。

访问数中的一个节点，需要从用户或系统根开始：

Preferences root = Preferences.userRoot();或者

Preferences root = Preferences.systemRoot();

然后访问节点，可以直接提供一个节点路径名：

Preferences node = root.node("/com/mycompany/myapp");

如果节点路径名等于类的包名，可以简便调用：

Preferences node = Preferences.userNodeForPackage(obj.getClass());或

Preferences node = Preferences.systemNodeForPackage(obj.getClass());

一般来说，obj往往是this引用

得到节点，可以用如下方法访问键值表：

String get(String key,String defval)

int getInt(String key,int defval)

double getDouble(String key,double defval)

byte[] getByteArray(String key,byte[] defval)等

读取信息时必须指定一个默认值。

如下put方法向存储库写数据：

put(String key,String value)

putInt(String key,int value)

可以用一下方法枚举一个节点中存储的所有键

String[] keys()

注释：节点名和键都最多只能有80个字符，字符串值最多可以有8192个字符。

类似Windows注册表的中心存储库通常都存在两个问题：

• 它们会变成充斥着过期信息的垃圾场
• 配置数据域存储库纠缠在一起，所有很难把首选项迁移到新平台。

提供了第二个问题的解决方案，通过一下方法导出一个子树：

void exportSubtree(OutputStream out)

void exportNode(OutputStream out)

数据用XML格式保存，可以已通过调用一下方法将数据导入到另一个存储库：

void importPreferences(InputStream in)

示例文件，略。

案例：保存窗口位置和文件名，导出首选项后，退出并重启应用，导入首选项，窗口和之前一样，待续。。。

package preferences;

import java.awt.EventQueue;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import java.io.File;
import java.util.prefs.Preferences;

import javax.swing.ImageIcon;
import javax.swing.JFileChooser;
import javax.swing.JFrame;
import javax.swing.JLabel;
import javax.swing.JMenu;
import javax.swing.JMenuBar;
import javax.swing.JMenuItem;

public class ImageViewer {

    public static void main(String[] args) {
        EventQueue.invokeLater(()->{
            var frame = new ImageViewerFrame();
            frame.setTitle("图片查看器");
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            frame.setVisible(true);
        });
    }
}

class ImageViewerFrame extends JFrame {
    
    private static final int DEFAULT_WIDTH = 300;
    private static final int DEFAULT_HEIGHT = 200;
    private String image;
    
    public ImageViewerFrame() {
        Preferences root = Preferences.userRoot();
        Preferences node = root.node("/preferences/ImageViewer");
        int left = node.getInt("left", 0);
        int top = node.getInt("top", 0);
        int width = node.getInt("width", DEFAULT_WIDTH);
        int height = node.getInt("height", DEFAULT_HEIGHT);
        setBounds(left, top, width, height);
        image = node.get("image", null);
        var label = new JLabel();
        if(image != null) label.setIcon(new ImageIcon(image));
        addWindowListener(new WindowAdapter() {
            public void windowClosing(WindowEvent e) {
                node.putInt("left", getX());
                node.putInt("top", getY());
                node.putInt("width", getWidth());
                node.putInt("height", getHeight());
                node.put("image", image);
            }
        });
        add(label);
        //安装文件选择器
        var chooser = new JFileChooser();
        chooser.setCurrentDirectory(new File("."));
        //安装菜单栏
        var menuBar = new JMenuBar();
        setJMenuBar(menuBar);
        var menu = new JMenu("文件");
        menuBar.add(menu);
        var openItem = new JMenuItem("打开");
        menu.add(openItem);
        openItem.addActionListener(event -> {
            int result = chooser.showOpenDialog(null);
            if (result == JFileChooser.APPROVE_OPTION) {
                image = chooser.getSelectedFile().getPath();
                label.setIcon(new ImageIcon(image));
            }
        });
        
        var exitItem = new JMenuItem("关闭");
        menu.add(exitItem);
        exitItem.addActionListener(event->System.exit(0));
        
    }
}

java.util.prefs.Preferences 1.4

• Preferencs userRoot()，返回调用程序的用户的首选项根节点。
• Preferences systemRoot()，返回系统范围的首选项根节点。
• Preferences node(String path)，返回从当前节点由给定路径可以到达的节点。如果path是绝对路径(也就是说，以一个/开头)，则从包含这个首选项节点的树的根节点开始查找。如果给定路径不存在相应的节点，则创建这样一个节点。
• Preferences userNodeForPackage(Class cl)
• Preferences systemNodeForPackage(Class cl)，返回当前用户树或系统树中的一个节点，其绝对节点路径对应类cl的包名。
• String[] keys()，返回属于这个节点的所有键。
• String get(String key,String defval)
• int getInt(String key,int defval)
• long getLong(String key,long defval)
• float getFloat(String key,float defval)
• double getDouble(String key,double defval)
• boolean getBoolean(String key,double defval)
• byte[] getByteArray(String key, byte[] defval)，返回与给定键关联的值，或者如果没有值与这个键关联、关联的值类型不正确或首选项存储库不可用，则返回所提供的默认值。
• void put(String key, String value)
• void putInt(String key, int value)
• void putLong(String key, long value)
• void putFloat(String key,float value)
• void putDouble(String key, double value)
• void putBoolean(String key,boolean value)
• void putByteArray(String key,byte[] value)，在这个节点存储一个值/键对。
• void exportSubtree(OutputStream out)，将这个节点及其子节点的首选项写至指令的流。
• void exportNode(OutputStream out)，将这个节点，不包括其子节点的首选项写至指定的流。
• void importPreferences(InputStream in)，导入指定流中包含的首选项。

原文地址：https://blog.csdn.net/qq_36324341/article/details/143819859

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！