Co to jest "ownerID" w pliku Immutable.js?

Question

Przechodzę przez kod źródłowy Immutable.js i istnieje pole ownerID, którego nie rozumiem.

Oto źródło Map.asMutable() i Map.asImmutable(): https://github.com/facebook/immutable-js/blob/master/src/Map.js#L171

Wydaje się, że jedyną różnicą pomiędzy zmienny i niezmiennej obiektu są ich ownerID s. Co to jest ownerID i do czego służy?

Answer 1

Jeśli utwór z powrotem własności:

L # 14:

import { DELETE, SHIFT, SIZE, MASK, NOT_SET, CHANGE_LENGTH, DID_ALTER, OwnerID, 
      MakeRef, SetRef, arrCopy } from './TrieUtils' 

w src/TrieUtils.js:

L # 36:

// A function which returns a value representing an "owner" for transient writes 
// to tries. The return value will only ever equal itself, and will not equal 
// the return of any subsequent call of this function. 
export function OwnerID() {} 

Jest to jakaś własność, którą tworzą jak hash reprezentujący wirtualnego właściciela.

Answer 2

Z source code:

// A function which returns a value representing an "owner" for transient writes 
// to tries. The return value will only ever equal itself, and will not equal 
// the return of any subsequent call of this function. 
function OwnerID() {} 

Moje rozumienie powyższego jest, że pole this.__ownerID używana jest do porównywania obiektów. Porównywany z samym sobą Map będzie miał ten sam ownerID, podczas gdy Map porównywany z innym Map będzie widział dwa różne ownerID s.

można zobaczyć przykład tego Użycie A little farther down in the file in question:

__ensureOwner(ownerID) { 
    if (ownerID === this.__ownerID) { 
    return this; 
    } 
    if (!ownerID) { 
    this.__ownerID = ownerID; 
    this.__altered = false; 
    return this; 
    } 
    return makeMap(this.size, this._root, ownerID, this.__hash); 
} 

W rzeczywistości, searching the entire repo, zobaczysz, że funkcja ta jest wspólna dla różnych typów danych, a każdy typ ma wersję nieco zmodyfikowaną, aby powrócić poprawna nowa wersja tego typu.

Answer 3

Służy do zapewnienia wartości zmienności w asMutable zwróconych instancji. Kiedy asMutable jest wywoływany, zapewnia ona __ownerId i zwraca bieżącą instancję back -

asMutable() { 
    return this.__ownerID ? this : this.__ensureOwner(new OwnerID()); 
} 

Wtedy wszelkie supported operacje mutowania powrócić bieżące wystąpienie z powrotem, zamiast tworzenia nowej instancji ze zmianami (co jest kluczem do niezmienności) .

przykład, oto jak „czysty” sposób działa na podstawie obecności __ownerId -

clear() { 
    if (this.size === 0) { 
     return this; 
    } 
    if (this.__ownerID) { 
     this.size = 0; 
     this._root = null; 
     this.__hash = undefined; 
     this.__altered = true; 
     return this; 
    } 
    return emptyMap(); 
} 

Zauważ, że gdy ten .__ ownerid jest obecna metoda zwraca bieżącą instancję (co mutacji się) . Ale gdy jest nieobecny, zwraca nową mapę dla zapewnienia niezmienności.