ORidBag (OrientDB 2.2.37 API)

java.lang.Object
- com.orientechnologies.orient.core.db.record.ridbag.ORidBag

All Implemented Interfaces:

OCollection<OIdentifiable>, OSizeable, OAutoConvertToRecord, ODetachable, ORecordLazyMultiValue, OTrackedMultiValue<OIdentifiable,OIdentifiable>, OStringBuilderSerializable, Iterable<OIdentifiable>
```
public class ORidBag
extends Object
implements OStringBuilderSerializable, Iterable<OIdentifiable>, ORecordLazyMultiValue, OTrackedMultiValue<OIdentifiable,OIdentifiable>, OCollection<OIdentifiable>
```
A collection that contain links to OIdentifiable. Bag is similar to set but can contain several entering of the same object.

Could be tree based and embedded representation.
- Embedded stores its content directly to the document that owns it.
  It better fits for cases when only small amount of links are stored to the bag.
- Tree-based implementation stores its content in a separate data structure called OSBTreeBonsai.
  It fits great for cases when you have a huge amount of links.
The representation is automatically converted to tree-based implementation when top threshold is reached. And backward to embedded one when size is decreased to bottom threshold.
The thresholds could be configured by OGlobalConfiguration.RID_BAG_EMBEDDED_TO_SBTREEBONSAI_THRESHOLD and OGlobalConfiguration.RID_BAG_SBTREEBONSAI_TO_EMBEDDED_THRESHOLD.

This collection is used to efficiently manage relationships in graph model.

Does not implement Collection interface because some operations could not be efficiently implemented and that's why should be avoided.
Since:

1.7rc1

Author:

Artem Orobets (enisher-at-gmail.com), Andrey Lomakin

Constructor Summary

Constructors
Constructor and Description

ORidBag()

ORidBag(int iTopThreshold, int iBottomThreshold)

ORidBag(ORidBag ridBag)

Constructors
Constructor and Description
`ORidBag()`
`ORidBag(int iTopThreshold, int iBottomThreshold)`
`ORidBag(ORidBag ridBag)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`add(OIdentifiable identifiable)`
`void`	`addAll(Collection<OIdentifiable> values)`
`void`	`addChangeListener(OMultiValueChangeListener<OIdentifiable,OIdentifiable> changeListener)` Add change listener.
`void`	`checkAndConvert()`
`boolean`	`contains(OIdentifiable identifiable)` THIS IS VERY EXPENSIVE METHOD AND CAN NOT BE CALLED IN REMOTE STORAGE.
`void`	`convertLinks2Records()` Browse all the set to convert all the items into records.
`boolean`	`convertRecords2Links()` Browse all the set to convert all the items into links.
`ORidBag`	`copy()`
`void`	`debugPrint(PrintStream writer)`
`void`	`delete()`
`boolean`	`detach()` Detaches the object.
`void`	`fireCollectionChangedEvent(OMultiValueChangeEvent<OIdentifiable,OIdentifiable> event)`
`void`	`fromStream(byte[] stream)`
`void`	`fromStream(BytesContainer stream)`
`static ORidBag`	`fromStream(String value)`
`OStringBuilderSerializable`	`fromStream(StringBuilder input)`
`protected ORidBagDelegate`	`getDelegate()`
`Class<?>`	`getGenericClass()`
`OBonsaiCollectionPointer`	`getPointer()`
`UUID`	`getTemporaryId()` Temporary id of collection to track changes in remote mode.
`protected void`	`init()`
`boolean`	`isAutoConvertToRecord()`
`boolean`	`isEmbedded()`
`boolean`	`isEmpty()`
`Iterator<OIdentifiable>`	`iterator()`
`void`	`notifySaved(OBonsaiCollectionPointer newPointer)` Notify collection that changes has been saved.
`Iterator<OIdentifiable>`	`rawIterator()`
`void`	`remove(OIdentifiable identifiable)`
`void`	`removeRecordChangeListener(OMultiValueChangeListener<OIdentifiable,OIdentifiable> changeListener)` Remove change listener.
`void`	`replace(OMultiValueChangeEvent<Object,Object> event, Object newValue)`
`Object`	`returnOriginalState(List<OMultiValueChangeEvent<OIdentifiable,OIdentifiable>> multiValueChangeEvents)` Reverts all operations that were performed on collection and return original collection state.
`void`	`setAutoConvertToRecord(boolean convertToRecord)`
`void`	`setOwner(ORecord owner)`
`int`	`size()`
`int`	`toStream(BytesContainer bytesContainer)`
`OStringBuilderSerializable`	`toStream(StringBuilder output)`
`String`	`toString()`
`boolean`	`tryMerge(ORidBag otherValue, boolean iMergeSingleItemsOfMultiValueFields)` IMPORTANT! Only for internal usage.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable
forEach, spliterator

- Constructor Detail
  - ORidBag
```
public ORidBag(ORidBag ridBag)
```
  - ORidBag
```
public ORidBag()
```
  - ORidBag
```
public ORidBag(int iTopThreshold,
               int iBottomThreshold)
```
- Method Detail
  - fromStream
```
public static ORidBag fromStream(String value)
```
  - copy
```
public ORidBag copy()
```
  - contains
```
public boolean contains(OIdentifiable identifiable)
```
    THIS IS VERY EXPENSIVE METHOD AND CAN NOT BE CALLED IN REMOTE STORAGE.
    
    Parameters:
    
    identifiable - Object to check.
    
    Returns:
    
    true if ridbag contains at leas one instance with the same rid as passed in identifiable.
  - addAll
```
public void addAll(Collection<OIdentifiable> values)
```
  - add
```
public void add(OIdentifiable identifiable)
```
    Specified by:
    
    add in interface OCollection<OIdentifiable>
  - remove
```
public void remove(OIdentifiable identifiable)
```
    Specified by:
    
    remove in interface OCollection<OIdentifiable>
  - isEmpty
```
public boolean isEmpty()
```
  - iterator
```
public Iterator<OIdentifiable> iterator()
```
    Specified by:
    
    iterator in interface Iterable<OIdentifiable>
  - rawIterator
```
public Iterator<OIdentifiable> rawIterator()
```
    Specified by:
    
    rawIterator in interface ORecordLazyMultiValue
  - convertLinks2Records
```
public void convertLinks2Records()
```
    Description copied from interface: ORecordLazyMultiValue
    
    Browse all the set to convert all the items into records. It converts only items that already loaded into memory from storage. To convert records that will be fetched from disk later use OAutoConvertToRecord.setAutoConvertToRecord(boolean)
    
    Specified by:
    
    convertLinks2Records in interface ORecordLazyMultiValue
  - convertRecords2Links
```
public boolean convertRecords2Links()
```
    Description copied from interface: ORecordLazyMultiValue
    
    Browse all the set to convert all the items into links.
    
    Specified by:
    
    convertRecords2Links in interface ORecordLazyMultiValue
    
    Returns:
  - isAutoConvertToRecord
```
public boolean isAutoConvertToRecord()
```
    Specified by:
    
    isAutoConvertToRecord in interface OAutoConvertToRecord
  - setAutoConvertToRecord
```
public void setAutoConvertToRecord(boolean convertToRecord)
```
    Specified by:
    
    setAutoConvertToRecord in interface OAutoConvertToRecord
  - detach
```
public boolean detach()
```
    Description copied from interface: ODetachable
    
    Detaches the object.
    
    Specified by:
    
    detach in interface ODetachable
    
    Returns:
    
    true if the object has been fully detached, otherwise false
  - size
```
public int size()
```
    Specified by:
    
    size in interface OSizeable
  - isEmbedded
```
public boolean isEmbedded()
```
  - toStream
```
public int toStream(BytesContainer bytesContainer)
             throws OSerializationException
```
    Throws:
    
    OSerializationException
  - checkAndConvert
```
public void checkAndConvert()
```
  - toStream
```
public OStringBuilderSerializable toStream(StringBuilder output)
                                    throws OSerializationException
```
    Specified by:
    
    toStream in interface OStringBuilderSerializable
    
    Throws:
    
    OSerializationException
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - delete
```
public void delete()
```
  - fromStream
```
public OStringBuilderSerializable fromStream(StringBuilder input)
                                      throws OSerializationException
```
    Specified by:
    
    fromStream in interface OStringBuilderSerializable
    
    Throws:
    
    OSerializationException
  - fromStream
```
public void fromStream(byte[] stream)
```
  - fromStream
```
public void fromStream(BytesContainer stream)
```
  - addChangeListener
```
public void addChangeListener(OMultiValueChangeListener<OIdentifiable,OIdentifiable> changeListener)
```
    Description copied from interface: OTrackedMultiValue
    
    Add change listener.
    
    Specified by:
    
    addChangeListener in interface OTrackedMultiValue<OIdentifiable,OIdentifiable>
    
    Parameters:
    
    changeListener - Change listener instance.
  - removeRecordChangeListener
```
public void removeRecordChangeListener(OMultiValueChangeListener<OIdentifiable,OIdentifiable> changeListener)
```
    Description copied from interface: OTrackedMultiValue
    
    Remove change listener.
    
    Specified by:
    
    removeRecordChangeListener in interface OTrackedMultiValue<OIdentifiable,OIdentifiable>
    
    Parameters:
    
    changeListener - Change listener instance.
  - returnOriginalState
```
public Object returnOriginalState(List<OMultiValueChangeEvent<OIdentifiable,OIdentifiable>> multiValueChangeEvents)
```
    Description copied from interface: OTrackedMultiValue
    
    Reverts all operations that were performed on collection and return original collection state.
    
    Specified by:
    
    returnOriginalState in interface OTrackedMultiValue<OIdentifiable,OIdentifiable>
    
    Parameters:
    
    multiValueChangeEvents - List of operations that were performed on collection.
    
    Returns:
    
    Original collection state.
  - getGenericClass
```
public Class<?> getGenericClass()
```
    Specified by:
    
    getGenericClass in interface OTrackedMultiValue<OIdentifiable,OIdentifiable>
  - setOwner
```
public void setOwner(ORecord owner)
```
  - getTemporaryId
```
public UUID getTemporaryId()
```
    Temporary id of collection to track changes in remote mode.
    WARNING! Method is for internal usage.
    
    Returns:
    
    UUID
  - notifySaved
```
public void notifySaved(OBonsaiCollectionPointer newPointer)
```
    Notify collection that changes has been saved. Converts to non embedded implementation if needed.
    WARNING! Method is for internal usage.
    
    Parameters:
    
    newPointer - new collection pointer
  - getPointer
```
public OBonsaiCollectionPointer getPointer()
```
  - tryMerge
```
public boolean tryMerge(ORidBag otherValue,
                        boolean iMergeSingleItemsOfMultiValueFields)
```
    IMPORTANT! Only for internal usage.
  - init
```
protected void init()
```
  - debugPrint
```
public void debugPrint(PrintStream writer)
                throws IOException
```
    Throws:
    
    IOException
  - getDelegate
```
protected ORidBagDelegate getDelegate()
```
  - fireCollectionChangedEvent
```
public void fireCollectionChangedEvent(OMultiValueChangeEvent<OIdentifiable,OIdentifiable> event)
```
    Specified by:
    
    fireCollectionChangedEvent in interface OTrackedMultiValue<OIdentifiable,OIdentifiable>
  - replace
```
public void replace(OMultiValueChangeEvent<Object,Object> event,
                    Object newValue)
```
    Specified by:
    
    replace in interface OTrackedMultiValue<OIdentifiable,OIdentifiable>

Class ORidBag

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface java.lang.Iterable

Constructor Detail

ORidBag

ORidBag

ORidBag

Method Detail

fromStream

copy

contains

addAll

add

remove

isEmpty

iterator

rawIterator

convertLinks2Records

convertRecords2Links

isAutoConvertToRecord

setAutoConvertToRecord

detach

size

isEmbedded

toStream

checkAndConvert

toStream

toString

delete

fromStream

fromStream

fromStream

addChangeListener

removeRecordChangeListener

returnOriginalState

getGenericClass

setOwner

getTemporaryId

notifySaved

getPointer

tryMerge

init

debugPrint

getDelegate

fireCollectionChangedEvent

replace