Singleton in iOS Objective C doesn't prevent more than one instance

4.2k views Asked by At

I know there are several threads on this, but none answer my questions.

I've implemented my singleton class like this (being aware of the controversy about singletons):

+ (MyClass*) sharedInstance {
    static MyClass *_sharedInstance = nil;
    static dispatch_once_t oncePredicate;
    dispatch_once(&oncePredicate, ^{
        _sharedInstance = [[MyClass alloc] init];
    });
    return _sharedInstance;
}

- (instancetype)init{
    self = [super init];
    if (self) {
        //setup code
    }
    return self;
}

I tried instantiating a different object and compared it to the one returned by sharedInstance with '==' and they were indeed different.

Questions:

  1. Shouldn't creating more than one object of the singleton class be impossible? Isn't that the point? Singleton implementation in Java prevents it.
  2. And if so, how? Should I make a setup method and call it instead of having the init implemented and doing it?
  3. Is this correct implementation?
9

There are 9 answers

2
Glorfindel On

You can't make the init method private, like you would do in Java with the constructor. So nothing stops you from calling [[MyClass alloc] init] which indeed creates a different object. As long as you don't do that, but stick to the sharedInstance method, your implementation is fine.

What you could do: have the init method raise an exception (e.g. with [self doesNotRecognizeSelector:@_cmd]) and perform the initialization in a different method (e.g. privateInit) which is not exposed in the header file.

1
Jatin Patel - JP On

To prevent creating multiple objects of single class, you need to do following things. you just fine to created singleton object. but while calling init, copy, mutable copy, you need to handle such way.

- (instancetype)init{

    if (!_sharedInstance) {
        _sharedInstance = [MyClass sharedInstance];
    }
    return _sharedInstance;
}




- (id)copy{

        if (!_sharedInstance) {
            _sharedInstance = [MyClass sharedInstance];
        }
        return _sharedInstance;
    }

the same things for mutable copy as well. so this implementation make sure that once one instance is available throughout..

May this help you.

1
kursus On

This works for me :

static DataModel *singleInstance;

+ (DataModel*)getInstance{
    if (singleInstance == nil) {
        singleInstance = [[super alloc] init];
    }
    return singleInstance;
}

You can call it with

_model = [DataModel getInstance];
2
CRD On

Your observation is correct, many of the "singleton" patterns you see in Objective-C are not singletons at all but rather a "shared instance" model where other instances can be created.

In the old MRC days Apple used to have sample code showing how to implement a true singleton.

The code you have is the recommended pattern for ARC and thread-safe singletons, you just need to place it in the init method:

- (instancetype) init
{
   static MyClass *initedObject;
   static dispatch_once_t onceToken;
   dispatch_once(&onceToken, ^{
      initedObject = [super init];
   });
   return initedObject;
}

This code will ensure that there is only ever one instance of MyClass regardless of how many [MyClass new] or [[MyClass alloc] init] calls are made.

That is all you need to do, but you can go further. First if you wish to have a class method to return the singleton it is simply:

+ (instancetype) singletonInstance
{
   return [self new];
}

This method ends up calling init which returns the singleton, creating it if needed.

If MyClass implements NSCopying then you also need to implement copyWithZone: - which is the method which copy calls. As you've a singleton this is really simple:

- (instancetype) copyWithZone:(NSZone *)zone
{
   return self;
}

Finally in Objective-C the operations of allocating a new object instance and initialising it are distinct. The above scheme ensures only one instance of MyClass is initialised and used, however for every call to new or alloc another instance is allocated and then promptly discarded by init and cleaned up by ARC. This is somewhat wasteful!

This is easily addressed by implementing allocWithZone: (like copy above this is the method alloc actually ends up calling) following the same pattern as for init:

+ (instancetype) allocWithZone:(NSZone *)zone
{
   static MyClass *allocatedObject;
   static dispatch_once_t onceToken;
   dispatch_once(&onceToken, ^{
      allocatedObject = [super allocWithZone:zone];
   });
   return allocatedObject;
}

The first time an instance is created then allocWithZone: will allocate it and then init will initialise it, all subsequent calls will return the already existing object. No discarded unneeded allocations.

That's it, a true singleton, and no harder than the faux-singletons that are so common.

HTH

0
Himanshu Mahajan On

With objective-c, you can prevent your singleton class to create more than one object. You can prevent alloc and init call with your singleton class.

#import <Foundation/Foundation.h>

@interface SingletonClass : NSObject

+ (id) sharedInstance;
- (void) someMethodCall;
- (instancetype) init __attribute__((unavailable("Use +[SingletonClass sharedInstance] instead")));
+ (instancetype) new __attribute__ ((unavailable("Use +[SingletonClass sharedInstance] instead")));

@end


#import "SingletonClass.h"

@implementation SingletonClass

+ (id) sharedInstance{
    static SingletonClass * sharedObject = nil;
    static dispatch_once_t onceToken;

    dispatch_once(&onceToken, ^{
        sharedObject = [[self alloc] initPrivate];
    });

    return sharedObject;
}

- (instancetype)init {
    @throw [NSException exceptionWithName:NSInternalInconsistencyException reason:[NSString stringWithFormat:@"You can't override the init call in class %@", NSStringFromClass([self class])] userInfo:nil];
}

- (instancetype)initPrivate {
    if (self = [super init]) {

    }
    return self;
}


- (void) someMethodCall{
    NSLog(@"Method Call");
}

@end

1# If you will try to call init or new methods on SingletonClass, then these methods would not be available to call.

2# If you comment out mentioned below methods in header file and try to call the init on SingletonClass method then app will be crashed with reason "You can't override the init call in class SingletonClass".

   - (instancetype) init __attribute__((unavailable("Use +[SingletonClass sharedInstance] instead")));
   + (instancetype) new __attribute__ ((unavailable("Use +[SingletonClass sharedInstance] instead")));

Just use this code to create single object to Singleton Pattern and prevent alloc init call for singleton pattern from other classes. I had tested this code with xCode 7.0+ and its working fine.

2
esttorhe On

@VeryPoliteNerd just mark the init and new methods as unavailable on the .h:

- (instancetype)init __attribute__((unavailable("Use +[MyClass sharedInstance] instead")));

+ (instancetype)new __attribute__((unavailable("Use +[MyClass sharedInstance] instead")));

This will cause the compiler to complain if a caller tries to manually instantiate this objects

1
gnasher729 On

Calling alloc / init to get a second instance of a Singleton class is considered a blatant programming error. To avoid this kind of programming error, you don't write complicated code to prevent it, you do code reviews and tell off everyone trying to do it, as you would with any programming error.

0
LaLa On

This works for me:

static AudioRecordingGraph * __strong sharedInstance;

+(instancetype)sharedInstance {

    @synchronized(self) {

        if(!sharedInstance) {

            sharedInstance = [AudioRecordingGraph new];
        }
        return sharedInstance;
    }
}
0
Rob On

I wanted to add observation for a modern implementation of Objective-C singletons for optimal Swift interoperability. But let me start with the code. Let’s assume for a second that the class was to manage a series of requests, so I might call it a RequestManager:

// RequestManager.h

NS_ASSUME_NONNULL_BEGIN

@interface RequestManager : NSObject

@property (nonatomic, strong, readonly, class) RequestManager *sharedManager;

- (instancetype)init NS_UNAVAILABLE;
- (instancetype)copy NS_UNAVAILABLE;
- (instancetype)mutableCopy NS_UNAVAILABLE;

- (void)someMethod;

@end

NS_ASSUME_NONNULL_END

And

// RequestManager.m

@implementation RequestManager

+ (instancetype)sharedManager {
    static RequestManager *_sharedInstance = nil;
    static dispatch_once_t oncePredicate;
    dispatch_once(&oncePredicate, ^{
        _sharedInstance = [[self alloc] init];
    });
    return _sharedInstance;
}

- (instancetype)init {
    self = [super init];
    if (self) {
        //setup code
    }
    return self;
}

- (void)someMethod { ... }

@end

Note:

  1. Note, I made the singleton a class property rather than a class method.

    From the Objective-C side, it is a distinction without difference, but from Swift, you can do things like MyClass.shared without the noise of the (). This is the pattern that Apple has adopted with all of their singletons.

  2. One might give the singleton a more meaningful name. For example, if the class was a RequestManager, the singleton might be called sharedManager rather than sharedInstance.

    If you do this, Swift will automatically detect the salient portion of the instance name and will expose it to Swift as shared, not sharedInstance or whatever.

    If you really want to use the name sharedInstance in your Objective-C code, then will just need to supply an explicit NS_SWIFT_NAME of shared to adopt the nice, concise, and consistent singleton naming practice in Swift:

     @property (nonatomic, strong, readonly, class) RequestManager *sharedInstance NS_SWIFT_NAME(shared);
    
  3. Note the use of NS_UNAVAILABLE. This prevents callers from accidentally instantiating their own copies. E.g. from Objective-C:

    enter image description here

    Or from Swift:

    enter image description here

  4. Probably needless to say, I’ve audited this for nullability, namely using the NS_ASSUME_NONNULL_BEGIN/END to make the default non-null. Or, obviously, you could just mark the singleton property as nonnull.