com.sk89q.worldedit.extent.cache

Class LastAccessExtentCache

java.lang.Object

com.sk89q.worldedit.extent.AbstractDelegateExtent

com.sk89q.worldedit.extent.cache.LastAccessExtentCache

All Implemented Interfaces:

Extent, InputExtent, OutputExtent

public class LastAccessExtentCache
extends AbstractDelegateExtent

Returns the same cached BaseBlock for repeated calls to getLazyBlock(Vector) with the same position.

Constructor Summary

Constructors

Constructor and Description
LastAccessExtentCache(Extent extent) Create a new instance.

Method Summary

Modifier and Type	Method and Description
BaseBlock	getLazyBlock(Vector position) Get a lazy, immutable snapshot of the block at the given location that only immediately contains information about the block's type (and metadata).

Methods inherited from class com.sk89q.worldedit.extent.AbstractDelegateExtent

commit, commitBefore, createEntity, getBiome, getBlock, getEntities, getEntities, getExtent, getMaximumPoint, getMinimumPoint, setBiome, setBlock

Methods inherited from class java.lang.Object

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

Constructor Detail

LastAccessExtentCache

public LastAccessExtentCache(Extent extent)

Create a new instance.

Parameters:

extent - the extent

Method Detail

getLazyBlock

public BaseBlock getLazyBlock(Vector position)

Description copied from interface: InputExtent

Get a lazy, immutable snapshot of the block at the given location that only immediately contains information about the block's type (and metadata).

Further information (such as NBT data) will be available by the time of access. Therefore, it is not recommended that this method is used if the world is being simulated at the time of call. If the block needs to be stored for future use, then this method should definitely not be used. Moreover, the block that is returned is immutable (or should be), and therefore modifications should not be attempted on it. If a modifiable copy is required, then the block should be cloned.

This method exists because it is sometimes important to inspect the block at a given location, but InputExtent.getBlock(Vector) may be too expensive in the underlying implementation. It is also not possible to implement caching if the returned object is mutable, so this methods allows caching implementations to be used.

Specified by:

getLazyBlock in interface InputExtent

Overrides:

getLazyBlock in class AbstractDelegateExtent

Parameters:

position - position of the block

Returns:

the block