Objective-C : Le Singleton facile

Le singleton est très utilisé en Objective-C afin d'accéder à un objet partagé.
Seulement, cela peut être fastidieux à intégrer.

Article lu fois.

L'auteur

Florent Morin

L'article

Publié le 1^er janvier 2011 - Mis à jour le 31 mars 2020

Version PDF Version hors-ligne

ePub, Azw et Mobi

Liens sociaux

I. Le Singleton facile▲

Le singleton est très utilisé en Objective-C afin d'accéder à un objet partagé. Seulement, cela peut être fastidieux à intégrer.

Pour éviter le code à rallonge, voici un fichier qui pourra vous être utile.

KSSingleton.h

Cacher/Afficher le codeSélectionnez

1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.
71.
72.
73.
74.
75.
76.
77.
78.
79.
80.
81.
82.
83.
84.
85.
86.
87.
88.
89.
90.
91.
92.
93.
94.
95.
96.
97.
98.
99.
100.
101.
102.
103.
104.

//
//  KSSingleton.h
//
//  Created by Florent Morin on 27/03/10.
//  Copyright 2010 Kaeli Soft.
//
//  http://www.kaelisoft.fr
//


/*
 * __ Integration __ (minimal)
 *
 * #import "KSSingleton.h"
 * 
 * @interface MySingleton {
 * ...
 * }
 *
 * KS_SINGLETON_INTERFACE(MySingleton)
 *
 * ...
 *
 * @end
 *
 *
 * @implementation MySingleton
 *
 * KS_SINGLETON_IMPLEMENTATION(MySingleton)
 *
 * ...
 *
 * @end
 *
 */

/*
 * __ Initialization __ (optional)
 *
 * @interface MySingleton {
 * }
 *
 * ...
 *
 * - (void)initialization;
 *
 * @ end
 *
 * @implementation MySingleton
 *
 * - (void)initialization {
 * }
 *
 * @end
 *
 */

/*
 * __ Usage __
 *
 * MySingleton *s = [MySingleton sharedMySingleton];
 *
 */

#define KS_SINGLETON_INTERFACE(singletonclass) 
+ (singletonclass *)shared##singletonclass;

#define KS_SINGLETON_IMPLEMENTATION(singletonclass) 

static singletonclass *shared##singletonclass = nil; 

+ (singletonclass *)shared##singletonclass { 
if (shared##singletonclass == nil) { 
shared##singletonclass = [[super allocWithZone:NULL] init]; 
if ([shared##singletonclass respondsToSelector:@selector(initialization)]) { 
[shared##singletonclass performSelector:@selector(initialization)]; 
} 
} 

return shared##singletonclass; 
} 

+ (id)allocWithZone:(NSZone *)zone { 
return [[self shared##singletonclass] retain]; 
} 

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

- (id)retain { 
return self; 
} 

- (NSUInteger)retainCount { 
return NSUIntegerMax; 
} 

- (void)release { 
} 

- (id)autorelease { 
return self; 
}

Son usage est relativement simple.

MySingleton.h

Sélectionnez

1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.

#import 
 
#import "KSSingleton.h"
 
@interface MySingleton : NSObject {
        NSInteger integerValue;
}
 
@property (assign) NSInteger integerValue;
 
KS_SINGLETON_INTERFACE(MySingleton)
 
@end

MySingleton.m

Sélectionnez

1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.

#import "MySingleton.h"
 
@interface MySingleton (hidden)
 
- (void)initialization;
 
@end
 
@implementation MySingleton (hidden)
 
- (void)initialization {
        integerValue = 12;
}
 
@end
 
@implementation MySingleton
 
@synthesize integerValue;
 
KS_SINGLETON_IMPLEMENTATION(MySingleton)
 
@end

Notez que l'implémentation de - (void)initialization; est facultative.
Elle peut cependant être utile à l'initialisation du singleton.

Ensuite, l'utilisation dans le code se fait ainsi :

Sélectionnez

MySingleton *s = [MySingleton sharedSingleton];

L'appel au singleton se fait toujours via [MaClasse sharedMaClasse].

Vous pouvez utiliser cette fonctionnalité à titre personnel et/ou professionnel, du moment que vous conservez son en-tête intact.

Vous pouvez également télécharger le Projet d'exemple disponible ici.

II. Le modèle de fichier (XCode 3)▲

Si vraiment vous souhaitez gagner du temps, utilisez directement notre modèle de fichier.

La procédure d'installation est simple.

Placez-vous, dans votre répertoire « Bibliothèque » (Library). Allez donc à l'emplacement /Users/utilisateur/Library/Application Support/Developer/Shared/XCode.

S'il n'existe pas, créez le répertoire File Templates. Placez-vous dans ce répertoire. Créez le répertoire Kaeli Soft.

Téléchargez l'archive Kaeli Soft. Décompressez son contenu dans Kaeli Soft.

Relancez XCode.

Pour l'utiliser : File -> New File… puis sélectionnez, dans User Templates, Kaeli Soft.

Vous aurez alors la possibilité de créer un Singleton. Appuyez sur Next. Définissez le nom du fichier (qui sera le nom de la classe) et appuyez sur Finish.

Votre singleton est prêt !

Vous avez aimé ce tutoriel ? Alors partagez-le en cliquant sur les boutons suivants :

Copyright © 2011 Florent Morin. Aucune reproduction, même partielle, ne peut être faite de ce site ni de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts. Droits de diffusion permanents accordés à Developpez LLC.