Set (TriActive Java Data Objects API)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.triactive.jdo.sco
Class Set

java.lang.Object
  com.triactive.jdo.sco.Set

All Implemented Interfaces:: java.lang.Cloneable, java.util.Collection, Queryable, SCO, java.util.Set

public class Set
extends java.lang.Object
implements java.util.Set, SCO, java.lang.Cloneable, Queryable

A set object which is backed "directly" by the database. SCO fields declared as type java.util.Collection or java.util.Set are populated with objects of this type whenever the field is actively being managed by the state manager.

This class differs from HashSet primarily in the fact that the contents of the set are not mirrored in memory. Operations on the set "pass through" directly to the database.

An instance of this class "disconnects" from it backing storage whenever unsetOwner() is called. This occurs automatically in a variety of scenarios, such as when the object is cloned or when its owning object (the one whose Set field refers to it) transitions to a transient state. When a disconnect occurs, the object switches to being backed by a normal in-memory HashSet and subsequently behaves like a normal HashSet. If the disconnect occurs during a transaction the contents of the set are fully loaded from the database. Subsequent changes to the set affect only the in-memory copy. Once disconnected from its owner, an instance is never reconnected.

Author:: Mike Martin

Constructor Summary
	`Set(StateManager ownerSM, java.lang.String fieldName)`
`(package private)`	`Set(StateManager ownerSM, java.lang.String fieldName, boolean allowNulls, SetStore setStore)`
	`Set(StateManager ownerSM, java.lang.String fieldName, java.lang.Class elementType, boolean allowNulls)`

Method Summary
`boolean`	`add(java.lang.Object element)`
`boolean`	`addAll(java.util.Collection c)`
`void`	`applyUpdates()` Applies any pending updates for this object to the data store.
`void`	`clear()`
`java.lang.Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`contains(java.lang.Object element)`
`boolean`	`containsAll(java.util.Collection c)`
`boolean`	`equals(java.lang.Object o)`
`java.lang.String`	`getFieldName()` Returns the field name.
`java.lang.Object`	`getOwner()` Returns the owner object of the SCO instance.
`int`	`hashCode()`
`boolean`	`isEmpty()`
`java.util.Iterator`	`iterator()`
`void`	`makeDirty()` Marks object dirty.
`QueryStatement`	`newQueryStatement()` Returns a prototypical query statement over the underlying collection.
`QueryStatement`	`newQueryStatement(java.lang.Class candidateClass)` Returns a prototypical query statement over the underlying collection, pre-filtered to include only objects of the specified class.
`Query.ResultObjectFactory`	`newResultObjectFactory(QueryStatement stmt)` Returns a suitable query result factory for results produced by the specified query.
`boolean`	`remove(java.lang.Object element)`
`boolean`	`removeAll(java.util.Collection c)`
`boolean`	`retainAll(java.util.Collection c)`
`void`	`setValueFrom(java.lang.Object o)` Assigns the value of this second-class object from an existing object of the same or compatible type.
`int`	`size()`
`java.lang.Object[]`	`toArray()`
`java.lang.Object[]`	`toArray(java.lang.Object[] a)`
`java.lang.String`	`toString()`
`void`	`unsetOwner()` Nullifies references to the owner Object and Field.

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Set

public Set(StateManager ownerSM,
           java.lang.String fieldName)

Set

public Set(StateManager ownerSM,
           java.lang.String fieldName,
           java.lang.Class elementType,
           boolean allowNulls)

Set

Set(StateManager ownerSM,
    java.lang.String fieldName,
    boolean allowNulls,
    SetStore setStore)

Method Detail