Value Object: Praktyczna koncepcja

Czym jest Value Object?

Jak sama nazwa sugeruje, Value Object jest obiektem, który przechowuje wartość i już, to jest całe skrótowe wyjaśnienie. 😄

Ok, co do zasady, to pasuje jeszcze wyjaśnić mniej skrótowo tą koncepcję. Value Object cechuje się tym, że:

• reprezentuje pewną wartość lub zestaw wartości
• reprezentuje pojedyncze pojęcia np. waga, adres zamieszkania (ulica + miasto + kod pocztowy + …), pieniądz (wartość + waluta) itd.
• jego stan nigdy nie może zostać zmieniony => zamiast zmieniać to trzeba utworzyć nowy obiekt z nową wartością – jest to swego rodzaju zabezpieczenie, kiedy do tego samego obiektu mamy dostęp z dwóch (lub więcej) różnych referencji
• jest bez tożsamości – dwa Value Object są równe tylko wtedy kiedy ich wartości są ze sobą równe

Na co mi potrzebny Value Object?

Poza suchą teorią, ja sam nie raz wykorzystuję w swojej pracy Value Object. Dzięki swojej prostocie i łatwiej modyfikacji, można wiele osiągnąć.

Oczywiście, aby w ogóle było łatwiej zrozumieć o co mi chodzi to posłużę się przykładem: Tworzymy aplikację, która ma za zadanie gromadzić informacje o naszym portfelu albo skarbonce i wyświetlać ile to my już mamy odłożonych pieniędzy. Ot takie proste pokazywanie “hajsików” 😉. Tworzymy obiekt pt. “Portfel”, a w nim pole “ilość środków”.

class Wallet {
  private _amount: number;

  constructor(amount: number) {
    this._amount = amount;
  }

  public get amount(): number {
    return this._amount;
  }
}

Wszystko pięknie, ale szybko zauważamy, że jednak to nam nie wystarcza. Przecież w naszym portfelu możemy mieć pieniądze o różnych walutach. Co wtedy?

Dobrze by było jakoś to ogarnąć. Dla uproszczenia załóżmy, że chcemy tylko wyświetlać pieniądze, ani przeliczać, ani łączyć. Utwórzmy zatem mapę, gdzie indeksami będą waluty, a wartościami środki w danej walucie:

class Wallet {
  private _currencies: Map<string, number>;

  constructor(currencies: Map<string, number>) {
    this._currencies = currencies;
  }

  public get currencies(): Map<string, number> {
    return this._currencies;
  }

  public set currencies(value: Map<string, number>) {
    this._currencies = value;
  }
}

Na tym etapie zaczyna nam się robić pewien bałagan. Nie mamy pewności, że tak podana mapa, zawsze będzie prawidłowa oraz to, że wartości będą odpowiednie. Tak w sumie to tej pewności w ogóle nie było od początku.

Na ratunek przychodzi Value Object! 😃

Zacznijmy od skonstruowania klasy “Pieniądze”, dzięki której będziemy mogli tworzyć obiekty z wartościami. Każdy nasz “pieniądz” będzie składał się z wartości “ilość” oraz jednostki “waluty”. Dodatkowo zróbmy też logikę kodu, dzięki której będziemy mogli dodawać pieniądze do naszego portfela. Nasza klasa będzie wyglądała tak:

class Money {
  constructor(private _amount: number, private _currency: string) {}

  public get amount(): number {
    return this._amount;
  }

  public get currency(): string {
    return this._currency;
  }

  public add(money: Money): Money {
    if (money.currency !== this._currency) {
      throw new Error('Cannot add money in different currencies');
    }
    return new Money(this._amount + money.amount, this._currency);
  }
}

Najłatwiej to zrozumieć w taki sposób, że każdy nasz pieniądz przechowujemy w jakieś ilości i w jakiejś walucie.

Ok: czas to zintegrować z naszym portfelem:

class Wallet {
  private _moneyList: Array<Money>;

  constructor(moneyList: Array<Money>) {
    this._moneyList = moneyList;
  }

  public get moneyList(): Array<Money> {
    return this._moneyList;
  }

  public addMoney(money: Money): void {
    const currencyIndex = this._moneyList.findIndex((item) => item.currency === money.currency);
    if (currencyIndex === -1) {
      this._moneyList.push(money);
    } else {
      const existingMoney = this._moneyList[currencyIndex];
      this._moneyList[currencyIndex] = existingMoney.add(money);
    }
  }
}

Dzięki takiej niewiele większej ilości kodu, mamy ustandaryzowane pieniądze i zawsze też wiemy z czego się składają. Nie musimy się też przejmować żadnymi mapami. Dodatkowo ilość potrzebnych argumentów do dodawania pieniędzy wynosi tylko jeden. Przy mapie byłby obowiązek podania poza wartością jeszcze waluty, a tak to tylko podajemy gotowy pieniądz i reszta sama pięknie się ogarnia.

Do naszych pieniędzy możemy teraz dodać wiele przydatnych funkcjonalności bez konieczności modyfikacji portfela. Możemy uwarunkować to, które waluty są obsługiwane, możemy dodać przelicznik walut, a z tym zrobić sumę wszystkich pieniędzy pod jedną wybraną walutę, itd.

Zwięzłe wyjaśnienie Value Object

W przypadku projektowania i implementacji aplikacji, Value Object jest bardzo pomocny. Dzięki niemu możliwe jest lepsze rozdzielenie różnych elementów systemu, co skutkuje większą modularnością i łatwiejszym testowaniem kodu. W przykładzie kodu, Value Object pozwala na przechowywanie i manipulowanie danymi w obiektowej formie, a nie jak w przypadku zwykłych zmiennych. Dzięki temu, kod jest bardziej czytelny i zwięzły. Ponadto, korzystanie z Value Object ułatwia przeprowadzanie refaktoryzacji, co jest kluczowe dla zachowania wysokiej jakości kodu i uniknięcia błędów.

Podsumowanie

W dzisiejszym artykule dowiedzieliśmy się co to jest Value Object i dlaczego warto go stosować. Dajcie znać o tym czy stosujecie go w swoich projektach i do czego już się przydał.

Dziękuję bardzo za to, że jesteście ze mną. Jak coś to pytania proszę podsyłać w komentarzach, wtedy też innym będzie łatwiej uzupełnić wiedzę 😄

Do miłego następnego misiaczki kolorowe 🧸