Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Write down what "transient" means #10394

Merged
merged 3 commits into from
Jan 14, 2023
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions docs/en/reference/architecture.rst
Original file line number Diff line number Diff line change
Expand Up @@ -94,6 +94,19 @@ classes, and non-entity classes may extend entity classes.
never calls entity constructors, thus you are free to use them as
you wish and even have it require arguments of any type.

Mapped Superclasses
~~~~~~~~~~~~~~~~~~~

A mapped superclass is an abstract or concrete class that provides persistent entity state and mapping information for its subclasses, but which is not itself an entity.

Mapped superclasses are explained in greater detail in the chapter on :doc:`inheritance mapping <reference/inheritance-mapping>`.

Transient Classes
~~~~~~~~~~~~~~~~~

The term "transient class" appears in some places in the mapping drivers as well as the code dealing with metadata handling.

A transient class is a class that is neither an entity nor a mapped superclass. From the ORMs point of view, these classes can be completely ignored, and no class metadata is loaded for them at all.
mpdude marked this conversation as resolved.
Show resolved Hide resolved

Entity states
~~~~~~~~~~~~~
Expand Down