Mutex

Package	flash.concurrent
Classe	public final class Mutex
Héritage	Mutex Object

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 11.5, AIR 3.5

Le mutex (abréviation de « mutual exclusion », à savoir exclusion mutuelle) est un moyen de s’assurer que seul un jeu de code s’exécute sur un bloc de mémoire particulier ou sur une autre ressource partagée. L’objectif principal d’un mutex est de gérer le code dans plusieurs programmes de travail qui accèdent à un tableau d’octets partageable (objet ByteArray dont la propriété shareable est définie sur true). Il est néanmoins possible d’utiliser un mutex pour gérer l’accès d’un programme de travail à n’importe quelle ressource partageable, telle qu’une extension native AIR ou un fichier d’un système de fichiers. Quelle que soit la ressource, l’objectif du mutex est de s’assurer qu’un seul jeu de code accède à la ressource.

Un mutex gère l’accès à l’aide du concept de propriété de ressource. Un programme de travail peut à tout moment « prendre possession » d’un mutex. Lorsque la propriété d’un mutex passe d’un programme de travail à un autre, la transition est atomique, ce qui signifie qu’il est impossible que plusieurs programmes de travail entrent simultanément en possession du mutex. Tant que le code d’un programme de travail est exécuté uniquement sur une ressource partagée lorsque ce programme de travail est en possession du mutex, vous pouvez être certain qu’il n’existera jamais de conflit entre plusieurs programmes de travail.

Utilisez la méthode tryLock() pour prendre possession du mutex, s’il est disponible. Utilisez la méthode lock() pour interrompre l’exécution du programme de travail actuel jusqu’à ce que le mutex soit disponible, puis prenez possession du mutex. Dès que le programme de travail est en possession du mutex, il peut exécuter le code sur la ressource partagée en toute sécurité. Une fois ces opérations terminées, appelez la méthode unlock() pour libérer le mutex. Le programme de travail actuel ne devrait plus être en mesure d’accéder à la ressource partagée.

La classe Mutex est l’un des types d’objets spéciaux qui sont partagés (et non copiés) entre les programmes de travail. Lorsque vous transmettez un mutex d’un programme de travail à un autre, soit en appelant la méthode setSharedProperty() de l’objet Worker, soit en utilisant un objet MessageChannel, les deux programmes de travail possèdent une référence au même objet Mutex dans la mémoire du moteur d’exécution.

Eléments de l’API associés

Classe Worker
Propriété ByteArray.shareable
Classe Condition

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		Mutex() Crée une nouvelle occurrence de l’objet Mutex.	Mutex
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.	Object
		lock():void Interrompt l’exécution du programme de travail actuel jusqu’à ce que le mutex soit disponible, puis prend possession du mutex.	Mutex
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		tryLock():Boolean Prend possession du mutex, si celui-ci est disponible.	Mutex
		unlock():void Libère la propriété de ce mutex, ce qui permet à un programme de travail d’entrer en possession du mutex et d’utiliser la ressource associée.	Mutex
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object

Détails du constructeur

()

Constructeur

public function Mutex()

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 11.5, AIR 3.5

Crée une nouvelle occurrence de l’objet Mutex.

Valeur émise

Error — si le mutex n’a pas pu être initialisé.

Détails de la méthode

lock

()

méthode

public function lock():void

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 11.5, AIR 3.5

Interrompt l’exécution du programme de travail actuel jusqu’à ce que le mutex soit disponible, puis prend possession du mutex. Si un autre programme de travail est en possession du mutex lors de l’appel de la méthode lock(), le thread d’exécution du programme de travail appelant est interrompu à l’appel de la méthode lock() et le programme de travail est ajouté à la file d’attente des demandes de propriété. Dès que le programme de travail appelant entre en possession du mutex, l’exécution du programme de travail reprend à la ligne de code suivant l’appel de la méthode lock().

Dès que le programme de travail est en possession du mutex, il peut exécuter le code sur la ressource partagée en toute sécurité. Une fois ces opérations terminées, appelez la méthode unlock() pour libérer le mutex. Le programme de travail actuel ne devrait plus être en mesure d’accéder à la ressource partagée.

Un mutex comptabilise de façon interne le nombre de demandes de verrouillage qu’il a reçues. Le mutex doit recevoir le même nombre de demandes de déverrouillage avant d’être totalement libéré. Si le code du programme de travail qui est en possession du mutex verrouille à nouveau le mutex (en appelant la méthode lock()), le nombre de demandes de verrouillage internes augmente de un. Vous devez appeler la méthode unlock() autant de fois que le nombre de demandes de verrouillage pour libérer la propriété du mutex.

Lorsque plusieurs programmes de travail attendent un mutex, le mutex donne priorité à celui qui attend depuis plus longtemps. La planification des threads des programmes de travail est toutefois gérée par le système d’exploitation hôte ; l’ordre d’exécution de code parmi les programmes de travail n’est donc pas garanti.

tryLock

()

méthode

public function tryLock():Boolean

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 11.5, AIR 3.5

Prend possession du mutex, si celui-ci est disponible. Si un autre programme de travail est déjà en possession du mutex, ou a appelé la méthode lock() et attend d’entrer en possession du mutex, le mutex n’est pas disponible. Dans ce cas, l’appel de cette méthode renvoie false et l’exécution du code reprend immédiatement.

Valeur renvoyée

Boolean — true si le mutex était disponible (et appartient désormais au programme de travail actuel), ou false si le programme de travail actuel n’a pas pris possession du mutex.

unlock

()

méthode

public function unlock():void

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 11.5, AIR 3.5

Libère la propriété de ce mutex, ce qui permet à un programme de travail d’entrer en possession du mutex et d’utiliser la ressource associée.

Un mutex comptabilise de façon interne le nombre de demandes de verrouillage qu’il a reçues. Le code d’un programme de travail doit appeler la méthode unlock() autant de fois que le nombre de demandes de verrouillage afin de libérer la propriété du mutex.

Valeur émise

IllegalOperationError — lorsque le programme de travail actuel n’est pas en possession du mutex

Informations juridiques | Politique de confidentialité en ligne

Mutex - AS3

Classes x

Mutex

lock

tryLock

unlock