如何限制Java中JTextField的输入仅为ArrayList内的指定名称？

Hey there! Let's figure out how to make your JTextField only accept values that are already in your ArrayList. I've got a few practical approaches that work well in Java Swing—let's break them down:

1. Use DocumentFilter (Real-Time Restriction) #

This is my go-to for real-time validation, since it hooks directly into the text field's document to block invalid inputs as the user types. Here's how to implement it:

First, create a custom DocumentFilter that checks if the input (or the resulting full text) exists in your ArrayList:

import javax.swing.text.AttributeSet;
import javax.swing.text.BadLocationException;
import javax.swing.text.DocumentFilter;
import java.util.ArrayList;
import java.util.List;

public class AllowedValuesFilter extends DocumentFilter {
    private final List<String> allowedNames;

    public AllowedValuesFilter(List<String> allowedNames) {
        this.allowedNames = new ArrayList<>(allowedNames);
    }

    @Override
    public void insertString(FilterBypass fb, int offset, String string, AttributeSet attr) throws BadLocationException {
        String newText = fb.getDocument().getText(0, fb.getDocument().getLength()) + string;
        if (isValidInput(newText)) {
            super.insertString(fb, offset, string, attr);
        }
        // If invalid, do nothing—block the input
    }

    @Override
    public void replace(FilterBypass fb, int offset, int length, String text, AttributeSet attrs) throws BadLocationException {
        String currentText = fb.getDocument().getText(0, fb.getDocument().getLength());
        String newText = currentText.substring(0, offset) + text + currentText.substring(offset + length);
        if (isValidInput(newText)) {
            super.replace(fb, offset, length, text, attrs);
        }
        // Invalid input gets ignored
    }

    private boolean isValidInput(String input) {
        // Allow empty input if you want, or adjust this logic
        if (input.isEmpty()) return true;
        // Check for exact match (uncomment below for partial match support)
        return allowedNames.contains(input.trim());
        // For partial matches (e.g., user types "Al" and "Alice" is allowed):
        // return allowedNames.stream().anyMatch(name -> name.startsWith(input.trim()));
    }
}

Then apply this filter to your JTextField's document:

import javax.swing.*;
import java.util.ArrayList;
import java.util.List;

public class RestrictedTextFieldDemo {
    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> {
            JFrame frame = new JFrame("Restricted JTextField Demo");
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            frame.setSize(300, 150);

            // Your list of allowed names
            List<String> allowedNames = new ArrayList<>();
            allowedNames.add("Alice");
            allowedNames.add("Bob");
            allowedNames.add("Charlie");

            JTextField textField = new JTextField(20);
            // Attach the filter to the text field's document
            ((javax.swing.text.AbstractDocument) textField.getDocument()).setDocumentFilter(new AllowedValuesFilter(allowedNames));

            frame.add(textField);
            frame.setVisible(true);
        });
    }
}

2. Use InputVerifier (Focus Lost Validation) #

If you don't need to block input as the user types, but just want to validate when they move away from the text field, InputVerifier is a simpler option:

import javax.swing.*;
import java.util.List;

public class NameInputVerifier extends InputVerifier {
    private final List<String> allowedNames;

    public NameInputVerifier(List<String> allowedNames) {
        this.allowedNames = allowedNames;
    }

    @Override
    public boolean verify(JComponent input) {
        JTextField textField = (JTextField) input;
        String inputText = textField.getText().trim();
        boolean isValid = allowedNames.contains(inputText);
        if (!isValid) {
            JOptionPane.showMessageDialog(input, "Please enter a valid name from the list!", "Invalid Input", JOptionPane.WARNING_MESSAGE);
            textField.selectAll();
        }
        return isValid;
    }
}

Apply it to your text field like this:

// Inside your Swing setup code
textField.setInputVerifier(new NameInputVerifier(allowedNames));

This will show a warning dialog if the user enters an invalid name and tries to click away, and won't let them lose focus until they fix it.

3. Add Auto-Complete (Enhance User Experience) #

To eliminate invalid inputs entirely and make it easier for users, add an auto-complete feature. If you're okay with using a third-party library, SwingX has a handy AutoCompleteDecorator that does this in one line:

// First, add SwingX to your project (via Maven/Gradle or manual JAR)
import org.jdesktop.swingx.autocomplete.AutoCompleteDecorator;

// Then decorate your text field:
AutoCompleteDecorator.decorate(textField, allowedNames, true);

This adds a dropdown menu that shows matching names as the user types—they can just select a valid option instead of typing manually.

Which one should you pick?

• Use DocumentFilter if you need to block invalid characters/inputs in real-time.
• Use InputVerifier if you prefer to validate after the user finishes typing.
• Use auto-complete if you want to guide users to valid options and prevent mistakes upfront.

内容的提问来源于stack exchange，提问作者OcA.ND