Class DbRelationship

java.lang.Object
org.apache.cayenne.map.Relationship<DbEntity, DbAttribute, DbRelationship>
org.apache.cayenne.map.DbRelationship
All Implemented Interfaces:
ProjectNode, XMLSerializable
public class DbRelationship extends Relationship<DbEntity, DbAttribute, DbRelationship> implements ProjectNode
A DbRelationship is a descriptor of a database inter-table relationship based on one or more primary key/foreign key pairs.

  • Field Details

    • joins

      protected List<DbJoin> joins

    • toDependentPK

      protected boolean toDependentPK

  • Constructor Details

    • DbRelationship

      public DbRelationship()

    • DbRelationship

      public DbRelationship(String name)

  • Method Details

    • acceptVisitor

      public <T> T acceptVisitor(ProjectNodeVisitor<T> visitor)
      Specified by:
      acceptVisitor in interface ProjectNode
      Since:
      3.1

    • encodeAsXML

      public void encodeAsXML(XMLEncoder encoder, ProjectNodeVisitor<?> delegate)
      Prints itself as XML to the provided XMLEncoder.
      Specified by:
      encodeAsXML in interface XMLSerializable
      Since:
      1.1

    • getTargetEntity

      public DbEntity getTargetEntity()
      Returns a target of this relationship. If relationship is not attached to a DbEntity, and DbEntity doesn't have a namespace, and exception is thrown.
      Specified by:
      getTargetEntity in class Relationship<DbEntity, DbAttribute, DbRelationship>

    • getTargetAttributes

      public Collection<DbAttribute> getTargetAttributes()
      Returns a Collection of target attributes.
      Since:
      1.1

    • getSourceAttributes

      public Collection<DbAttribute> getSourceAttributes()
      Returns a Collection of source attributes.
      Since:
      1.1

    • createReverseRelationship

      public DbRelationship createReverseRelationship()
      Creates a new relationship with the same set of joins, but going in the opposite direction.
      Since:
      1.0.5

    • getReverseRelationship

      public DbRelationship getReverseRelationship()
      Returns DbRelationship that is the opposite of this DbRelationship. This means a relationship from this target entity to this source entity with the same join semantics. Returns null if no such relationship exists.
      Specified by:
      getReverseRelationship in class Relationship<DbEntity, DbAttribute, DbRelationship>

    • isToPK

      public boolean isToPK()
      Returns true if every join of this relationship points to a PK column of the target entity. This is a structural fact about the joins; whether the source row actually holds the FK is isFromFK().
      Since:
      1.1

    • isFromFK

      public boolean isFromFK()
      Returns true if this relationship's source owns the foreign key side of the relationship. I.e., the source join columns are all foreign keys.
      Since:
      5.0

    • isToDependentPK

      public boolean isToDependentPK()
      Returns true if relationship from source to target points to dependent primary key. Dependent PK is a primary key column of the destination table that is also a FK to the source column.

    • setToDependentPK

      public void setToDependentPK(boolean toDependentPK)

    • isValidForDepPk

      public boolean isValidForDepPk()
      Since:
      1.1

    • getJoins

      public List<DbJoin> getJoins()
      Returns a list of joins. List is returned by reference, so any modifications of the list will affect this relationship.

    • addJoin

      public void addJoin(DbJoin join)
      Adds a join.
      Since:
      1.1

    • removeJoin

      public void removeJoin(DbJoin join)

    • removeAllJoins

      public void removeAllJoins()

    • setJoins

      public void setJoins(Collection<DbJoin> newJoins)

    • targetPkSnapshotWithSrcSnapshot

      public Map<String,Object> targetPkSnapshotWithSrcSnapshot(Map<String,Object> srcSnapshot)
      Creates a snapshot of primary key attributes of a target object of this relationship based on a snapshot of a source. Only "to-one" relationships are supported. Returns null if relationship does not point to an object. Throws CayenneRuntimeException if relationship is "to many" or if snapshot is missing id components.

    • setToMany

      public void setToMany(boolean toMany)
      Sets relationship multiplicity.

    • toString

      public String toString()
      Description copied from class: Relationship
      Overrides Object.toString() to return informative description.
      Overrides:
      toString in class Relationship<DbEntity, DbAttribute, DbRelationship>

    • getSourceEntityName

      public String getSourceEntityName()