Class: NSMappingModel

Inherits:
NSObject show all

Overview

Instances of NSMappingModel specify how to map from a source to a destination managed object model.

Class Method Summary (collapse)

Instance Method Summary (collapse)

Methods inherited from NSObject

#!, #!=, #!~, #, #==, #===, #=~, #Rational, #__callee__, #__method__, #__send__, #__type__, `, alloc, allocWithZone:, #autoContentAccessingProxy, autoload, autoload?, autorelease_pool, #awakeAfterUsingCoder:, binding, block_given?, caller, cancelPreviousPerformRequestsWithTarget:, cancelPreviousPerformRequestsWithTarget:selector:object:, catch, class, classFallbacksForKeyedArchiver, #classForCoder, #classForKeyedArchiver, classForKeyedUnarchiver, #clone, conformsToProtocol:, #copy, copyWithZone:, #dealloc, #define_singleton_method, description, display, #doesNotRecognizeSelector:, #dup, #enum_for, #eql?, #equal?, #extend, fail, #finalize, format, #forwardInvocation:, #forwardingTargetForSelector:, framework, #freeze, #frozen?, getpass, gets, global_variables, #init, initialize, #initialize_clone, #initialize_copy, #initialize_dup, #inspect, instanceMethodForSelector:, instanceMethodSignatureForSelector:, #instance_eval, #instance_exec, #instance_of?, #instance_variable_defined?, #instance_variable_get, #instance_variable_set, #instance_variables, instancesRespondToSelector:, isSubclassOfClass:, #is_a?, iterator?, #kind_of?, lambda, load, load_bridge_support_file, load_plist, local_variables, loop, #method, #methodForSelector:, #methodSignatureForSelector:, #methods, #mutableCopy, mutableCopyWithZone:, new, #nil?, open, p, #performSelector:onThread:withObject:waitUntilDone:, #performSelector:onThread:withObject:waitUntilDone:modes:, #performSelector:withObject:afterDelay:, #performSelector:withObject:afterDelay:inModes:, #performSelectorInBackground:withObject:, #performSelectorOnMainThread:withObject:waitUntilDone:, #performSelectorOnMainThread:withObject:waitUntilDone:modes:, print, printf, #private_methods, proc, #protected_methods, #public_method, #public_methods, #public_send, putc, puts, raise, rand, readline, readlines, #replacementObjectForCoder:, #replacementObjectForKeyedArchiver:, require, resolveClassMethod:, resolveInstanceMethod:, #respond_to?, #respond_to_missing?, select, #send, setVersion:, #singleton_methods, sprintf, srand, superclass, #taint, #tainted?, #tap, test, throw, #to_plist, #to_s, trace_var, trap, #trust, #untaint, untrace_var, #untrust, #untrusted?, version

Constructor Details

This class inherits a constructor from NSObject

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class NSObject

Class Method Details

+ (NSMappingModel) inferredMappingModelForSourceModel(source, destinationModel:destination, error:error)

Returns a newly-created mapping model to migrate data from the source to the destination model. A model will be created only if all changes are simple enough to be able to reasonably infer a mapping (for example, removing or renaming an attribute, adding an optional attribute or relationship, or adding renaming or deleting an entity). Element IDs are used to track renamed properties and entities.

Parameters:

  • source (NSManagedObjectModel)

    The source managed object model.

  • destination (NSManagedObjectModel)

    The destination managed object model.

  • error (Pointer)

    If a problem occurs, on return contains an NSInferredMappingModelError error that describes the problem.The error’s user info will contain additional details about why inferring the mapping model failed (check for the following keys: reason, entity, property.

Returns:

  • (NSMappingModel)

    A newly-created mapping model to migrate data from the source to the destination model. If the mapping model can not be created, returns nil.

+ (NSMappingModel) mappingModelFromBundles(bundles, forSourceModel:sourceModel, destinationModel:destinationModel)

Returns the mapping model to translate data from the source to the destination model. This method is a companion to the mergedModelFromBundles: and mergedModelFromBundles:forStoreMetadata: methods. In this case, the framework uses the version information from the models to locate the appropriate mapping model in the available bundles.

Parameters:

  • bundles (Array)

    An array of bundles in which to search for mapping models.

  • sourceModel (NSManagedObjectModel)

    The managed object model for the source store.

  • destinationModel (NSManagedObjectModel)

    The managed object model for the destination store.

Returns:

  • (NSMappingModel)

    Returns the mapping model to translate data from sourceModel to destinationModel. If a suitable mapping model cannot be found, returns nil.

Instance Method Details

- (Array) entityMappings

Returns the collection of entity mappings for the receiver.

Returns:

  • (Array)

    The collection of entity mappings for the receiver.

- (Hash) entityMappingsByName

Returns a dictionary of the entity mappings for the receiver. You can use this method to quickly access to mapping by name, rather than iterating the ordered array returned by entityMappings.

Returns:

  • (Hash)

    A dictionary of the entity mappings for the receiver, keyed by their respective name.

- (Object) initWithContentsOfURL(url)

Returns a mapping model initialized from a given URL.

Parameters:

  • url (NSURL)

    The location of an archived mapping model.

Returns:

  • (Object)

    A mapping model initialized from url.

- (Object) setEntityMappings(mappings)

Sets the collection of entity mappings for the receiver

Parameters:

  • mappings (Array)

    The collection of entity mappings for the receiver.

Returns: