org.htmlunit.corejs.javascript

Class CompoundOperationMap

java.lang.Object

org.htmlunit.corejs.javascript.CompoundOperationMap

All Implemented Interfaces:

AutoCloseable, Iterable<Slot>, SlotMap

public class CompoundOperationMap
extends Object
implements SlotMap, AutoCloseable

This class represents a compound operation performed on a non-thread safe map. As such it does the minimum work possible and does not enforce locking, instead it simply records whether the map has been mutated as part of the operation to allow the underlying map to delegate operations as required.

Nested Class Summary

Nested classes/interfaces inherited from interface org.htmlunit.corejs.javascript.SlotMap

SlotMap.SlotComputer<S extends Slot>

Field Summary

Fields

Modifier and Type	Field and Description
protected SlotMap	map
protected SlotMapOwner	owner

Constructor Summary

Constructors

Constructor and Description
CompoundOperationMap(SlotMapOwner owner)

Method Summary

Modifier and Type	Method and Description
void	add(SlotMapOwner owner, Slot newSlot) Insert a new slot to the map.
void	close()
<S extends Slot> S	compute(SlotMapOwner owner, CompoundOperationMap compoundOp, Object key, int index, SlotMap.SlotComputer<S> compute)
<S extends Slot> S	compute(SlotMapOwner owner, Object key, int index, SlotMap.SlotComputer<S> compute) Replace the value of key with the slot computed by the "compute" method.
int	dirtySize()
boolean	isEmpty() Return whether the map is empty.
boolean	isTouched()
Iterator<Slot>	iterator()
Slot	modify(SlotMapOwner owner, Object key, int index, int attributes) Return the Slot that matches EITHER "key" or "index".
Slot	query(Object key, int index) Retrieve the slot at EITHER key or index, or return null if the slot cannot be found.
int	size() Return the size of the map.
protected void	updateMap(boolean resetTouched)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.htmlunit.corejs.javascript.SlotMap

startCompoundOp

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

owner

protected final SlotMapOwner owner

map

protected SlotMap map

Constructor Detail

CompoundOperationMap

public CompoundOperationMap(SlotMapOwner owner)

Method Detail

updateMap

protected void updateMap(boolean resetTouched)

isTouched

public boolean isTouched()

add

public void add(SlotMapOwner owner,
                Slot newSlot)

Description copied from interface: SlotMap

Insert a new slot to the map. Both "name" and "indexOrHash" must be populated. Note that ScriptableObject generally adds slots via the "modify" method.

Specified by:

add in interface SlotMap

compute

public <S extends Slot> S compute(SlotMapOwner owner,
                                  Object key,
                                  int index,
                                  SlotMap.SlotComputer<S> compute)

Description copied from interface: SlotMap

Replace the value of key with the slot computed by the "compute" method. If "compute" throws an exception, make no change. If "compute" returns null, remove the mapping, otherwise, replace any existing mapping with the result of "compute", and create a new mapping if none exists. This is equivalent to the "compute" method on the Map interface, which simplifies code and is more efficient than making multiple calls to this interface. In order to allow use of multiple Slot subclasses, this function is templatized.

Specified by:

compute in interface SlotMap

compute

public <S extends Slot> S compute(SlotMapOwner owner,
                                  CompoundOperationMap compoundOp,
                                  Object key,
                                  int index,
                                  SlotMap.SlotComputer<S> compute)

Specified by:

compute in interface SlotMap

dirtySize

public int dirtySize()

Specified by:

dirtySize in interface SlotMap

isEmpty

public boolean isEmpty()

Description copied from interface: SlotMap

Return whether the map is empty.

Specified by:

isEmpty in interface SlotMap

modify

public Slot modify(SlotMapOwner owner,
                   Object key,
                   int index,
                   int attributes)

Description copied from interface: SlotMap

Return the Slot that matches EITHER "key" or "index". (It will use "key" if it is not null, and otherwise "index".) If no slot exists, then create a default slot class.

Specified by:

modify in interface SlotMap

key - The key for the slot, which should be a String or a Symbol.

index - if key is zero, then this will be used as the key instead.

attributes - the attributes to be set on the slot if a new slot is created. Existing slots will not be modified.

Returns:

a Slot, which will be created anew if no such slot exists.

query

public Slot query(Object key,
                  int index)

Description copied from interface: SlotMap

Retrieve the slot at EITHER key or index, or return null if the slot cannot be found.

Specified by:

query in interface SlotMap

Parameters:

key - The key for the slot, which should be a String or a Symbol.

index - if key is zero, then this will be used as the key instead.

Returns:

either the Slot that matched the key and index, or null

size

public int size()

Description copied from interface: SlotMap

Return the size of the map.

Specified by:

size in interface SlotMap

iterator

public Iterator<Slot> iterator()

Specified by:

iterator in interface Iterable<Slot>

close

public void close()

Specified by:

close in interface AutoCloseable