Class MultiPersistableMapping

Direct Known Subclasses:
ReferenceMapping, SubclassPCMapping

public abstract class MultiPersistableMapping extends MultiMapping
Extension of MultiMapping where the actual mapping represents multiple possible persistable types such as with an interface/reference field. For example, with an interface mapping we have say 3 known implementations of the interface, so this mapping represents 3 FKs. A maximum of one will be set and the others null.
  • Constructor Details

    • MultiPersistableMapping

      public MultiPersistableMapping()
  • Method Details

    • getMappingNumberForValue

      protected int getMappingNumberForValue(org.datanucleus.ExecutionContext ec, Object value)
      Convenience accessor for the number of the java type mapping where the passed value would be stored. If no suitable mapping is found will return -1. If is a persistent interface then will return -2 meaning persist against *any* mapping
      Parameters:
      ec - ExecutionContext
      value - The value
      Returns:
      The index of javaTypeMappings to use (if any), or -1 (none), or -2 (any)
    • setObject

      public void setObject(org.datanucleus.ExecutionContext ec, PreparedStatement ps, int[] pos, Object value)
      Method to set the parameters in the PreparedStatement with the fields of this object.
      Overrides:
      setObject in class JavaTypeMapping
      Parameters:
      ec - execution context
      ps - The PreparedStatement
      pos - The parameter positions
      value - The object to populate the statement with
      Throws:
      org.datanucleus.exceptions.NotYetFlushedException - Thrown if the object is not yet flushed to the datastore
    • setObject

      public void setObject(org.datanucleus.ExecutionContext ec, PreparedStatement ps, int[] pos, Object value, org.datanucleus.state.DNStateManager ownerSM, int ownerFieldNumber)
      Sets the specified positions in the PreparedStatement associated with this field, and value. If the number of positions in "pos" is not the same as the number of datastore mappings then it is assumed that we should only set the positions for the real implementation FK; this happens where we have a statement like "... WHERE IMPL1_ID_OID = ? AND IMPL2_ID_OID IS NULL" so we need to filter on the other implementations being null and only want to input parameter(s) for the real implementation of "value".
      Overrides:
      setObject in class JavaTypeMapping
      Parameters:
      ec - execution context
      ps - a datastore object that executes statements in the database
      pos - The position(s) of the PreparedStatement to populate
      value - the value stored in this field
      ownerSM - the owner StateManager
      ownerFieldNumber - the owner absolute field number
    • getObject

      public Object getObject(org.datanucleus.ExecutionContext ec, ResultSet rs, int[] pos)
      Method to retrieve an object of this type from the ResultSet.
      Overrides:
      getObject in class JavaTypeMapping
      Parameters:
      ec - execution context
      rs - The ResultSet
      pos - The parameter positions
      Returns:
      The object