Method Detail

• public long checkAgainstDatabase(java.util.List<java.lang.String> messages)

• public boolean checkFks(boolean insertDummy)

  Checks to see if all foreign key records exist in the database. Will create a dummy value for those missing when specified.

  Returns:

  true if all FKs exist (or when all missing are created)

  Parameters:

  insertDummy - Create a dummy record using the provided fields

• public EntityValue cloneValue()

• @java.lang.Override public int compareTo(EntityValue that)

  Compares this EntityValue to the passed object

  Returns:

  int representing the result of the comparison (-1,0, or 1)

  Parameters:

  that - Object to compare this to

• public boolean containsPrimaryKey()

  Returns true if the entity contains all of the primary key fields.

• public EntityValue create()

  Creates a record for this entity value.

  Returns:

  reference to this for convenience

• public EntityValue createOrUpdate()

  Creates a record for this entity value, or updates the record if one exists that matches the primary key.

  Returns:

  reference to this for convenience

• public EntityValue delete()

  Deletes the record that matches the primary key.

  Returns:

  reference to this for convenience

• public void deleteRelated(java.lang.String relationshipName)

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

  Parameters:

  relationshipName - String containing the relationship name which is the combination of relationship.title and relationship.related-entity-name as specified in the entity XML definition file

• public boolean deleteWithRelated(java.util.Set<java.lang.String> relationshipsToDelete)

  Delete this record plus records for all relationships specified. If any records exist for other relationships not specified that depend on this record returns false and does not delete anything. Otherwise returns true.

• public EntityList findRelated(java.lang.String relationshipName, java.util.Map<java.lang.String, java.lang.Object> byAndFields, java.util.List<java.lang.String> orderBy, java.lang.Boolean useCache, java.lang.Boolean forUpdate)

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

  Returns:

  List of EntityValue instances as specified in the relation definition

  Parameters:

  relationshipName - String containing the relationship name which is the combination of relationship.title and relationship.related-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 - Look in the cache before finding in the datasource. Defaults to setting on entity definition.

• public long findRelatedCount(java.lang.String relationshipName, java.lang.Boolean useCache)

• public EntityValue findRelatedOne(java.lang.String relationshipName, java.lang.Boolean useCache, java.lang.Boolean forUpdate)

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

  Returns:

  List of EntityValue instances as specified in the relation definition

  Parameters:

  relationshipName - String containing the relationship name which is the combination of relationship.title and relationship.related-entity-name as specified in the entity XML definition file

  useCache - Look in the cache before finding in the datasource. Defaults to setting on entity definition.

• public java.lang.Object get(java.lang.String name)

  Get the named field. If there is a matching entry in the moqui.basic.LocalizedEntityField entity using the Locale in the current ExecutionContext then that will be returned instead. This method also supports getting related entities using their relationship name, formatted as "${title}${related-entity-name}". When doing so it is like calling findRelated(relationshipName, null, null, null, null) for type many relationships, or findRelatedOne(relationshipName, null, null) for type one relationships.

  Returns:

  Object with the value of the field, or the related EntityValue or EntityList.

  Parameters:

  name - The field name to get, or the name of the relationship to get one or more related values from.

• public java.math.BigDecimal getBigDecimal(java.lang.String name)

• public java.lang.Boolean getBoolean(java.lang.String name)

• public byte[] getBytes(java.lang.String name)

• public java.sql.Date getDate(java.lang.String name)

• public java.lang.Double getDouble(java.lang.String name)

• public java.lang.String getEntityName()

• public java.lang.Long getLong(java.lang.String name)

• public java.util.Map<java.lang.String, java.lang.Object> getMap()

  Gets a cloned, mutable Map with the field values that is independent of this value object. Can be augmented or modified without modifying or being constrained by this entity value.

• public java.util.Map<java.lang.String, java.lang.Object> getMasterValueMap(java.lang.String name)

  List getPlainValueMap() but uses a master definition to determine which dependent/related records to get.

• public java.lang.Object getNoCheckSimple(java.lang.String name)

  Get simple fields only (no localization, no relationship) and don't check to see if it is a valid field; mostly for performance reasons and for well tested code with known field names. If it is not a valid field name will just return null and not throw an error, ie doesn't check for valid field names.

• public java.lang.Object getOriginalDbValue(java.lang.String name)

• public java.util.Map<java.lang.String, java.lang.Object> getPlainValueMap(int dependentLevels)

  Get a Map with all non-null field values. If dependentLevels is greater than zero includes nested dependents in the Map as an entry with key of the dependent relationship's short-alias or if no short-alias then the relationship name (title + related-entity-name). Each dependent entity's Map may have its own dependent records up to dependentLevels levels deep.

• public java.util.Map<java.lang.String, java.lang.Object> getPrimaryKeys()

• public javax.sql.rowset.serial.SerialBlob getSerialBlob(java.lang.String name)

• public java.lang.String getString(java.lang.String name)

• public java.sql.Time getTime(java.lang.String name)

• public java.sql.Timestamp getTimestamp(java.lang.String name)

• public boolean isField(java.lang.String name)

  Returns true if the name is a valid field name for the entity this is a value of, false otherwise (meaning get(), set(), etc calls with throw an exception with the field name)

• public boolean isFieldModified(java.lang.String name)

  Returns true if the field has been modified

• public boolean isFieldSet(java.lang.String name)

  Returns true if a value for the field is set, even if it is null

• public boolean isModified()

  Returns true if any field has been modified

• public boolean isMutable()

• public org.w3c.dom.Element makeXmlElement(org.w3c.dom.Document document, java.lang.String prefix)

  Makes an XML Element object with an attribute for each field of the entity

  Returns:

  org.w3c.dom.Element object representing this entity value

  Parameters:

  document - The XML Document that the new Element will be part of

  prefix - A prefix to put in front of the entity name in the tag name

• public boolean mapMatches(java.util.Map<java.lang.String, java.lang.Object> theMap)

  Returns true if all entries in the Map match field values.

• public boolean refresh()

  Refreshes this value based on the record that matches the primary key.

  Returns:

  true if a record was found, otherwise false also meaning no refresh was done

• public EntityValue set(java.lang.String name, java.lang.Object value)

  Sets the named field to the passed value, even if the value is null

  Returns:

  reference to this for convenience

  Parameters:

  name - The field name to set

  value - The value to set

• public EntityValue setAll(java.util.Map<java.lang.String, java.lang.Object> fields)

  Sets fields on this entity from the Map of fields passed in using the entity definition to only get valid fields from the Map. For any String values passed in this will call setString to convert based on the field definition, otherwise it sets the Object as-is.

  Returns:

  reference to this for convenience

  Parameters:

  fields - The fields Map to get the values from

• public EntityValue setBytes(java.lang.String name, byte[] theBytes)

• public EntityValue setFields(java.util.Map<java.lang.String, java.lang.Object> fields, boolean setIfEmpty, java.lang.String namePrefix, java.lang.Boolean pks)

  Sets fields on this entity from the Map of fields passed in using the entity definition to only get valid fields from the Map. For any String values passed in this will call setString to convert based on the field definition, otherwise it sets the Object as-is.

  Returns:

  reference to this for convenience

  Parameters:

  fields - The fields Map to get the values from

  setIfEmpty - Used to specify whether empty/null values in the field Map should be set

  namePrefix - If not null or empty will be pre-pended to each field name (upper-casing the first letter of the field name first), and that will be used as the fields Map lookup name instead of the field-name

  pks - If null, get all values, if TRUE just get PKs, if FALSE just get non-PKs

• public EntityValue setSequencedIdPrimary()

  Get the next guaranteed unique seq id for this entity, and set it in the primary key field. This will set it in the first primary key field in the entity definition, but it really should be used for entities with only one primary key field.

  Returns:

  reference to this for convenience

• public EntityValue setSequencedIdSecondary()

  Look at existing values with the same primary sequenced ID (first PK field) and get the highest existing value for the secondary sequenced ID (the second PK field), add 1 to it and set the result in this entity value. The current value object must have the primary sequenced field already populated.

  Returns:

  reference to this for convenience

• public EntityValue setString(java.lang.String name, java.lang.String value)

  Sets the named field to the passed value, converting the value from a String to the corresponding type using Type.valueOf() If the String "null" is passed in it will be treated the same as a null value. If you really want to set a String of "null" then pass in "\null".

  Returns:

  reference to this for convenience

  Parameters:

  name - The field name to set

  value - The String value to convert and set

• public EntityValue store()

  Alias for createOrUpdate()

• public EntityValue update()

  Updates the record that matches the primary key.

  Returns:

  reference to this for convenience

• public int writeXmlText(java.io.Writer writer, java.lang.String prefix, int dependentLevels)

  Writes XML text with an attribute or CDATA element for each field of the entity. If dependents is true also writes all dependent (descendant) records.

  Returns:

  The number of records written

  Parameters:

  writer - A Writer object to write to

  prefix - A prefix to put in front of the entity name in the tag name

  dependentLevels - Write dependent (descendant) records this many levels deep, zero for no dependents

• public int writeXmlTextMaster(java.io.Writer pw, java.lang.String prefix, java.lang.String masterName)