Initializes a managed object from an entity description and inserts it into the specified managed object context.


init(entity: NSEntityDescription, insertInto context: NSManagedObjectContext?)



The entity of which to create an instance.

The model associated with context's persistent store coordinator must contain entity.


The context into which the new instance is inserted.

Return Value

An initialized instance of the appropriate class for entity.


NSManagedObject uses dynamic class generation to support the Objective-C 2 properties feature (see Declared Properties) by automatically creating a subclass of the class appropriate for entity. initWithEntity:insertIntoManagedObjectContext: therefore returns an instance of the appropriate class for entity. The dynamically-generated subclass will be based on the class specified by the entity, so specifying a custom class in your model will supersede the class passed to alloc.

If context is not nil, this method invokes [context insertObject:self] (which causes awakeFromInsert() to be invoked).

You are discouraged from overriding this method—you should instead override awakeFromInsert() and/or awakeFromFetch() (if there is logic common to these methods, it should be factored into a third method which is invoked from both). If you do perform custom initialization in this method, you may cause problems with undo and redo operations.

In many applications, there is no need to subsequently assign a newly-created managed object to a particular store—see assign(_:to:). If your application has multiple stores and you do need to assign an object to a specific store, you should not do so in a managed object's initializer method. Such an assignment is controller- not model-level logic.

Special Considerations

If you override init(entity:insertInto:), you must ensure that you set self to the return value from invocation of super’s implementation, as shown in the following example:

- (id)initWithEntity:(NSEntityDescription*)entity insertIntoManagedObjectContext:(NSManagedObjectContext*)context
    self = [super initWithEntity:entity insertIntoManagedObjectContext:context];
    if (self != nil) {
        // Perform additional initialization.
    return self;

See Also

Initializing a Managed Object

init(context: NSManagedObjectContext)

Initializes a managed object subclass and inserts it into the specified managed object context.