Serializable
, AbstractDocument.Content
public class GapContent extends Object implements AbstractDocument.Content, Serializable
The positions tracking change are also generally cheap to maintain. The Position implementations (marks) store the array index and can easily calculate the sequential position from the current gap location. Changes only require updating the marks between the old and new gap boundaries when the gap is moved, so generally updating the marks is pretty cheap. The marks are stored sorted so they can be located quickly with a binary search. This increases the cost of adding a mark, and decreases the cost of keeping the mark updated.
Constructor | Description |
---|---|
GapContent() |
Creates a new GapContent object. |
GapContent |
Creates a new GapContent object, with the initial size specified. |
Modifier and Type | Method | Description |
---|---|---|
protected Object |
allocateArray |
Allocate an array to store items of the type appropriate (which is determined by the subclass). |
Position |
createPosition |
Creates a position within the content that will track change as the content is mutated. |
protected final Object |
getArray() |
Access to the array. |
protected int |
getArrayLength() |
Get the length of the allocated array. |
void |
getChars |
Retrieves a portion of the content. |
protected final int |
getGapEnd() |
Access to the end of the gap. |
protected final int |
getGapStart() |
Access to the start of the gap. |
protected Vector |
getPositionsInRange |
Returns a Vector containing instances of UndoPosRef for the Positions in the range offset to offset + length . |
String |
getString |
Retrieves a portion of the content. |
UndoableEdit |
insertString |
Inserts a string into the content. |
int |
length() |
Returns the length of the content. |
UndoableEdit |
remove |
Removes part of the content. |
protected void |
replace |
Replace the given logical position in the storage with the given new items. |
protected void |
resetMarksAtZero() |
Resets all the marks that have an offset of 0 to have an index of zero as well. |
protected void |
shiftEnd |
Make the gap bigger, moving any necessary data and updating the appropriate marks |
protected void |
shiftGap |
Move the start of the gap to a new location, without changing the size of the gap. |
protected void |
shiftGapEndUp |
Adjust the gap end upward. |
protected void |
shiftGapStartDown |
Adjust the gap end downward. |
protected void |
updateUndoPositions |
Resets the location for all the UndoPosRef instances in positions . |
public GapContent()
public GapContent(int initialLength)
initialLength
- the initial sizeprotected Object allocateArray(int len)
len
- the length of the arrayprotected int getArrayLength()
public int length()
length
in interface AbstractDocument.Content
public UndoableEdit insertString(int where, String str) throws BadLocationException
insertString
in interface AbstractDocument.Content
where
- the starting position >= 0, < length()str
- the non-null string to insertBadLocationException
- if the specified position is invalidpublic UndoableEdit remove(int where, int nitems) throws BadLocationException
remove
in interface AbstractDocument.Content
where
- the starting position >= 0, where + nitems < length()nitems
- the number of characters to remove >= 0BadLocationException
- if the specified position is invalidpublic String getString(int where, int len) throws BadLocationException
getString
in interface AbstractDocument.Content
where
- the starting position >= 0len
- the length to retrieve >= 0BadLocationException
- if the specified position is invalidpublic void getChars(int where, int len, Segment chars) throws BadLocationException
getChars
in interface AbstractDocument.Content
where
- the starting position >= 0, where + len <= length()len
- the number of characters to retrieve >= 0chars
- the Segment object to return the characters inBadLocationException
- if the specified position is invalidpublic Position createPosition(int offset) throws BadLocationException
createPosition
in interface AbstractDocument.Content
offset
- the offset to track >= 0BadLocationException
- if the specified position is invalidprotected void shiftEnd(int newSize)
newSize
- the new capacityprotected void shiftGap(int newGapStart)
newGapStart
- the new start of the gapprotected void resetMarksAtZero()
protected void shiftGapStartDown(int newGapStart)
newGapStart
- the new start of the gapprotected void shiftGapEndUp(int newGapEnd)
newGapEnd
- the new end of the gapprotected Vector getPositionsInRange(Vector v, int offset, int length)
offset
to offset
+ length
. If v
is not null the matching Positions are placed in there. The vector with the resulting Positions are returned.v
- the Vector to use, with a new one created on nulloffset
- the starting offset >= 0length
- the length >= 0protected void updateUndoPositions(Vector positions, int offset, int length)
positions
. This is meant for internal usage, and is generally not of interest to subclasses.
positions
- the UndoPosRef instances to resetoffset
- where the string was insertedlength
- length of inserted stringprotected final Object getArray()
protected final int getGapStart()
protected final int getGapEnd()
protected void replace(int position, int rmSize, Object addItems, int addSize)
position
- the location to make the replacement. This is not the location in the underlying storage array, but the location in the contiguous space being modeled.rmSize
- the number of items to removeaddItems
- the new items to place in storage.addSize
- the number of items to add
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/swing/text/GapContent.html