Package org.apache.ofbiz.entity

Class GenericValue

java.lang.Object

org.apache.ofbiz.entity.GenericEntity

org.apache.ofbiz.entity.GenericValue

All Implemented Interfaces:

Serializable, Cloneable, Comparable<GenericEntity>, Map<String,Object>, LocalizedMap<Object>

Direct Known Subclasses:

GenericValue.NullGenericValue

public class GenericValue
extends GenericEntity

Generic Entity Value Object - Handles persistence for any defined entity.

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	GenericValue.NullGenericValue

Nested classes/interfaces inherited from class org.apache.ofbiz.entity.GenericEntity

GenericEntity.NULL, GenericEntity.NullField, GenericEntity.NullGenericEntity

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K extends Object,V extends Object>

Field Summary

Fields

Modifier and Type	Field	Description
static final GenericValue	NULL_VALUE

Fields inherited from class org.apache.ofbiz.entity.GenericEntity

NULL_ENTITY, NULL_FIELD

Constructor Summary

Constructors

Constructor	Description
GenericValue()

Method Summary

Modifier and Type	Method	Description
Object	clone()	Clones this GenericValue, this is a shallow clone and uses the default shallow HashMap clone
GenericValue	create()	Creates new GenericValue from existing GenericValue
static GenericValue	create(Delegator delegator, ModelEntity modelEntity, Object singlePkValue)	Creates new GenericValue from existing Map
static GenericValue	create(Delegator delegator, ModelEntity modelEntity, Map<String,? extends Object> fields)	Creates new GenericValue from existing Map
static GenericValue	create(GenericPK primaryKey)	Creates new GenericValue from existing GenericValue
static GenericValue	create(GenericValue value)	Creates new GenericValue from existing GenericValue
static GenericValue	create(ModelEntity modelEntity)	Creates new GenericValue
boolean	equals(Object obj)	equals
List<GenericValue>	getRelated(String relationName)	Deprecated. use getRelated(String, Map, List, boolean)
List<GenericValue>	getRelated(String relationName, List<String> orderBy)	Deprecated. use getRelated(String, Map, List, boolean)
List<GenericValue>	getRelated(String relationName, Map<String,? extends Object> byAndFields, List<String> orderBy)	Deprecated. use getRelated(String, Map, List, boolean)
List<GenericValue>	getRelated(String relationName, Map<String,? extends Object> byAndFields, List<String> orderBy, boolean useCache)	Get the named Related Entity for the GenericValue from the persistent store
GenericPK	getRelatedDummyPK(String relationName)	Get a dummy primary key for the named Related Entity for the GenericValue
GenericPK	getRelatedDummyPK(String relationName, Map<String,? extends Object> byAndFields)	Get a dummy primary key for the named Related Entity for the GenericValue
List<GenericValue>	getRelatedMulti(String relationNameOne, String relationNameTwo)	Get the named Related Entity for the GenericValue from the persistent store across another Relation.
List<GenericValue>	getRelatedMulti(String relationNameOne, String relationNameTwo, List<String> orderBy)	Get the named Related Entity for the GenericValue from the persistent store across another Relation.
GenericValue	getRelatedOne(String relationName)	Deprecated. use getRelatedOne(String, boolean)
GenericValue	getRelatedOne(String relationName, boolean useCache)	Get the named Related Entity for the GenericValue from the persistent store
static String	getStackTraceAsString()
int	hashCode()	hash code
void	refresh()	refresh
void	refreshFromCache()	refresh from cache
void	remove()	remove
void	removeRelated(String relationName)	Remove the named Related Entity for the GenericValue from the persistent store
void	store()	store

Methods inherited from class org.apache.ofbiz.entity.GenericEntity

addObserver, addToXmlDocument, addToXmlElement, assertIsMutable, checkFks, clear, clearChanged, compareTo, compareToFields, containsKey, containsPrimaryKey, containsPrimaryKey, containsValue, createGenericEntity, createGenericEntity, createGenericEntity, dangerousGetNoCheckButFast, dangerousSetNoCheckButFast, deleteObserver, deleteObservers, entrySet, get, get, get, get, getAllFields, getAllKeys, getBigDecimal, getBoolean, getBytes, getDate, getDelegator, getDouble, getDuration, getEntityName, getFields, getFloat, getInteger, getIsFromEntitySync, getLong, getModelEntity, getOriginalDbValue, getPkShortValueString, getPrimaryKey, getString, getTime, getTimestamp, hasChanged, init, init, init, init, isEmpty, isModified, isMutable, isPrimaryKey, isPrimaryKey, keySet, lockEnabled, makeXmlDocument, makeXmlElement, makeXmlElement, matches, matchesFields, notifyObservers, notifyObservers, originalDbValuesAvailable, put, putAll, refreshFromValue, remove, removedFromDatasource, reset, set, set, setAllFields, setBytes, setChanged, setDelegator, setFields, setImmutable, setIsFromEntitySync, setNextSeqId, setNonPKFields, setNonPKFields, setPKFields, setPKFields, setString, size, synchronizedWithDatasource, toString, toStringInsecure, values, writeXmlText

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

Field Details

NULL_VALUE

public static final GenericValue NULL_VALUE

Constructor Details

GenericValue

public GenericValue()

Method Details

create

public static GenericValue create(ModelEntity modelEntity)

Creates new GenericValue

create

public static GenericValue create(Delegator delegator,
 ModelEntity modelEntity,
 Map<String,? extends Object> fields)

Creates new GenericValue from existing Map

create

public static GenericValue create(Delegator delegator,
 ModelEntity modelEntity,
 Object singlePkValue)

Creates new GenericValue from existing Map

create

public static GenericValue create(GenericValue value)

Creates new GenericValue from existing GenericValue

create

public static GenericValue create(GenericPK primaryKey)

Creates new GenericValue from existing GenericValue

create

public GenericValue create()
                    throws GenericEntityException

Creates new GenericValue from existing GenericValue

Throws:

GenericEntityException

store

public void store()
           throws GenericEntityException

store

Throws:

GenericEntityException

remove

public void remove()
            throws GenericEntityException

remove

Throws:

GenericEntityException

refresh

public void refresh()
             throws GenericEntityException

refresh

Throws:

GenericEntityException

refreshFromCache

public void refreshFromCache()
                      throws GenericEntityException

refresh from cache

Throws:

GenericEntityException

getRelated

@Deprecated
public List<GenericValue> getRelated(String relationName)
                              throws GenericEntityException

Deprecated.

use getRelated(String, Map, List, boolean)

Get the named Related Entity for the GenericValue from the persistent store

Parameters:

relationName - String containing the relation name which is the combination of relation.title and relation.rel-entity-name as specified in the entity XML definition file

Returns:

List of GenericValue instances as specified in the relation definition

Throws:

GenericEntityException

getRelated

@Deprecated
public List<GenericValue> getRelated(String relationName,
 List<String> orderBy)
                              throws GenericEntityException

Deprecated.

use getRelated(String, Map, List, boolean)

Get the named Related Entity for the GenericValue from the persistent store

Parameters:

relationName - String containing the relation name which is the combination of relation.title and relation.rel-entity-name as specified in the entity XML definition file

orderBy - The fields of the named entity to order the query by; may be null; optionally add a " ASC" for ascending or " DESC" for descending

Returns:

List of GenericValue instances as specified in the relation definition

Throws:

GenericEntityException

getRelated

@Deprecated
public List<GenericValue> getRelated(String relationName,
 Map<String,? extends Object> byAndFields,
 List<String> orderBy)
                              throws GenericEntityException

Deprecated.

use getRelated(String, Map, List, boolean)

Get the named Related Entity for the GenericValue from the persistent store

Parameters:

relationName - String containing the relation name which is the combination of relation.title and relation.rel-entity-name as specified in the entity XML definition file

byAndFields - the fields that must equal in order to keep; may be null

orderBy - The fields of the named entity to order the query by; may be null; optionally add a " ASC" for ascending or " DESC" for descending

Returns:

List of GenericValue instances as specified in the relation definition

Throws:

GenericEntityException

getRelated

public List<GenericValue> getRelated(String relationName,
 Map<String,? extends Object> byAndFields,
 List<String> orderBy,
 boolean useCache)
                              throws GenericEntityException

Get the named Related Entity for the GenericValue from the persistent store

Parameters:

relationName - String containing the relation name which is the combination of relation.title and relation.rel-entity-name as specified in the entity XML definition file

byAndFields - the fields that must equal in order to keep; may be null

orderBy - The fields of the named entity to order the query by; may be null; optionally add a " ASC" for ascending or " DESC" for descending

useCache - Whether to cache the results

Returns:

List of GenericValue instances as specified in the relation definition

Throws:

GenericEntityException

getRelatedMulti

public List<GenericValue> getRelatedMulti(String relationNameOne,
 String relationNameTwo,
 List<String> orderBy)
                                   throws GenericEntityException

Get the named Related Entity for the GenericValue from the persistent store across another Relation. Helps to get related Values in a multi-to-multi relationship.

Parameters:

relationNameOne - String containing the relation name which is the combination of relation.title and relation.rel-entity-name as specified in the entity XML definition file, for first relation

relationNameTwo - String containing the relation name for second relation

orderBy - The fields of the named entity to order the query by; may be null; optionally add a " ASC" for ascending or " DESC" for descending

Returns:

List of GenericValue instances as specified in the relation definition

Throws:

GenericEntityException

getRelatedMulti

public List<GenericValue> getRelatedMulti(String relationNameOne,
 String relationNameTwo)
                                   throws GenericEntityException

Get the named Related Entity for the GenericValue from the persistent store across another Relation. Helps to get related Values in a multi-to-multi relationship.

Parameters:

relationNameOne - String containing the relation name which is the combination of relation.title and relation.rel-entity-name as specified in the entity XML definition file, for first relation

relationNameTwo - String containing the relation name for second relation

Returns:

List of GenericValue instances as specified in the relation definition

Throws:

GenericEntityException

getRelatedOne

@Deprecated
public GenericValue getRelatedOne(String relationName)
                           throws GenericEntityException

Deprecated.

use getRelatedOne(String, boolean)

Get the named Related Entity for the GenericValue from the persistent store

Parameters:

relationName - String containing the relation name which is the combination of relation.title and relation.rel-entity-name as specified in the entity XML definition file

Returns:

List of GenericValue instances as specified in the relation definition

Throws:

GenericEntityException

getRelatedOne

public GenericValue getRelatedOne(String relationName,
 boolean useCache)
                           throws GenericEntityException

Get the named Related Entity for the GenericValue from the persistent store

Parameters:

relationName - String containing the relation name which is the combination of relation.title and relation.rel-entity-name as specified in the entity XML definition file

useCache - Whether to cache the results

Returns:

The single related GenericValue instance

Throws:

GenericEntityException

removeRelated

public void removeRelated(String relationName)
                   throws GenericEntityException

Remove the named Related Entity for the GenericValue from the persistent store

Parameters:

relationName - String containing the relation name which is the combination of relation.title and relation.rel-entity-name as specified in the entity XML definition file

Throws:

GenericEntityException

getRelatedDummyPK

public GenericPK getRelatedDummyPK(String relationName)
                            throws GenericEntityException

Get a dummy primary key for the named Related Entity for the GenericValue

Parameters:

relationName - String containing the relation name which is the combination of relation.title and relation.rel-entity-name as specified in the entity XML definition file

Returns:

GenericPK containing a possibly incomplete PrimaryKey object representing the related entity or entities

Throws:

GenericEntityException

getRelatedDummyPK

public GenericPK getRelatedDummyPK(String relationName,
 Map<String,? extends Object> byAndFields)
                            throws GenericEntityException

Get a dummy primary key for the named Related Entity for the GenericValue

Parameters:

relationName - String containing the relation name which is the combination of relation.title and relation.rel-entity-name as specified in the entity XML definition file

byAndFields - the fields that must equal in order to keep; may be null

Returns:

GenericPK containing a possibly incomplete PrimaryKey object representing the related entity or entities

Throws:

GenericEntityException

hashCode

public int hashCode()

hash code

Specified by:

hashCode in interface Map<String,Object>

Overrides:

hashCode in class GenericEntity

Returns:

Hashcode corresponding to this entity

equals

public boolean equals(Object obj)

equals

Specified by:

equals in interface Map<String,Object>

Overrides:

equals in class GenericEntity

Parameters:

obj - The object (GenericEntity) to compare this two

Returns:

boolean stating if the two objects are equal

clone

public Object clone()

Clones this GenericValue, this is a shallow clone and uses the default shallow HashMap clone

Overrides:

clone in class GenericEntity

Returns:

Object that is a clone of this GenericValue

getStackTraceAsString

public static String getStackTraceAsString()