javax.swing.text
클래스 AbstractDocument

java.lang.Object 
  javax.swing.text.AbstractDocument

모든 구현된 인터페이스:

Serializable, Document

알려진 직계 서브 클래스:

DefaultStyledDocument, PlainDocument

public abstract class AbstractDocument
extends Object 
implements Document,
 Serializable 

문서 인터페이스의 구현이며, 각종의 문서를 구현할 때의 베이스가 됩니다. 이 레벨에서는 정책가 매우 몇 안 되는의로 거기에 응해 사용이 어려워집니다.

이 클래스는 문서의 락 도구를 구현합니다. 이 도구에 의해 복수의 읽기 또는 하나의 write를 취급할 수 있게 되어, 복수의 출력이 있어도, 문서의 옵저버 전원으로 이전의 변경이 통지될 때까지, 문서에 다른 변경을 더할 수가 없습니다. read 락의 취득 및 해방에는 render 메서드를 사용합니다. 출력 락은 문서를 변경하는 메서드에 의해 취득되어 그 메서드 호출동안은 보관 유지됩니다. 통지는 문서를 변경하는 thread상에서 행해집니다. 이 thread는 통지동안은 문서에의 완전한 읽기 권한을 가지고 있습니다. 한편, 그 외의 출력측은 통지가 완료할 때까지는 액세스가 용서되지 않습니다. 통지는 Beans 이벤트 통지이며, 모든 리스너가 통지를 받을 때까지는 다른 변경을 허가하지 않습니다.

이 클래스로부터 상속 된 임의의 모델로 BasicTextUI 로부터 파생한 Look ＆ Feel 구현을 가지는 텍스트 컴퍼넌트와 관련해 사용되는 것은 안전하게 비동기에게 갱신됩니다. 이것은 문서의 타입이 AbstractDocument인 경우에는 View 계층에의 모든 액세스가 BasicTextUI에 의해 직렬화 되기 때문입니다. 락 도구에 서는 독립한 thread의 View 계층에의 액세스는 반드시 DocumentListener 메서드를 개입시켜 행해져 또, 어느 1개의 시점에는 활성화된 thread는 1개 밖에 존재하지 않다고 봅니다.

동기의 지원가 필요한 경우는 또한 다음의 전제 조건이 있습니다. 임의의 DocumentListener 및 UndoListener 구현에 대한 코드 패스가 thread에 대해서 안전한 것, 또, 데드 록을 피하는 경우에는 컴퍼넌트의 락에 액세스 하지 않는 것, 이라고 하는 조건입니다. JComponent repaint 메서드 및 revalidate 메서드는 안전합니다.

AbstractDocument는 문서의 마지막에 암묵의 브레이크를 모델화합니다. 다양한 일이 가능하지만, 그 1개 로서 마지막 문자의 후에 caret를 배치할 수 있습니다. 그 결과, Content 보다 짧은 getLength를 리턴합니다. 독자적인 Content를 생성하는 경우는 문자를 추가해 초기화하도록의해 주세요. 이 예에 대해서는 StringContent와 GapContent를 참조하십시오. 다른 전제 조건은 암묵의 최종 문자를 모델화하는 Elements는 endOffset == (getLength() + 1)가 되는 것입니다. 예를 들어 DefaultStyledDocument인 경우는 getParagraphElement(getLength()). getEndOffset() == getLength() + 1 입니다.

경고: 이 클래스의 직렬화 된 객체는 향후의 Swing 릴리즈와 호환되지 않을 예정입니다. 현재의 직렬화의 지원은 단기간의 운용이나, 같은 버전의 Swing를 실행하는 어플리케이션간의 RMI에 적절하고 있습니다. JDK 버전 1.4 이후, 모든 JavaBeans^™ 장기간의 운용 지원은 java.beans 패키지에 추가되고 있습니다. 자세한 내용은 XMLEncoder를 참조하십시오.

중첩(Nested) 클래스 개요

class	AbstractDocument.AbstractElement 요소의 추상 부분을 구현합니다.
static interface	AbstractDocument.AttributeContext 이 인터페이스는 플러그 인 가능한 속성 압축 수법을 MutableAttributeSet 구현으로 사용 가능하게 하기 위해서 사용할 수 있습니다.
class	AbstractDocument.BranchElement 다른 요소를 포함한 복합 요소를 구현합니다.
static interface	AbstractDocument.Content 편집 가능한 문자의 순서를 나타내는 인터페이스입니다.
class	AbstractDocument.DefaultDocumentEvent 문서가 변경되었을 경우에 문서의 변경을 포함합니다.
static class	AbstractDocument.ElementEdit 문서의 이벤트에 추가할 수 있는 ElementChange 구현입니다.
class	AbstractDocument.LeafElement 어떤 종류의 컨텐츠를 직접 나타내는 요소를 구현합니다.

필드 개요

protected static String	BAD_LOCATION 부정한 위치를 나타내는 에러 메세지입니다.
static String	BidiElementName 한방향의 실행을 나타내는 요소의 이름입니다.
static String	ContentElementName 내용을 나타내는 요소의 이름입니다.
static String	ElementNameAttribute 요소의 이름의 지정에 사용하는 속성의 이름입니다.
protected EventListenerList	listenerList 문서의 이벤트 리스너입니다.
static String	ParagraphElementName 단락을 나타내는 요소의 이름입니다.
static String	SectionElementName 행, 단락등의 섹션을 나타내는 요소의 이름입니다.

인터페이스 javax.swing.text. Document 로부터 상속된 필드

StreamDescriptionProperty, TitleProperty

생성자 개요

protected	AbstractDocument (AbstractDocument.Content data) 하등의 컨텐츠 기억 도구를 랩 한, 새로운 AbstractDocument를 구축합니다.
protected	AbstractDocument (AbstractDocument.Content data, AbstractDocument.AttributeContext context) 하등의 컨텐츠 기억 도구를 랩 한, 새로운 AbstractDocument를 구축합니다.

메서드 개요

void	addDocumentListener (DocumentListener listener) 문서 리스너를 추가해, 변경이 있었을 때에 통지되도록 합니다.
void	addUndoableEditListener (UndoableEditListener listener) 임의의 변경을 통지하는 un-do 리스너를 추가합니다.
protected Element	createBranchElement (Element parent, AttributeSet a) 문서의 가지의 요소를 작성합니다.
protected Element	createLeafElement (Element parent, AttributeSet a, int p0, int p1) 문서의 잎의 요소를 작성합니다.
Position	createPosition (int offs) 문서가 변경되었을 때에 변경을 추적하는 위치를 리턴합니다.
void	dump (PrintStream out) 진단용의 덤프를 출력합니다.
protected void	fireChangedUpdate (DocumentEvent e) 이 이벤트 타입의 통지를 전달 대상으로의해 등록하고 있는 리스너 모두에게 통지합니다.
protected void	fireInsertUpdate (DocumentEvent e) 이 이벤트 타입의 통지를 전달 대상으로의해 등록하고 있는 리스너 모두에게 통지합니다.
protected void	fireRemoveUpdate (DocumentEvent e) 이 이벤트 타입의 통지를 전달 대상으로의해 등록하고 있는 리스너 모두에게 통지합니다.
protected void	fireUndoableEditUpdate (UndoableEditEvent e) 이 이벤트 타입의 통지를 전달 대상으로의해 등록하고 있는 리스너 모두에게 통지합니다.
int	getAsynchronousLoadPriority () 비동기 로드의 우선 순위를 취득합니다.
protected AbstractDocument.AttributeContext	getAttributeContext () 속성을 관리하기 위한 컨텍스트를 리턴합니다.
Element	getBidiRootElement () 문서의 쌍방향 구조의 루트 요소를 리턴합니다.
protected AbstractDocument.Content	getContent () 문서의 내용을 리턴합니다.
protected Thread	getCurrentWriter () 현재의 출력 thread가 있으면, 그것을 리턴합니다.
abstract Element	getDefaultRootElement () 루트 요소를 리턴합니다.
DocumentFilter	getDocumentFilter () 삽입 또는 삭제의 필터를 실시하는 DocumentFilter를 리턴합니다.
DocumentListener []	getDocumentListeners () 이 문서에 등록된, 모든 문서 리스너로부터 되는 배열을 리턴합니다.
Dictionary <Object, Object >	getDocumentProperties () 프로퍼티세트의 관리를 지원 합니다.
Position	getEndPosition () 문서의 말미를 나타내는 위치를 리턴합니다.
int	getLength () 데이터의 길이를 리턴합니다.
<T extends EventListener > T[]	getListeners (Class <T> listenerType) 이 문서상에서 FooListener로 서 현재 등록되어 있는 모든 객체로부터 되는 배열을 리턴합니다.
abstract Element	getParagraphElement (int pos) 지정된 위치를 포함한 단락 요소를 리턴합니다.
Object	getProperty (Object key) 프로퍼티의 값을 조사하는데 편리한 메서드입니다.
Element []	getRootElements () 정의되고 있는 루트 요소를 모두 리턴합니다.
Position	getStartPosition () 문서의 선두를 나타내는 위치를 리턴합니다.
String	getText (int offset, int length) 문서로부터 텍스트의 순서를 취득합니다.
void	getText (int offset, int length, Segment txt) 문서의 지정 부분내에 있는 텍스트를 꺼냅니다.
UndoableEditListener []	getUndoableEditListeners () 이 문서에 등록된, 모든 취소 가능 편집 리스너로부터 되는 배열을 리턴합니다.
void	insertString (int offs, String str, AttributeSet a) 문서에 내용을 삽입합니다.
protected void	insertUpdate (AbstractDocument.DefaultDocumentEvent chng, AttributeSet attr) 텍스트 삽입의 결과로서, 문서의 구조를 갱신합니다.
protected void	postRemoveUpdate (AbstractDocument.DefaultDocumentEvent chng) 텍스트 삭제의 결과로서, 임의의 문서의 구조를 갱신합니다.
void	putProperty (Object key, Object value) 프로퍼티의 값을 포함하는데 편리한 메서드입니다.
void	readLock () 락을 취득해, 문서로부터 하등의 상태의 read를 개시할 수 있도록 합니다.
void	readUnlock () 읽을 락을 해제합니다.
void	remove (int offs, int len) 문서로부터 내용을 삭제합니다.
void	removeDocumentListener (DocumentListener listener) 문서 리스너를 삭제합니다.
void	removeUndoableEditListener (UndoableEditListener listener) un-do 리스너를 삭제합니다.
protected void	removeUpdate (AbstractDocument.DefaultDocumentEvent chng) 텍스트 삭제의 결과로서, 임의의 문서의 구조를 갱신합니다.
void	render (Runnable r) 모델이 비동기적인 갱신을 지원 하고 있는 경우, 병행성에 직면해 모델을 안전하게 렌더링 할 수 있도록 합니다.
void	replace (int offset, int length, String text, AttributeSet attrs) offset로 부터 offset + length 까지의 텍스트의 영역을 삭제해, text로 옮겨놓습니다.
void	setAsynchronousLoadPriority (int p) 비동기 로드의 우선 순위를 설정합니다.
void	setDocumentFilter (DocumentFilter filter) DocumentFilter를 설정합니다.
void	setDocumentProperties (Dictionary <Object, Object > x) 이 문서의 문서 프로퍼티의 사전을 옮겨놓습니다.
protected void	writeLock () 락을 취득해, 락이 보호하고 있는 문서의 변경을 개시할 수 있도록 합니다.
protected void	writeUnlock () 이전 writeLock 경유로 취득된 출력 락을 해제합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

필드의 상세

listenerList

protected EventListenerList  listenerList

문서의 이벤트 리스너입니다.

BAD_LOCATION

protected static final String  BAD_LOCATION

부정한 위치를 나타내는 에러 메세지입니다.

관련 항목:

정수 필드값

ParagraphElementName

public static final String  ParagraphElementName

단락을 나타내는 요소의 이름입니다.

관련 항목:

정수 필드값

ContentElementName

public static final String  ContentElementName

내용을 나타내는 요소의 이름입니다.

관련 항목:

정수 필드값

SectionElementName

public static final String  SectionElementName

행, 단락등의 섹션을 나타내는 요소의 이름입니다.

관련 항목:

정수 필드값

BidiElementName

public static final String  BidiElementName

한방향의 실행을 나타내는 요소의 이름입니다.

관련 항목:

정수 필드값

ElementNameAttribute

public static final String  ElementNameAttribute

요소의 이름의 지정에 사용하는 속성의 이름입니다.

관련 항목:

정수 필드값

생성자 상세

AbstractDocument

protected AbstractDocument(AbstractDocument.Content  data)

하등의 컨텐츠 기억 도구를 랩 한, 새로운 AbstractDocument를 구축합니다.

파라미터:

data - 컨텐츠

AbstractDocument

protected AbstractDocument(AbstractDocument.Content  data,
                           AbstractDocument.AttributeContext  context)

하등의 컨텐츠 기억 도구를 랩 한, 새로운 AbstractDocument를 구축합니다.

파라미터:

data - 컨텐츠

context - 속성의 컨텍스트

메서드의 상세

getDocumentProperties

public Dictionary <Object,
Object > getDocumentProperties()

프로퍼티세트의 관리를 지원 합니다. 호출측은, documentProperties 사전을 사용해, 문서 전체에 관한 프로퍼티의 주석을 부가할 수 있습니다.

반환값:

null 이외의 Dictionary

관련 항목:

setDocumentProperties(java.util.Dictionary)

setDocumentProperties

public void setDocumentProperties(Dictionary <Object,
Object > x)

이 문서의 문서 프로퍼티의 사전을 옮겨놓습니다.

파라미터:

x - 새로운 사전

관련 항목:

getDocumentProperties()

fireInsertUpdate

protected void fireInsertUpdate(DocumentEvent  e)

이 이벤트 타입의 통지를 전달 대상으로의해 등록하고 있는 리스너 모두에게 통지합니다. fire 메서드에게 건네진 파라미터를 사용해, 이벤트의 인스턴스는 생성됩니다.

파라미터:

e - 이벤트

관련 항목:

EventListenerList

fireChangedUpdate

protected void fireChangedUpdate(DocumentEvent  e)

이 이벤트 타입의 통지를 전달 대상으로의해 등록하고 있는 리스너 모두에게 통지합니다. fire 메서드에게 건네진 파라미터를 사용해, 이벤트의 인스턴스는 생성됩니다.

파라미터:

e - 이벤트

관련 항목:

EventListenerList

fireRemoveUpdate

protected void fireRemoveUpdate(DocumentEvent  e)

이 이벤트 타입의 통지를 전달 대상으로의해 등록하고 있는 리스너 모두에게 통지합니다. fire 메서드에게 건네진 파라미터를 사용해, 이벤트의 인스턴스는 생성됩니다.

파라미터:

e - 이벤트

관련 항목:

EventListenerList

fireUndoableEditUpdate

protected void fireUndoableEditUpdate(UndoableEditEvent  e)

이 이벤트 타입의 통지를 전달 대상으로의해 등록하고 있는 리스너 모두에게 통지합니다. fire 메서드에게 건네진 파라미터를 사용해, 이벤트의 인스턴스는 생성됩니다.

파라미터:

e - 이벤트

관련 항목:

EventListenerList

getListeners

public <T extends EventListener > T[] getListeners(Class <T> listenerType)

이 문서상에서 FooListener로 서 현재 등록되어 있는 모든 객체로부터 되는 배열을 리턴합니다. FooListener 등록에는 addFooListener 메서드가 사용됩니다.

FooListener.class 등의 클래스 리터럴을 사용해, listenerType인수를 지정할 수 있습니다. 예를 들어 아래의 코드를 사용해, 문서 d를 그 문서 리스너에게 조회할 수 있습니다.

DocumentListener[] mls = (DocumentListener[])(d.getListeners(DocumentListener.class));

이런 종류의 리스너가 존재하지 않는 경우, 이 메서드에서는 비어있는 배열이 리턴됩니다 .

파라미터:

listenerType - 요구되는 리스너의 타입. java.util.EventListener 하위 인터페이스를 지정

반환값:

이 컴퍼넌트에 FooListener로 서 등록된 모든 객체로부터 되는 배열. 이런 종류의 리스너가 추가되어 있지 않은 경우는 비어있는 배열

예외:

ClassCastException - listenerType가 java.util.EventListener를 구현하는 클래스 또는 인터페이스를 지정하지 않는 경우

도입된 버전 :

1.3

관련 항목:

getDocumentListeners(), getUndoableEditListeners()

getAsynchronousLoadPriority

public int getAsynchronousLoadPriority()

비동기 로드의 우선 순위를 취득합니다. 0 보다 작은 값의 경우, 문서는 비동기에게는 로드 되지 않습니다.

반환값:

비동기 로드의 우선 순위, 또는 문서가 비동기에게 로드 되지 않는 경우는 -1

setAsynchronousLoadPriority

public void setAsynchronousLoadPriority(int p)

비동기 로드의 우선 순위를 설정합니다.

파라미터:

p - 새로운의 비동기 로드의 우선 순위. 0 보다 작은 값은 문서가 비동기에게 로드 되는 것을 나타낸다

setDocumentFilter

public void setDocumentFilter(DocumentFilter  filter)

DocumentFilter를 설정합니다. DocumentFilter가 insert와 remove에 게 건네져 조건부로 텍스트의 삽입이나 삭제가 가능하게 됩니다. null값은 필터가 실행되지 않는 것을 나타냅니다.

파라미터:

filter - 텍스트의 제약에 사용되는 DocumentFilter

도입된 버전 :

1.4

관련 항목:

getDocumentFilter()

getDocumentFilter

public DocumentFilter  getDocumentFilter()

삽입 또는 삭제의 필터를 실시하는 DocumentFilter를 리턴합니다. 반환값 null은 필터가 실행되지 않는 것을 나타냅니다.

반환값:

DocumentFilter

도입된 버전 :

1.4

관련 항목:

setDocumentFilter(javax.swing.text.DocumentFilter)

render

public void render(Runnable  r)

모델이 비동기적인 갱신을 지원 하고 있는 경우, 병행성에 직면해 모델을 안전하게 렌더링 할 수 있도록 합니다. 지정된 실행 가능 파일은 그 실행중으로 아무 변경도 없게 모델을 안전하게 읽어내는 방법으로 실행됩니다. 실행 가능 파일은 그것 자신으로 변경을 더할 수 없습니다.

이 구현은 실행하고 있는 동안, read 락을 취득하기 위한 것입니다. 복수를 동시에 실행하고 있는 경우, 활성화 렌더링중의 객체가 있는 동안은 모든 출력이 블록 됩니다. 객체가 예외를 Throw 했을 경우, 그 락은 안전하게 해방됩니다. 결코 종료하지 않는 객체에 대한 보호는 없고, 사실상, 문서는 자신이 존재하는 동안 쭉 락 됩니다.

지정된 객체가 어떠한 변경을 시도해도, 데드 록이 발생합니다. 이 상황을 검지할 수 있도록 하기 위해서 개개의 렌더링 thread를 추적할 수 없습니다. 또, 서브 클래스는 렌더링 thread의 추적 및 에러의 Throw의 오버헤드를 발생시킬 가능성이 있습니다.

이 메서드는 thread에 대해서 안전합니다만, 대부분의 Swing 메서드는 다릅니다. 자세한 내용은 「Threads and Swing」를 참조하십시오.

정의:

인터페이스 Document 내의 render

파라미터:

r - 실행하는 렌더링

getLength

public int getLength()

데이터의 길이를 리턴합니다. 사용자 의 데이터를 나타내는 내용의 문자수입니다.

정의:

인터페이스 Document 내의 getLength

반환값:

길이 >= 0

관련 항목:

Document.getLength()

addDocumentListener

public void addDocumentListener(DocumentListener  listener)

문서 리스너를 추가해, 변경이 있었을 때에 통지되도록 합니다.

정의:

인터페이스 Document 내의 addDocumentListener

파라미터:

listener - 추가하는 DocumentListener

관련 항목:

Document.addDocumentListener(javax.swing.event.DocumentListener)

removeDocumentListener

public void removeDocumentListener(DocumentListener  listener)

문서 리스너를 삭제합니다.

정의:

인터페이스 Document 내의 removeDocumentListener

파라미터:

listener - 삭제하는 DocumentListener

관련 항목:

Document.removeDocumentListener(javax.swing.event.DocumentListener)

getDocumentListeners

public DocumentListener [] getDocumentListeners()

이 문서에 등록된, 모든 문서 리스너로부터 되는 배열을 리턴합니다.

반환값:

이 문서의 DocumentListener 모두. 문서 리스너가 등록되지 않은 경우는 비어있는 배열

도입된 버전 :

1.4

관련 항목:

addDocumentListener(javax.swing.event.DocumentListener), removeDocumentListener(javax.swing.event.DocumentListener)

addUndoableEditListener

public void addUndoableEditListener(UndoableEditListener  listener)

임의의 변경을 통지하는 un-do 리스너를 추가합니다. UndoableEdit로 실행되는 「바탕으로 되돌리는/재실행」조작은 적절한 DocumetnEvent를 발생시켜, 뷰 (복수의 경우도 있어)를 모델과 동기 시킵니다.

정의:

인터페이스 Document 내의 addUndoableEditListener

파라미터:

listener - 추가하는 UndoableEditListener

관련 항목:

Document.addUndoableEditListener(javax.swing.event.UndoableEditListener)

removeUndoableEditListener

public void removeUndoableEditListener(UndoableEditListener  listener)

un-do 리스너를 삭제합니다.

정의:

인터페이스 Document 내의 removeUndoableEditListener

파라미터:

listener - 삭제하는 UndoableEditListener

관련 항목:

Document.removeDocumentListener(javax.swing.event.DocumentListener)

getUndoableEditListeners

public UndoableEditListener [] getUndoableEditListeners()

이 문서에 등록된, 모든 취소 가능 편집 리스너로부터 되는 배열을 리턴합니다.

반환값:

이 문서의 UndoableEditListener 모두. 취소 가능 편집 리스너가 등록되지 않은 경우는 비어있는 배열

도입된 버전 :

1.4

관련 항목:

addUndoableEditListener(javax.swing.event.UndoableEditListener), removeUndoableEditListener(javax.swing.event.UndoableEditListener)

getProperty

public final Object  getProperty(Object  key)

프로퍼티의 값을 조사하는데 편리한 메서드입니다. 이것은 아래와 동등합니다.

 getDocumentProperties(). get(key);
 

정의:

인터페이스 Document 내의 getProperty

파라미터:

key - null 이외의 프로퍼티 키

반환값:

이 프로퍼티의 값 또는 null

관련 항목:

getDocumentProperties()

putProperty

public final void putProperty(Object  key,
                              Object  value)

프로퍼티의 값을 포함하는데 편리한 메서드입니다. 이것은 아래와 동등합니다.

 getDocumentProperties(). put(key, value);
 

value가 null인 경우, 이 메서드는 프로퍼티를 삭제합니다.

정의:

인터페이스 Document 내의 putProperty

파라미터:

key - null 이외의 키

value - 프로퍼티의 값

관련 항목:

getDocumentProperties()

remove

public void remove(int offs,
                   int len)
            throws BadLocationException 

문서로부터 내용을 삭제합니다. 내용의 삭제에의해 실제의 변경이 일어날 때까지의 출력 락이 발생합니다. 옵저버는 이 메서드를 호출한 thread상에서 변경의 통지를 받습니다.

이 메서드는 thread에 대해서 안전합니다만, 대부분의 Swing 메서드는 다릅니다. 자세한 내용은 「Threads and Swing」를 참조하십시오.

정의:

인터페이스 Document 내의 remove

파라미터:

offs - 개시 오프셋(offset) >= 0

len - 삭제 대상의 문자수 >= 0

예외:

BadLocationException - 지정된 삭제의 위값이 문서내의 유효한 위값이 아닌 경우

관련 항목:

Document.remove(int, int)

replace

public void replace(int offset,
                    int length,
                    String  text,
                    AttributeSet  attrs)
             throws BadLocationException 

offset로 부터 offset + length 까지의 텍스트의 영역을 삭제해, text로 옮겨놓습니다. 이 동작이 어떻게 구현될까는 그 구현에 좌우되어 삭제하고 나서 삽입을 실시한다고 하는 것처럼 다른 2개의 조작으로서 구현하는 일도 있으면, 치환을 실시한다고 하는 것처럼 1개의 기본 조작으로서 구현하는 일도 있습니다.

파라미터:

offset - 자 요소의 인덱스

length - 삭제하는 텍스트의 길이. 0인 경우는 아무것도 삭제되지 않는

text - 삽입하는 텍스트. null인 경우, 텍스트는 삽입되지 않는

attrs - 삽입된 텍스트의 속성을 나타내는 AttributeSet 로 일반적으로 null. 비어있는 속성 세트로서 다루어지지만, 서브 클래스에서 정확한 해석을 한다

예외:

BadLocationException - 지정된 위값이 문서내의 유효한 위값이 아닌 경우

도입된 버전 :

1.4

insertString

public void insertString(int offs,
                         String  str,
                         AttributeSet  a)
                  throws BadLocationException 

문서에 내용을 삽입합니다. 내용의 삽입에의해 실제의 변경이 일어날 때까지는 출력 락이 보관 유지됩니다. 그 후로 출력 락을 글로브 하고 있는 thread상의 옵저버에 통지를 합니다.

이 메서드는 thread에 대해서 안전합니다만, 대부분의 Swing 메서드는 다릅니다. 자세한 내용은 「Threads and Swing」를 참조하십시오.

정의:

인터페이스 Document 내의 insertString

파라미터:

offs - 개시 오프셋(offset) >= 0

str - 삽입하는 캐릭터 라인. null 나 비어있는 캐릭터 라인의 경우는 아무것도 하지 않는

a - 삽입된 컨텐츠의 속성

예외:

BadLocationException - 지정된 삽입의 위값이 문서내의 유효한 위값이 아닌 경우

관련 항목:

Document.insertString(int, java.lang.String, javax.swing.text.AttributeSet)

getText

public String  getText(int offset,
                      int length)
               throws BadLocationException 

문서로부터 텍스트의 순서를 취득합니다.

정의:

인터페이스 Document 내의 getText

파라미터:

offset - 개시 오프셋(offset) >= 0

length - 검색 대상의 문자수 >= 0

반환값:

텍스트

예외:

BadLocationException - 지정된 범위에 문서내에서는 무효인 위값이 포함되는 경우

관련 항목:

Document.getText(int, int)

getText

public void getText(int offset,
                    int length,
                    Segment  txt)
             throws BadLocationException 

문서의 지정 부분내에 있는 텍스트를 꺼냅니다.

txt 파라미터의 partialReturn 프로퍼티가 false인 경우, Segment 로 리턴된 데이터는 요구된 길이 전체가 되어, 데이터의 포함 방법에 따라 카피가 되는 경우가 되지 않는 경우가 있습니다. partialReturn 프로퍼티가 true인 경우는 복사본을 작성하지 않아도 돌려주는 것이 가능한 텍스트의 양만이 리턴됩니다 . 부분적으로 돌려주는 것으로 문서의 대부분을 스캔 하는 경우의 퍼포먼스가 향상합니다. 부분적으로 돌려주는 방법으로 문서 전체에 액세스 하는 예를 다음에 나타냅니다.

   int nleft = doc.getDocumentLength();
   Segment text = new Segment();
   int offs = 0;
   text.setPartialReturn(true);   
   while (nleft > 0) {
       doc.getText(offs, nleft, text);
       // do something with text
       nleft -= text.count;
       offs += text.count;
   }
 

정의:

인터페이스 Document 내의 getText

파라미터:

offset - 개시 오프셋(offset) >= 0

length - 검색 대상의 문자수 >= 0

txt - 텍스트를 얻는 Segment 객체

예외:

BadLocationException - 지정된 범위에 문서내에서는 무효인 위값이 포함되는 경우

createPosition

public Position  createPosition(int offs)
                        throws BadLocationException 

문서가 변경되었을 때에 변경을 추적하는 위치를 리턴합니다.

이 메서드는 thread에 대해서 안전합니다만, 대부분의 Swing 메서드는 다릅니다. 자세한 내용은 「Threads and Swing」를 참조하십시오.

정의:

인터페이스 Document 내의 createPosition

파라미터:

offs - 모델내의 위치 >= 0

반환값:

위치

예외:

BadLocationException - 지정된 위값이 관련된 문서내의 유효한 위치를 나타내지 않는 경우

관련 항목:

Document.createPosition(int)

getStartPosition

public final Position  getStartPosition()

문서의 선두를 나타내는 위치를 리턴합니다. 리턴된 위치는 변경을 추적해 문서의 선두에 항상 위치하기 위해서 이용할 수 있습니다.

정의:

인터페이스 Document 내의 getStartPosition

반환값:

위치

getEndPosition

public final Position  getEndPosition()

문서의 말미를 나타내는 위치를 리턴합니다. 리턴된 위치는 변경을 추적해 문서의 말미에 항상 위치하기 위해서 이용할 수 있습니다.

정의:

인터페이스 Document 내의 getEndPosition

반환값:

위치

getRootElements

public Element [] getRootElements()

정의되고 있는 루트 요소를 모두 리턴합니다. 보통, 루트 요소는 1개 밖에 없습니다. 그 때문에 디폴트의 구현에서는 디폴트 루트 요소가 리턴됩니다 .

정의:

인터페이스 Document 내의 getRootElements

반환값:

루트 요소

getDefaultRootElement

public abstract Element  getDefaultRootElement()

루트 요소를 리턴합니다. 요소의 구조에 뷰를 할당하는 다른 도구가 제공되지 않는 이상 이 루트 요소가 뷰의 베이스가 됩니다.

정의:

인터페이스 Document 내의 getDefaultRootElement

반환값:

루트 요소

관련 항목:

Document.getDefaultRootElement()

getBidiRootElement

public Element  getBidiRootElement()

문서의 쌍방향 구조의 루트 요소를 리턴합니다. 이 루트 요소의 자식는 지정된 Unicode 쌍방향 구조 레벨의 문자의 줄을 나타냅니다.

getParagraphElement

public abstract Element  getParagraphElement(int pos)

지정된 위치를 포함한 단락 요소를 리턴합니다. 서브 클래스는 무엇이 단락을 구성하는 것인지를 자신으로 정의하지 않으면 안됩니다. 그 때는 단락을 구성하는 것이, 적어도 텍스트의 체크이며, 그에 대한 Unicode 쌍방향 알고리즘을 실행할 수 있을 필요가 있는 것에 주의해 주세요.

파라미터:

pos - 개시 오프셋(offset) >= 0

반환값:

요소

getAttributeContext

protected final AbstractDocument.AttributeContext  getAttributeContext()

속성을 관리하기 위한 컨텍스트를 리턴합니다. 이 메서드는 AttributeSet 정보의 압축에 사용되는 방법을 사실상 확립합니다.

반환값:

컨텍스트

insertUpdate

protected void insertUpdate(AbstractDocument.DefaultDocumentEvent  chng,
                            AttributeSet  attr)

텍스트 삽입의 결과로서, 문서의 구조를 갱신합니다. 이 처리는 출력 락 안에서 발생합니다. 이 클래스의 서브 클래스가 이 메서드를 다시 구현했을 경우는 슈퍼 클래스에도 처리를 위양 합니다.

파라미터:

chng - 변경의 설명

attr - 변경의 속성

removeUpdate

protected void removeUpdate(AbstractDocument.DefaultDocumentEvent  chng)

텍스트 삭제의 결과로서, 임의의 문서의 구조를 갱신합니다. 이 메서드의 호출은 텍스트가 Content 로부터 실제로 삭제되기 이전에 실행됩니다. 이 처리는 출력 락 안에서 발생합니다. 이 클래스의 서브 클래스가 이 메서드를 다시 구현했을 경우는 슈퍼 클래스에도 처리를 위양 합니다.

파라미터:

chng - 변경의 설명

postRemoveUpdate

protected void postRemoveUpdate(AbstractDocument.DefaultDocumentEvent  chng)

텍스트 삭제의 결과로서, 임의의 문서의 구조를 갱신합니다. 이 메서드의 호출은 텍스트가 Content 로부터 실제로 삭제된 뒤에 실행됩니다. 이 처리는 출력 락 안에서 발생합니다. 이 클래스의 서브 클래스가 이 메서드를 다시 구현했을 경우는 슈퍼 클래스에도 처리를 위양 합니다.

파라미터:

chng - 변경의 설명

dump

public void dump(PrintStream  out)

진단용의 덤프를 출력합니다.

파라미터:

out - 출력 스트림

getContent

protected final AbstractDocument.Content  getContent()

문서의 내용을 리턴합니다.

반환값:

컨텐츠

createLeafElement

protected Element  createLeafElement(Element  parent,
                                    AttributeSet  a,
                                    int p0,
                                    int p1)

문서의 잎의 요소를 작성합니다. 문서의 구조를 나타내기 위해서 작성되는 요소의 훅입니다. 이 구현이 구조와 내용을 분리한 채로에 유지하므로 내용의 확대에 응해 요소가 자동적으로 성장해, 게다가 기존의 요소의 분기 (가지)가 계속됩니다. 사용되는 요소의 형태에 유연성을 주도록 요소를 생성하는 방법에 대해서는 문서 자체로 결정할 필요가 있습니다.

파라미터:

parent - 친요소

a - 요소의 속성

p0 - 범위의 시점 >= 0

p1 - 범위의 종점 >= p0

반환값:

새로운 요소

createBranchElement

protected Element  createBranchElement(Element  parent,
                                      AttributeSet  a)

문서의 가지의 요소를 작성합니다. 이 요소에는 다른 요소 (복수가능)를 포함할 수 있습니다 .

파라미터:

parent - 친요소

a - 속성

반환값:

요소

getCurrentWriter

protected final Thread  getCurrentWriter()

현재의 출력 thread가 있으면, 그것을 리턴합니다. 메서드가 기존의 변경의 일부로서 불려가 고 있는지 어떤지, 혹은 락을 취득해 새로운 트랜잭션(transaction)를 개시할 필요가 있을지 어떨지를 구별하기 위해서 사용할 수 있습니다.

반환값:

문서를 변경하고 있는 활성화된 thread. 진행중의 변경이 없는 경우는 null

writeLock

protected final void writeLock()

락을 취득해, 락이 보호하고 있는 문서의 변경을 개시할 수 있도록 합니다. 락의 취득은 출력해, 변경의 통지, 혹은 read를 하고 있는 동안은 할 수 없습니다. 또, thread는 문서 통지내로부터 추가의 writeLock를 취득하려고 하지 않는 이상 복수의 writeLock를 취득할 수 있습니다. DocumentListener 통지내로부터 writeLock를 취득하려고 하면, IllegalStateException가 됩니다. thread 마다 복수의 writeLock를 얻는 기능에의해 서브 클래스는 writeLock를 취득해, 다수의 조작을 실행하고 나서, 락을 개방할 수 있습니다.

writeLock 호출은, writeUnlock 호출과 회수가 같지 않으면 안됩니다. 그렇지 않으면Document이 락 상태대로 되어, read나 write를 실행할 수 없습니다.

예외:

IllegalStateException - 부정한 락을 시도했을 경우에 Throw 된다. 문서가 적절히 구현되고 있으면, 문서 리스너가 문서의 변경을 시도했을 경우에 한정해 이 예외가 발생한다. 이러한 상황은 Bean 이벤트 모델에 위반하고 있다. 이 이벤트 모델에서는 전달의 순서에 보증은 없고, 변경이 허가되기 전에 모든 리스너에게 통지될 필요가 있다

writeUnlock

protected final void writeUnlock()

이전 writeLock 경유로 취득된 출력 락을 해제합니다. 락수를 1개 줄인뒤 미처리의 락이 없는 경우는 새로운 출력측 또는 읽기 옆이 허가됩니다.

관련 항목:

writeLock()

readLock

public final void readLock()

락을 취득해, 문서로부터 하등의 상태의 read를 개시할 수 있도록 합니다. 복수의 리더를 동시에 존재할 수 있습니다. 리스너에 대한 변경의 통지가 완료할 때까지 출력은 read를 블록 합니다. 문서 락이 잘못해 취득되지 않게, 이 메서드는 주의 깊게 사용할 필요가 있습니다. readLock 메서드와 같은 수만큼, readUnlock를 호출해 주세요.

관련 항목:

readUnlock()

readUnlock

public final void readUnlock()

읽을 락을 해제합니다. 읽을 1개이 완료한 것을 통지합니다. 그 밖에 리더가 없으면, write를 재개할 수 있습니다. 이 메서드의 호출 회수는 readLock 호출 회수와 같게 할 필요가 있으므로 이것을 보증하기 위해서 finally 문 안에서 사용합니다. 다음에 예를 나타냅니다.

     readLock();
     try {
         // do something
     } finally {
         readUnlock();
     }
 

관련 항목:

readLock()