AbstractPreferences.Node(String) Methode

[Android.Runtime.Register("node", "(Ljava/lang/String;)Ljava/util/prefs/Preferences;", "GetNode_Ljava_lang_String_Handler")]
public override Java.Util.Prefs.Preferences? Node(string? path);

[<Android.Runtime.Register("node", "(Ljava/lang/String;)Ljava/util/prefs/Preferences;", "GetNode_Ljava_lang_String_Handler")>]
override this.Node : string -> Java.Util.Prefs.Preferences

Parameter

Gibt zurück

der angegebene Einstellungsknoten.

Attribute

RegisterAttribute

Hinweise

Implementiert die node Methode gemäß der Spezifikation in Preferences#node(String).

Diese Implementierung ruft die Sperre dieses Einstellungsknotens ab und überprüft, ob der Knoten nicht entfernt wurde. Ist path dies ""der Fall, wird dieser Knoten zurückgegeben. Ist path dies der "/"Fall, wird der Stamm dieses Knotens zurückgegeben. Wenn das erste Zeichen path nicht '/'angegeben ist, durchbricht path die Implementierung in Token und durchläuft rekursiv den Pfad von diesem Knoten zum benannten Knoten, "verbrauchen" einen Namen und einen Schrägstrich in path jedem Schritt der Durchquerung. Bei jedem Schritt ist der aktuelle Knoten gesperrt, und der untergeordnete Cache des Knotens wird auf den benannten Knoten überprüft. Wenn er nicht gefunden wird, wird der Name überprüft, um sicherzustellen, dass seine Länge nicht überschritten wird MAX_NAME_LENGTH. Anschließend wird die #childSpi(String) Methode aufgerufen und das Ergebnis im untergeordneten Cache dieses Knotens gespeichert. Wenn das Feld des neu erstellten Preferences Objekts vorhanden ist #newNode und Knotenänderungslistener vorhanden sind, wird ein Benachrichtigungsereignis true zur Verarbeitung durch den Ereignisverteilerthread abgefragt.

Wenn keine weiteren Token vorhanden sind, wird der letzte Wert im untergeordneten Cache gefunden oder von childSpi dieser Methode zurückgegeben. Wenn während der Durchquerung zwei "/" Token aufeinander folgen oder das endgültige Token "/" (anstelle eines Namens) erfolgt, wird ein entsprechender IllegalArgumentException Ausgelöst.

Wenn das erste Zeichen ( path'/' das einen absoluten Pfadnamen angibt) ist, wird die Sperre dieses Einstellungsknotens vor dem Aufbrechen path in Token abgelegt, und diese Methode durchläuft den Pfad rekursiv beginnend mit dem Stamm (anstatt mit diesem Knoten zu beginnen). Die Durchquerung ist andernfalls identisch mit der für relative Pfadnamen beschriebenen. Das Ablegen der Sperre auf diesem Knoten vor dem Starten der Traversale am Stammknoten ist unerlässlich, um die Möglichkeit eines Deadlocks gemäß den #lock locking invariant.

Java Dokumentation für java.util.prefs.AbstractPreferences.node(java.lang.String).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.