Load methods return a new instance (distinguish strictly between model and entity)

[mvorisek]

For 3.0 release 🚀

Definitions

MODEL

Instance of Model class that is supposed to model data/relations, but can not hold/contain any record data.

ENTITY

Instance of Model class that is supposed to hold/contain record data, but they can be modelled only using MODEL (described above).

The instance/object is locked with specific ID once it is loaded/inserted from/to DB.

Migration

Model data like now. To manipulate with the actual data, you need to create another instance from MODEL using createEntity() method to create a new entity or using {,try}load{,One,Any}() methods which now return a new instance - ENTITY.

Mistake safety

If and only if we can distinguish strictly between model and entity, then all wrong usage will throw and no code can keep working if used wrongly.