用Java制作屬性編輯器

2019-11-18 13:29:30

字體：大中小

來源：轉載

供稿：網友

　　作者長期從事網管軟件的開發工作，網絡設備的配置治理模塊，需要對網絡設備的大量參數進行配置工作，設計、開發配置治理模塊的界面成為整個網管系統的難點，尤其是用java語言開發時，需要編制大量的界面布局、事件處理等代碼，網管軟件開發的主要工作量就集中在此。制作一個類似于Delphi、JBuilder等可視化開發工具的對象查看器的參數配置控件用于項目的優點是顯而易見的：
　　1、界面顯得很專業；
　　2、輕易做到使整個系統的風格趨于一致；
　　3、使用靈活，代碼量大大減??；
　　4、……
　　最終的使用效果如下圖所示：
　　　用Java制作屬性編輯器（圖一）

　　作者本人把它稱為屬性編輯器，它的主要特征是：是一個兩列多行的表格，第一列用來顯示屬性名稱，第二列用來顯示和編輯屬性值；屬性值的顯示和編輯可以有多種方式，如文本框輸入、下拉框選擇、組合框選擇、自定義的彈出式對話框等；當屬性被編輯后，可以向感愛好的對象發出通知。
　　下面就屬性編輯器的設計思路和編制過程進行具體的解釋說明。
　　設計思路
　　根據屬性編輯器的主要界面特征，選擇JTable作為編輯器的基類。JTable是Swing中最復雜的組件之一，它主要被用來顯示數據行和數據列，它可以為每個數據單元分別提供繪制器和編輯器，是典型的MVC（模型Model、視圖View、控制Control）模式的實現者。
　　設計屬性編輯器為一個兩列的JTable，每一行數據的第一列存放不重復的字符串，作為屬性的名稱；第二列保存Object對象，根據其具體數據類型，設置其單元繪制器和單元編輯器，一般單元繪制器用系統默認的JLabel即可，而單元編輯器則必須提供定制的控件，如對字符串型數據，用JTextField或者JComboBox；對布爾型數據，用JCheckBox；對非凡類型，可以提供JDialog，對話框的主要界面可以由使用本屬性編輯器的程序員自行定制。
　　屬性編輯器還要提供相關接口，如屬性值是否只讀；屬性值變化時必須通知監聽者；等等；
　　屬性編輯器的具體設計，請參見下圖，限于篇幅，該圖只簡單列舉了幾個主要的類之間的關系和一些重要的變量和方法：
　　用Java制作屬性編輯器（圖二）

　　屬性編輯器的制作過程
　　
　　屬性編輯器是從JTable上繼續下來的，必須給它定義一個DefaultTableModel的子類，用來作為屬性編輯器的數據模型，存放屬性名和屬性值，因為它只在屬性編輯器內部使用，所以可以定義為屬性編輯器的內部類：
　　
　　public class PRopertyEditor extends JTable {
　　
　　protected class PropertyEditorModel extends DefaultTableModel{
　　
　　public PropertyEditorModel() {
　　
　　super(0, 2); // 只有兩個列
　　
　　}
　　
　　public String getColumnName(int col) {
　　
　　return " "; // 不需要列標題
　　
　　}
　　
　　public boolean isCellEditable(int row, int col) {
　　
　　if(col == 0)
　　
　　return false; // 第一列是屬性名，不可編輯
　　
　　else
　　
　　// 屬性值是否可編輯要看用戶指定的情況
　　
　　return ((Boolean)propertyEditable.get(this.getValueAt(row, 0))).booleanValue();
　　
　　}
　　
　　}
　　
　　}
　　
　　要實現定制的單元繪制器和編輯器，必須覆蓋JTable的getCellEditor和getCellRenderer方法，那些已經做好的繪制器、編輯器和該屬性值是否答應編輯都可以根據屬性名保存在Hashtable里，需要的時候根據屬性名取出來：
　　
　　/**
　　
　　* 每一個屬性項都對應一個單元編輯器，用Hashtable來保存這些編輯器
　　
　　*/
　　
　　protected Hashtable propertyEditors = new Hashtable(10);
　　
　　/**
　　
　　* 每一個屬性項都對應一個單元渲染器
　　
　　*/
　　
　　protected Hashtable propertyRenderers = new Hashtable(10);
　　
　　/**
　　
　　* 屬性是否可編輯
　　
　　*/
　　
　　protected Hashtable propertyEditable = new Hashtable(10);
　　
　　
　　/**
　　
　　* 獲取指定單元格的編輯器
　　
　　* @param row 行
　　
　　* @param col 列
　　
　　*/
　　
　　public TableCellEditor getCellEditor(int row, int col) {
　　
　　TableCellEditor editor = null;
　　
　　if(col == 1) { // 屬性值列才需要編輯器。這個判定條件不要也可，效率會低一點。
　　
　　editor = (TableCellEditor)propertyEditors.get(this.getValueAt(row, 0));
　　
　　}
　　
　　if(editor == null) { // 沒找到編輯器，則用系統默認的。
　　
　　editor = super.getCellEditor(row, col);
　　
　　}
　　
　　return editor;
　　
　　}
　　
　　
　　/**
　　
　　* 獲取指定單元格的渲染器
　　
　　*/
　　
　　public TableCellRenderer getCellRenderer(int row, int col) {
　　
　　TableCellRenderer renderer = null;
　　
　　if(col == 1) {
　　
　　renderer = (TableCellRenderer)propertyRenderers.get(this.getValueAt(row, 0));
　　
　　}
　　
　　if(renderer == null) {
　　
　　renderer = super.getCellRenderer(row, col);
　　
　　}
　　
　　// 給表格元素提供Hint提示
　　
　　if(renderer instanceof JComponent) {
　　
　　Object v = this.getModel().getValueAt(row, col);
　　
　　if(v == null) { // 屬性值有可能為空，則取屬性名；屬性名必不為空。
　　
　　v = this.getModel().getValueAt(row, 0);
　　
　　}
　　
　　((JComponent)renderer).setToolTipText(v.toString());
　　
　　}
　　
　　return renderer;
　　
　　}
　　
　　
　　如何確定哪個屬性用哪一種編輯器呢？可以根據用戶程序員傳入的參數來確定，對傳入的整數型數據，則用LongCellEditor；字符串型的當然用StringCellEditor了，其它依次類推。以整數型來舉例：
　　
　　/**
　　
　　* 在屬性表中增加整數屬性,答應為空值，編輯器和渲染器為long型編輯器和渲染器。
　　
　　* 當屬性值為空值時，必須寫成：
　　
　　* addProperty("pName", (Long)null)
　　
　　* @param propertyName 屬性名
　　
　　* @param longNumObj 屬性初始值
　　
　　*/
　　
　　public void addProperty(String propertyName, Long longNumObj) {
　　
　　if(propertyName == null) throw new RuntimeException("Coding error : property name can NOT be null !");
　　
　　
　　Object[] row = new Object[2];
　　
　　row[0] = propertyName;
　　
　　row[1] = longNumObj;
　　
　　appendRow(row); // 往表格增加行
　　
　　propertyEditors.put(propertyName, longEditor); // 添加整型編輯器
　　
　　propertyRenderers.put(propertyName, longRenderer); // 添加整型繪制器
　　
　　propertyEditable.put(propertyName, new Boolean(true)); // 設置該屬性答應編輯
　　
　　}
　　
　　
　　給屬性編輯器加上get和set接口：
　　
　　/**
　　
　　* 根據屬性名得到屬性值
　　
　　* @param propertyName 屬性名
　　
　　*/
　　
　　public Object getPropertyValue(String propertyName) {
　　
　　Object retValue = null;
　　
　　for(int i = 0; i < ptm.getRowCount(); i++) {
　　
　　if(ptm.getValueAt(i, 0).equals(propertyName)) {
　　
　　retValue = ptm.getValueAt(i, 1);
　　
　　break;
　　
　　}
　　
　　}
　　
　　return retValue;
　　
　　}
　　
　　
　　/**
　　
　　* 設置屬性值
　　
　　* @param propertyName 屬性名
　　
　　* @param newValue 新的屬性值
　　
　　*/
　　
　　public void setPropertyValue(String propertyName, Object newValue) {
　　
　　for(int i = 0; i < ptm.getRowCount(); i++) {
　　
　　if(ptm.getValueAt(i, 0).equals(propertyName)) {
　　
　　ptm.setValueAt(newValue, i, 1);
　　
　　break;
　　
　　}
　　
　　}
　　
　　}
　　好了，屬性值編輯器的大框架已經完成了，下面以整數型的單元編輯器為例，簡單說明單元編輯器的制作方法，雙精度型和字符串型的和它類似，最復雜的用戶自定義對話框型的，留待讀者自己看源代碼吧（反正源代碼里面有具體的注釋的J）。
　　
　　/**
　　
　　* 創建并初始化long型數據的編輯器和渲染器
　　
　　*/
　　
　　private void createLongEditorRenderer() {
　　
　　final JTextField longTextField = new JTextField("0", 5); // 用文本輸入框做輸入控件
　　
　　longTextField.setHorizontalAlignment(JTextField.LEFT);
　　
　　longEditor = new DefaultCellEditor(longTextField) {
　　
　　private Object previousValue = null;
　　
　　public Object getCellEditorValue() {
　　
　　if(longTextField.getText().equals("")

上一篇：分析用Javadoc形式集成文檔的利與弊

下一篇：用Java制作十六進制編輯器