Apache Derby Database Engine and Embedded JDBC Driver 10.17.1.0 · org.apache.derby.impl.store.raw.data.AllocExtent

Field Summary

Modifier and Type	Field and Description
private static final int	ALL_FREE
protected static final int	ALLOCATED_PAGE public Per Page status
protected static final int	DEALLOCATED_PAGE
private long	extentEnd
private int	extentLength
private long	extentOffset
private long	extentStart
pack-priv int	extentStatus
protected static final int	FREE_PAGE
pack-priv FormatableBitSet	freePages
private static final int	HAS_DEALLOCATED
private static final int	HAS_FREE
private static final int	HAS_UNFILLED_PAGES
private static final int	KEEP_UNFILLED_PAGES
private static final int	NO_DEALLOC_PAGE_MAP
private int	preAllocLength
private int	reserved1
private long	reserved2
private long	reserved3
private static final int	RETIRED
pack-priv FormatableBitSet	unFilledPages

Constructor Summary

Access	Constructor and Description
protected	AllocExtent(long offset, long start, int length, int pagesize, int maxlength)
protected	AllocExtent(AllocExtent original)
public	AllocExtent()

Method Summary

Modifier and Type	Method and Description
protected void	allocPage(long pagenum) Allocate this page - this is called underneath the log record
protected boolean	canAddFreePage(long lastAllocatedPage)
private void	checkInRange(long pagenum)
protected int	Returns: Return bit of page where all pages that follow can be returned to the OS. compress(BaseContainerHandle owner, RawTransaction ntt, AllocPage alloc_page) Compress free pages at end of this extent.
protected void	compressPages(int new_highest_page, int num_pages_truncated)
protected void	deallocPage(long pagenum) Deallocate logical page pagenum - this is called underneath the log record.
protected int	getAllocatedPageCount() Get the number of used page in this extent
protected long	getExtentEnd()
protected long	getFirstPagenum() Get the first logical page number managed by this extent.
protected long	getFreePageNumber(long pnum) Get a page number that is free
protected long	getLastPagenum() Get the last logical page number managed by this extent.
protected long	getLastPreallocPagenum() get the last preallocated pagenumber managed by this alloc page
protected long	getLastValidPageNumber()
protected long	getNextValidPageNumber(long prevPageNumber)
protected long	Returns: The page number of this "bit" in the extent map. getPagenum(int bit_pos) translate bit position in map to page number.
protected long	getPageOffset(long pagenum, int pagesize, boolean deallocOK) Get the physical offset of pagenum.
protected int	getPageStatus(long pagenum) Return the status of a particular page
protected int	getTotalPageCount() Get the total number of pages in this extent
protected int	getUnfilledPageCount() Get the number of unfilled pages in this extent
protected long	getUnfilledPageNumber(long pagenum) Get a page number that is unfilled, pagenum is the last page that was rejected.
protected boolean	isRetired() Return the status of this extent
protected static int	MAX_RANGE(int availspace) Statically calculates how many pages this extent can manage given the availspace number of bytes to store this extent in if read/writeExternal changes, this must change too
private boolean	mayHaveFreePage()
public void	readExternal(ObjectInput the stream to read data from in order to restore the object in) Implements java.io.Externalizable.readExternal. The object implements the readExternal method to restore its contents by calling the methods of DataInput for primitive types and readObject for objects, strings and arrays.
private void	setExtentFreePageStatus(boolean hasFree)
protected void	setLastPreallocPagenum(long preAllocPagenum) preallocated N pages, passed in the last preallocated page number.
protected String	toDebugString()
protected boolean	trackUnfilledPage(long pagenumber, boolean unfilled)
protected void	undoCompressPages(int new_highest_page, int num_pages_truncated) Undo the compress space operation.
protected void	updateUnfilledPageInfo(AllocExtent inputExtent)
public void	writeExternal(ObjectOutput the stream to write the object to out) Implements java.io.Externalizable.writeExternal. The object implements the writeExternal method to save its contents by calling the methods of DataOutput for its primitive values or calling the writeObject method of ObjectOutput for objects, strings, and arrays.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

ALL_FREE	back to summary
private static final int ALL_FREE

ALLOCATED_PAGE	back to summary
protected static final int ALLOCATED_PAGE public Per Page status

DEALLOCATED_PAGE	back to summary
protected static final int DEALLOCATED_PAGE

extentEnd	back to summary
private long extentEnd

extentLength	back to summary
private int extentLength

extentOffset	back to summary
private long extentOffset

extentStart	back to summary
private long extentStart

extentStatus	back to summary
pack-priv int extentStatus

FREE_PAGE	back to summary
protected static final int FREE_PAGE

freePages	back to summary
pack-priv FormatableBitSet freePages

HAS_DEALLOCATED	back to summary
private static final int HAS_DEALLOCATED

HAS_FREE	back to summary
private static final int HAS_FREE

HAS_UNFILLED_PAGES	back to summary
private static final int HAS_UNFILLED_PAGES

KEEP_UNFILLED_PAGES	back to summary
private static final int KEEP_UNFILLED_PAGES

NO_DEALLOC_PAGE_MAP	back to summary
private static final int NO_DEALLOC_PAGE_MAP

preAllocLength	back to summary
private int preAllocLength

reserved1	back to summary
private int reserved1

reserved2	back to summary
private long reserved2

reserved3	back to summary
private long reserved3

RETIRED	back to summary
private static final int RETIRED

unFilledPages	back to summary
pack-priv FormatableBitSet unFilledPages

Constructor Detail

AllocExtent	back to summary
protected AllocExtent(long offset, long start, int length, int pagesize, int maxlength)

AllocExtent	back to summary
protected AllocExtent(AllocExtent original)

AllocExtent	back to summary
public AllocExtent()

Method Detail

allocPage	back to summary
protected void allocPage(long pagenum) throws StandardException Allocate this page - this is called underneath the log record Exceptions StandardException: Standard Derby error policy

allocPage

back to summary

protected void allocPage(long pagenum) throws StandardException

Allocate this page - this is called underneath the log record

Exceptions

StandardException:: Standard Derby error policy

canAddFreePage	back to summary
protected boolean canAddFreePage(long lastAllocatedPage)

checkInRange	back to summary
private void checkInRange(long pagenum)

compress	back to summary
protected int compress(BaseContainerHandle owner, RawTransaction ntt, AllocPage alloc_page) throws StandardException Compress free pages at end of this extent. Search backward from end of extent and prepare data structures to return pages at end of extent to the OS. Returns the lowest page that can be returned to the OS. Returns:int Return bit of page where all pages that follow can be returned to the OS.

compressPages	back to summary
protected void compressPages(int new_highest_page, int num_pages_truncated)

deallocPage	back to summary
protected void deallocPage(long pagenum) throws StandardException Deallocate logical page pagenum - this is called underneath the log record. pagenum must be a page managed by this extent and it must be valid Exceptions StandardException: Standard Derby error policy

deallocPage

back to summary

protected void deallocPage(long pagenum) throws StandardException

Deallocate logical page pagenum - this is called underneath the log record. pagenum must be a page managed by this extent and it must be valid

Exceptions

StandardException:: Standard Derby error policy

getAllocatedPageCount	back to summary
protected int getAllocatedPageCount() Get the number of used page in this extent

getExtentEnd	back to summary
protected long getExtentEnd()

getFirstPagenum	back to summary
protected long getFirstPagenum() Get the first logical page number managed by this extent.

getFreePageNumber	back to summary
protected long getFreePageNumber(long pnum) Get a page number that is free

getLastPagenum	back to summary
protected long getLastPagenum() Get the last logical page number managed by this extent.

getLastPreallocPagenum	back to summary
protected long getLastPreallocPagenum() get the last preallocated pagenumber managed by this alloc page

getLastValidPageNumber	back to summary
protected long getLastValidPageNumber()

getNextValidPageNumber	back to summary
protected long getNextValidPageNumber(long prevPageNumber)

getPagenum	back to summary
protected long getPagenum(int bit_pos) translate bit position in map to page number. Returns:long The page number of this "bit" in the extent map.

getPagenum

back to summary

protected long getPagenum(int bit_pos)

translate bit position in map to page number.

Returns:long: The page number of this "bit" in the extent map.

getPageOffset	back to summary
protected long getPageOffset(long pagenum, int pagesize, boolean deallocOK) throws StandardException Get the physical offset of pagenum. If deallocOK is true, then even if pagenum is deallocated, it is OK. If deallocOK is false, then an exception is thrown if pagenum is deallocated. An exception is always thrown if pagenum is a free page Exceptions StandardException: Standard Derby error policy

getPageOffset

back to summary

protected long getPageOffset(long pagenum, int pagesize, boolean deallocOK) throws StandardException

Get the physical offset of pagenum. If deallocOK is true, then even if pagenum is deallocated, it is OK. If deallocOK is false, then an exception is thrown if pagenum is deallocated. An exception is always thrown if pagenum is a free page

Exceptions

StandardException:: Standard Derby error policy

getPageStatus	back to summary
protected int getPageStatus(long pagenum) Return the status of a particular page

getTotalPageCount	back to summary
protected int getTotalPageCount() Get the total number of pages in this extent

getUnfilledPageCount	back to summary
protected int getUnfilledPageCount() Get the number of unfilled pages in this extent

getUnfilledPageNumber	back to summary
protected long getUnfilledPageNumber(long pagenum) Get a page number that is unfilled, pagenum is the last page that was rejected.

isRetired	back to summary
protected boolean isRetired() Return the status of this extent

MAX_RANGE	back to summary
protected static int MAX_RANGE(int availspace) Statically calculates how many pages this extent can manage given the availspace number of bytes to store this extent in if read/writeExternal changes, this must change too

mayHaveFreePage	back to summary
private boolean mayHaveFreePage()

readExternal

back to summary

public void readExternal(ObjectInput in) throws IOException, ClassNotFoundException

Implements java.io.Externalizable.readExternal.

Doc from java.io.Externalizable.readExternal.

The object implements the readExternal method to restore its contents by calling the methods of DataInput for primitive types and readObject for objects, strings and arrays. The readExternal method must read the values in the same sequence and with the same types as were written by writeExternal.

Parameters

in:ObjectInput: the stream to read data from in order to restore the object

Exceptions

IOException:: if I/O errors occur
ClassNotFoundException:: If the class for an object being restored cannot be found.

setExtentFreePageStatus	back to summary
private void setExtentFreePageStatus(boolean hasFree)

setLastPreallocPagenum	back to summary
protected void setLastPreallocPagenum(long preAllocPagenum) preallocated N pages, passed in the last preallocated page number.

toDebugString	back to summary
protected String toDebugString()

trackUnfilledPage	back to summary
protected boolean trackUnfilledPage(long pagenumber, boolean unfilled)

undoCompressPages

back to summary

protected void undoCompressPages(int new_highest_page, int num_pages_truncated)

Undo the compress space operation.

Undo of this operation doesn't really "undo" the operation, it just makes sure the data structures are ok after the undo. We are guaranteed at the point of the transaction doing the Undo of the compress space operation fixes up the bit maps to only point at pages within the new_highest_page range.

Prior to logging the compress space operation all pages greater than There are only 2 possibilities at this point: 1) the truncate of pages greater than new_highest_page happened before the abort took place. W 2)

updateUnfilledPageInfo	back to summary
protected void updateUnfilledPageInfo(AllocExtent inputExtent)

writeExternal

back to summary

public void writeExternal(ObjectOutput out) throws IOException

Implements java.io.Externalizable.writeExternal.

Doc from java.io.Externalizable.writeExternal.

The object implements the writeExternal method to save its contents by calling the methods of DataOutput for its primitive values or calling the writeObject method of ObjectOutput for objects, strings, and arrays.

Parameters

out:ObjectOutput: the stream to write the object to

Exceptions

IOException:: Includes any I/O exceptions that may occur

public Class AllocExtent

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail