Java Swing求助：实现按键触发弹出JTable进行物品搜索

Hey there! I totally get the frustration when a Swing UI feature doesn't behave as expected—search dropdowns with JTable can be tricky if you miss a few key details. Let's walk through the common pitfalls and a working solution for your multiple JTextField setup.

Common Issues That Might Be Blocking Your Progress #

• Wrong Listener Choice: Using KeyListener can lead to focus-related bugs (e.g., not triggering if the field isn't focused). DocumentListener is better for real-time text change tracking.
• Popup Placement & Visibility: Your JPopupMenu (or window) might not be positioned correctly relative to the text field, or it's not updating visibility when text changes.
• Dynamic Data Updates: The JTable's model isn't being refreshed with filtered results as the user types.
• Missing Selection Handling: No logic to populate the selected item back into the JTextField once a row is clicked.

Working Example Code #

Let's create a reusable SearchTextField class that encapsulates all the search popup logic—this way you can easily add it to multiple text fields in your app:

import javax.swing.*;
import javax.swing.event.DocumentEvent;
import javax.swing.event.DocumentListener;
import javax.swing.table.DefaultTableModel;
import java.awt.*;
import java.awt.event.MouseAdapter;
import java.awt.event.MouseEvent;
import java.util.ArrayList;
import java.util.List;

// Reusable search text field with JTable popup
class SearchTextField extends JTextField {
    private final JPopupMenu popupMenu;
    private final JTable resultTable;
    private final DefaultTableModel tableModel;
    private final List<String> itemList; // Your full list of items

    public SearchTextField(List<String> items) {
        this.itemList = new ArrayList<>(items);
        this.popupMenu = new JPopupMenu();
        this.tableModel = new DefaultTableModel(new Object[]{"Items"}, 0);
        this.resultTable = new JTable(tableModel);

        // Configure table appearance
        resultTable.setFillsViewportHeight(true);
        resultTable.setSelectionMode(ListSelectionModel.SINGLE_SELECTION);
        popupMenu.add(new JScrollPane(resultTable));

        // Add document listener to track text changes
        getDocument().addDocumentListener(new DocumentListener() {
            @Override
            public void insertUpdate(DocumentEvent e) {
                filterAndShowResults();
            }

            @Override
            public void removeUpdate(DocumentEvent e) {
                filterAndShowResults();
            }

            @Override
            public void changedUpdate(DocumentEvent e) {
                filterAndShowResults();
            }
        });

        // Handle table row selection to populate text field
        resultTable.addMouseListener(new MouseAdapter() {
            @Override
            public void mouseClicked(MouseEvent e) {
                int selectedRow = resultTable.getSelectedRow();
                if (selectedRow != -1) {
                    String selectedItem = (String) tableModel.getValueAt(selectedRow, 0);
                    setText(selectedItem);
                    popupMenu.setVisible(false);
                }
            }
        });
    }

    // Filter items based on current text and update table
    private void filterAndShowResults() {
        String searchText = getText().trim().toLowerCase();
        tableModel.setRowCount(0); // Clear previous results

        if (searchText.isEmpty()) {
            popupMenu.setVisible(false);
            return;
        }

        // Filter matching items
        for (String item : itemList) {
            if (item.toLowerCase().contains(searchText)) {
                tableModel.addRow(new Object[]{item});
            }
        }

        // Show popup if there are results
        if (tableModel.getRowCount() > 0) {
            Point location = getLocationOnScreen();
            popupMenu.show(this, 0, getHeight());
            popupMenu.setPreferredSize(new Dimension(getWidth(), 200));
        } else {
            popupMenu.setVisible(false);
        }
    }
}

// Test frame with multiple search text fields
public class SearchTextFieldDemo extends JFrame {
    public SearchTextFieldDemo() {
        setTitle("Searchable JTextField Demo");
        setSize(400, 200);
        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        setLayout(new GridLayout(3, 2, 10, 10));
        getContentPane().setBorder(BorderFactory.createEmptyBorder(10, 10, 10, 10));

        // Sample item list (replace with your actual data)
        List<String> items = List.of(
                "Apple", "Banana", "Cherry", "Date", "Elderberry",
                "Fig", "Grape", "Honeydew", "Kiwi", "Lemon"
        );

        // Add multiple search text fields
        add(new JLabel("Item 1:"));
        add(new SearchTextField(items));

        add(new JLabel("Item 2:"));
        add(new SearchTextField(items));

        add(new JLabel("Item 3:"));
        add(new SearchTextField(items));
    }

    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> new SearchTextFieldDemo().setVisible(true));
    }
}

Key Details to Note #

• Reusable Component: The SearchTextField class lets you add the search functionality to any number of text fields without repeating code.
• DocumentListener: This listens directly to text changes in the field's document, so it works even if the text is changed programmatically (not just via keyboard).
• Popup Positioning: The popup is shown directly below the text field, with the same width as the field for a clean UI.
• Selection Handling: Clicking a row in the JTable automatically populates the text field and hides the popup.

Additional Tips #

• Asynchronous Filtering: If your item list is large (thousands of items), move the filtering logic to a background thread using SwingWorker to avoid freezing the UI.
• Popup Closing: Add a MouseListener to your main frame to close the popup when the user clicks outside the text field or table.
• Customization: You can modify the table's columns, add icons, or adjust the popup size to match your app's design.

Give this code a try—replace the sample items list with your actual dataset, and it should work smoothly for your multiple JTextField setup.

内容的提问来源于stack exchange，提问作者md azaz