Modes de propriété des zones de travail
Les informations d'une zone de travail sont constituées d'un ensemble de propriétés ; une propriété comprend un triple clé-valeur-mode. La paire clé-valeur représente les informations contenues dans la propriété ; la clé correspond au nom permettant d'extraire la valeur associée. Le mode détermine si vous pouvez modifier ou supprimer la propriété.
Modes de propriété
Il existe quatre valeurs de mode possibles pour les propriétés, comme indiqué dans l'exemple de code suivant :
public final class PropertyModeType {
public static final PropertyModeType normal;
public static final PropertyModeType read_only;
public static final PropertyModeType fixed_normal;
public static final PropertyModeType fixed_readonly;
};
- Si la valeur associée à la clé peut être modifiée
- Si la propriété peut être supprimée
- Si le mode associé à la paire clé-valeur peut être modifié
Les deux modes en lecture seule ne permettent pas de modifier les informations de la propriété ; les deux modes fixes interdisent la suppression de la propriété.
Le service de zone de travail ne fournit pas de méthodes destinées spécialement à modifier la valeur d'une clé ou le mode associé à une propriété. Pour modifier les informations d'une propriété, les applications réécrivent simplement les informations dans la propriété, ce qui revient à mettre à jour les informations dans la propriété. Le mode d'une propriété contrôle les modifications pouvant être exécutées. La modification des paires clé-valeur décrit les restrictions imposées par chaque mode à la modification de la valeur et à la suppression de la propriété. La rubrique Modification des modes décrit les restrictions applicables à la modification du mode.
Modification des modes
- Si le mode en cours est normal, il peut être remplacé par un des trois autres modes : normal fixe, lecture seule, lecture seule fixe.
- Si le mode en cours est normal fixe, il ne peut être remplacé que par le mode lecture seule fixe.
- Si le mode en cours est lecture seule, il ne peut être remplacé que par la suppression de la propriété et la nouvelle création de celle-ci avec le mode désiré.
- Si le mode en cours est lecture seule fixe, il ne peut pas être modifié.
- Si le mode en cours n'est pas normal, il ne peut pas être remplacé par normal. Si une propriété est définie en mode normal fixe, puis redéfinie en mode normal, la valeur est mise à jour mais le mode reste normal fixe. Si une propriété est définie en mode normal fixe, puis redéfinie en mode lecture seule ou lecture seule fixe, la valeur est mise à jour et le mode est remplacé par lecture seule fixe.