All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class com.sun.java.swing.text.AbstractDocument

java.lang.Object
   |
   +----com.sun.java.swing.text.AbstractDocument

public abstract class AbstractDocument

extends Object

implements Document, Serializable

BAD_LOCATION

Error message to indicate a bad location.

ContentElementName

Name of elements used to represent content

ElementNameAttribute

Name of the attribute used to specify element names.

listenerList

ParagraphElementName

Name of elements used to represent paragraphs

SectionElementName

Name of elements used to hold sections (lines/paragraphs).

AbstractDocument(AbstractDocument. Content)

Constructs a new AbstractDocument, wrapped around some specified content.

addDocumentListener(DocumentListener)

Adds a document listener for notification of any changes.

createBranchElement(Element, AttributeSet)

Creates a document branch element, that can contain other elements.

createLeafElement(Element, AttributeSet, int, int)

Creates a document leaf element.

createPosition(int)

Returns a position that will track change as the document is altered.

dump(PrintStream)

Gives a diagnostic dump.

externalNotifyChange(DocumentEvent)

Notifies external listeners of a document attribute change.

externalNotifyInsert(DocumentEvent)

Notifies external listeners of a document insertion.

externalNotifyRemove(DocumentEvent)

Notifies external listeners of a document removal.

fireChangedUpdate(DocumentEvent)

fireInsertUpdate(DocumentEvent)

fireRemoveUpdate(DocumentEvent)

getContent()

Gets the content for the document.

getCurrentWriter()

Fetches the current writing thread if there is one.

getDefaultRootElement()

Returns the root element that views should be based upon unless some other mechanism for assigning views to element structures is provided.

getEndPosition()

Returns a position that represents the end of the document.

getLength()

Returns the length of the data.

getProperty(Object)

Gets a property for the document.

getRootElements()

Gets all root elements defined.

getStartPosition()

Returns a position that represents the start of the document.

getText(int, int)

Gets a subsequence of text from the document.

getText(int, int, Segment)

Gets some text from the document.

insertString(int, String, AttributeSet)

Inserts some content into the document.

insertUpdate(DefaultDocumentEvent, AttributeSet)

Updates document structure as a result of text insertion.

notifyUnlock()

Releases the notification lock.

putProperty(Object, Object)

Sets a property for the document.

readLock()

Acquires a lock to begin reading some state from the document.

readUnlock()

Does a read unlock.

remove(int, int)

Removes some content from the document.

removeDocumentListener(DocumentListener)

Removes a document listener.

removeUpdate(DefaultDocumentEvent)

Updates any document structure as a result of text removal.

writeAbandoned()

Releases the write/notify lock held because the write operation is being aborted.

writeLock()

Acquires a lock to begin mutating the document this lock protects.

writeUnlockNotifyLock()

Releases the write lock indicating that there will be no more mutations to the document, and acquire a lock for notifying observers of the document of the mutations to the document.

 protected EventListenerList listenerList

 protected static final String BAD_LOCATION

Error message to indicate a bad location.

 public static final String ParagraphElementName

Name of elements used to represent paragraphs

 public static final String ContentElementName

Name of elements used to represent content

 public static final String SectionElementName

Name of elements used to hold sections (lines/paragraphs).

 public static final String ElementNameAttribute

Name of the attribute used to specify element names.

 protected AbstractDocument(AbstractDocument. Content data)

Constructs a new AbstractDocument, wrapped around some specified content.

Parameters:

data - the content

 public int getLength()

Returns the length of the data. This method grabs a read lock. If there is currently a writer, then this call is blocked until the writer is finished making changes.

Returns:

the length

See Also:

getLength

 public synchronized void addDocumentListener(DocumentListener listener)

Adds a document listener for notification of any changes.

Parameters:

listener - the listener

See Also:

addDocumentListener

 public synchronized void removeDocumentListener(DocumentListener listener)

Removes a document listener.

Parameters:

listener - the listener

See Also:

removeDocumentListener

 protected void fireInsertUpdate(DocumentEvent e)

 protected void fireChangedUpdate(DocumentEvent e)

 protected void fireRemoveUpdate(DocumentEvent e)

 public Object getProperty(Object key)

Gets a property for the document.

Parameters:

key - the property key

Returns:

the value

 public void putProperty(Object key,
                         Object value)

Sets a property for the document.

Parameters:

key - the property key

value - the property value

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

Removes some content from the document. Removing content causes a write lock to be held while the actual changes are taking place, followed by a read lock which is held while observers are notified of the change.

Parameters:

offs - the starting offset

len - the number of characters to remove

Throws: BadLocationException

the given remove position is not a valid position within the document

See Also:

remove

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

Inserts some content into the document. Inserting content causes a write lock to be held while the actual changes are taking place, followed by a notification lock (that allows reads but not writes) while observers are notified of the change.

Parameters:

offs - the starting offset

str - the string to insert

a - the attributes for the inserted content

Throws: BadLocationException

the given insert position is not a valid position within the document

See Also:

insertString

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

Gets a subsequence of text from the document. This method grabs a read lock. If there is currently a writer, then this call is blocked until the writer is finished making changes.

Parameters:

offset - the starting offset

length - the number of characters to retrieve

Throws: BadLocationException

the range given includes a position that is not a valid position within the document

See Also:

getText

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

Gets some text from the document.

Parameters:

offset - the starting offset

length - the number of characters to retrieve

txt - the Segment object to retrieve the text into

Throws: BadLocationException

the range given includes a position that is not a valid position within the document

 public Position getStartPosition()

Returns a position that represents the start of the document.

Returns:

the position

See Also:

getStartPosition

 public Position getEndPosition()

Returns a position that represents the end of the document. This method grabs a read lock. If there is currently a writer, then this call is blocked until the writer is finished making changes.

Returns:

the position

See Also:

getEndPosition

 public synchronized Position createPosition(int offs) throws BadLocationException

Returns a position that will track change as the document is altered.

Parameters:

offs - the position

Throws: BadLocationException

if the given position does not represent a valid location in the associated document

See Also:

createPosition

 public Element[] getRootElements()

Gets all root elements defined. Typically, there will only be one so the default implementation is to return the default root element.

Returns:

the root element

 public abstract Element getDefaultRootElement()

Returns the root element that views should be based upon unless some other mechanism for assigning views to element structures is provided.

Returns:

the root element

See Also:

getDefaultRootElement

 protected void insertUpdate(DefaultDocumentEvent chng,
                             AttributeSet attr)

Updates document structure as a result of text insertion. This will happen within a write lock. If a subclass of this class reimplements this method, it should delegate to the superclass as well.

Parameters:

chng - a description of the change

attr - the attributes for the change

 protected void removeUpdate(DefaultDocumentEvent chng)

Updates any document structure as a result of text removal. This will happen within a write lock. If a subclass of this class reimplements this method, it should delegate to the superclass as well.

Parameters:

chng - a description of the change

 public void dump(PrintStream out)

Gives a diagnostic dump.

Parameters:

out - the output stream

 protected final AbstractDocument. Content getContent()

Gets the content for the document.

Returns:

the content

 protected final void externalNotifyInsert(DocumentEvent e)

Notifies external listeners of a document insertion. This removes the write lock and grabs a notification lock that prevents further writes, but allows reads. At the end of notification the notification lock is removed and writes can resume if there are no active readers.

Parameters:

e - the document event

 protected final void externalNotifyChange(DocumentEvent e)

Notifies external listeners of a document attribute change. This removes the write lock and grabs a notification lock that prevents further writes, but allows reads. At the end of notification the notification lock is removed and writes can resume if there are no active readers.

Parameters:

e - the document event

 protected final void externalNotifyRemove(DocumentEvent e)

Notifies external listeners of a document removal. This removes the write lock and grabs a notification lock that prevents further writes, but allows reads. At the end of notification the notification lock is removed and writes can resume if there are no active readers.

Parameters:

e - the document event

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

Creates a document leaf element. Hook through which elements are created to represent the document structure. Because this implementation keeps structure and content seperate, elements grow automatically when content is extended so splits of existing elements follow. The document itself gets to decide how to generate elements to give flexibility in the type of elements used.

Parameters:

parent - the parent element

a - the attributes for the element

p0 - the beginning of the range

p1 - the end of the range

Returns:

the new element

 protected Element createBranchElement(Element parent,
                                       AttributeSet a)

Creates a document branch element, that can contain other elements.

Parameters:

parent - the parent element

a - the attributes

 protected final synchronized Thread getCurrentWriter()

Fetches the current writing thread if there is one. This can be used to distinguish whether a method is being called as part of an existing modification or if a lock needs to be acquired and a new transaction started.

Returns:

s the thread actively modifying the document or null if there are no modifications in progress

 protected final synchronized void writeLock()

Acquires a lock to begin mutating the document this lock protects. There can be no notification of changes or reading going on in order to gain the lock.

 protected final synchronized void writeUnlockNotifyLock()

Releases the write lock indicating that there will be no more mutations to the document, and acquire a lock for notifying observers of the document of the mutations to the document. Readers are allowed in this state.

 protected final synchronized void writeAbandoned()

Releases the write/notify lock held because the write operation is being aborted.

 protected final synchronized void notifyUnlock()

Releases the notification lock. This enables writing to occur again.

 protected final synchronized void readLock()

Acquires a lock to begin reading some state from the document. There can be multiple readers at the same time and reading can occur while notification to the listeners is going on, but writing blocks the readers. If the calling thread is currently writing, it simply returns.

 protected final synchronized void readUnlock()

Does a read unlock. One of the readers is done. If there are no more readers then writing can begin again. If the calling thread is currently writing, is simply returns.

All Packages  Class Hierarchy  This Package  Previous  Next  Index