[PT선생님][16]자바 javax.swing.text.AbstractDocument 알아보기

javax.swing.text.AbstractDocument는 Swing 패키지의 일부인 클래스로, Swing 텍스트 구성 요소를 위한 추상 문서 모델을 구현합니다. 이 클래스는 텍스트 문서를 저장하고 관리하는 데 필요한 기능을 제공합니다.

AbstractDocument 클래스는 편집 가능한 텍스트 컴포넌트를 위한 추상 모델을 제공합니다. 이 클래스는 텍스트 컴포넌트에 대한 문서 모델을 구현하며, 이 모델은 텍스트의 변경을 추적하고 저장할 수 있습니다.

AbstractDocument 클래스는 javax.swing.text.Document 인터페이스를 구현합니다. 이 인터페이스는 Swing 텍스트 컴포넌트에서 사용되는 모든 문서 클래스에 의해 구현됩니다. 따라서 AbstractDocument 클래스는 이 인터페이스를 구현하여 다른 Swing 텍스트 컴포넌트와 호환됩니다.

AbstractDocument 클래스는 문서 모델에서 변경 가능한 텍스트 영역을 나타내는 Segment 클래스를 제공합니다. Segment 클래스는 문자열을 저장하고 이를 변경할 수 있습니다. 이 클래스는 텍스트 컴포넌트에서 작업하는 데 사용됩니다.

AbstractDocument 클래스는 UndoableEditListener 인터페이스를 구현합니다. 이 인터페이스는 편집 가능한 텍스트 컴포넌트에서 사용되며, 편집 작업을 취소하거나 다시 실행할 수 있는 기능을 제공합니다.

AbstractDocument 클래스는 편집 가능한 텍스트 컴포넌트에서 사용되는 다양한 특성을 정의하는 AttributeSet 클래스를 구현합니다. 이 클래스는 문서 모델에서 문자열의 속성을 나타내는 데 사용됩니다. 예를 들어, 문자열의 색상, 글꼴, 크기 및 스타일을 지정할 수 있습니다.

AbstractDocument 클래스는 스타일 편집기를 구현하는 데 사용됩니다. 스타일 편집기는 Swing 텍스트 컴포넌트에서 사용되며, 텍스트를 스타일로 지정할 수 있습니다. 스타일은 텍스트 컴포넌트에서 일관된 스타일을 유지하고 변경할 수 있는 방법을 제공합니다.

또한 AbstractDocument 클래스는 다른 클래스에서 상속할 수 있도록 설계되어 있습니다. 따라서 AbstractDocument 클래스를 확장하여 사용자 지정 문서 모델을 만들 수 있습니다.

이러한 기능들은 AbstractDocument 클래스가 Swing 텍스트 컴포넌트에서 중요한 역할을 담당하고 있음을 보여줍니다. 이 클래스를 사용하여 텍스트 문서를 저장하고 관리하고, 사용자 지정 문서 모델을 만들고, 스타일 편집기를 구현하며, 변경 가능한 텍스트 영역을 다룰 수 있습니다. 이러한 기능들은 Swing 텍스트 컴포넌트에서 필수적인 것들이며, AbstractDocument 클래스는 이러한 기능들을 제공하여 텍스트 컴포넌트의 개발과 디자인을 간소화합니다.

AbstractDocument 클래스는 추상 클래스이기 때문에 직접 인스턴스화할 수 없습니다. 대신, AbstractDocument 클래스를 확장하여 사용자 지정 문서 모델을 만들어야 합니다. 사용자 지정 문서 모델을 만드는 방법은 다음과 같습니다.

1. AbstractDocument 클래스를 상속하여 새로운 클래스를 만듭니다.
2. 새로운 클래스에서 텍스트 문서의 변경을 처리하는 메서드를 구현합니다.
3. 필요에 따라 새로운 클래스에서 사용자 지정 속성을 정의합니다.
4. 새로운 클래스를 Swing 텍스트 컴포넌트에 연결합니다.

예를 들어, 다음은 AbstractDocument 클래스를 확장하여 사용자 지정 문서 모델을 만드는 간단한 예제입니다.

public class MyDocument extends AbstractDocument {
    public void insertString(int offset, String str, AttributeSet a) throws BadLocationException {
        // 텍스트 문서에 문자열을 삽입하는 코드
    }

    public void remove(int offset, int len) throws BadLocationException {
        // 텍스트 문서에서 문자열을 제거하는 코드
    }

    // 사용자 지정 속성을 정의하는 코드
    public static final String MY_ATTRIBUTE = "MyAttribute";
    public static final AttributeSet MY_ATTRIBUTE_SET = new SimpleAttributeSet();
    static {
        StyleConstants.setForeground(MY_ATTRIBUTE_SET, Color.RED);
    }
}

위의 예제에서는 insertString() 및 remove() 메서드를 구현하여 텍스트 문서의 변경을 처리합니다. 또한, 사용자 지정 속성을 정의하고 해당 속성에 대한 AttributeSet을 만듭니다.

AbstractDocument 클래스는 Swing 텍스트 컴포넌트에서 필수적인 클래스이며, 텍스트 문서의 저장과 관리, 사용자 지정 문서 모델의 구현, 스타일 편집기의 구현 등 다양한 기능을 제공합니다. 이 클래스를 사용하여 텍스트 컴포넌트를 개발할 때는 AbstractDocument 클래스의 메서드와 속성을 적절하게 사용하여 텍스트 컴포넌트의 동작을 구현해야 합니다.아래는 AbstractDocument를 확장한 사용자 지정 문서 모델 클래스에서 insertString() 메서드를 재정의한 예제 코드입니다. 이 코드는 텍스트 필드나 텍스트 영역 등 Swing 텍스트 컴포넌트에서 사용될 수 있습니다.

 

import javax.swing.text.AbstractDocument;
import javax.swing.text.AttributeSet;
import javax.swing.text.BadLocationException;

public class CustomDocument extends AbstractDocument {

    @Override
    public void insertString(int offset, String str, AttributeSet attr) throws BadLocationException {
        if (str == null) {
            return;
        }

        // 입력할 문자열 중에서 숫자만 추출하기
        StringBuilder filteredStr = new StringBuilder();
        for (int i = 0; i < str.length(); i++) {
            char c = str.charAt(i);
            if (Character.isDigit(c)) {
                filteredStr.append(c);
            }
        }

        if (filteredStr.length() > 0) {
            // 추출한 숫자를 문자열에 삽입하기
            super.insertString(offset, filteredStr.toString(), attr);
        }
    }
}

이 코드는 insertString() 메서드를 재정의하여 입력한 문자열 중에서 숫자만 추출하여 해당 숫자만 텍스트 필드나 텍스트 영역에 삽입하도록 구현한 예제입니다. 이 예제에서는 insertString() 메서드에서 입력된 문자열을 필터링하여 숫자만 추출하여 super.insertString() 메서드를 호출하여 텍스트 필드나 텍스트 영역에 삽입하도록 구현했습니다.

사용자 지정 문서 모델 클래스에서는 insertString() 메서드 외에도 remove() 메서드, getSize() 메서드 등 AbstractDocument에서 제공하는 다양한 메서드를 재정의하여 텍스트 문서의 저장과 관리를 구현할 수 있습니다.