{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-value-object",
  "id": "value-object",
  "kind": "pattern",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-domain-modeling",
    "json": "https://banes-lab.com/json/records/layer/domain-modeling",
    "label": "Domain Modeling",
    "markdown": "https://banes-lab.com/records/layer/domain-modeling.md",
    "ref": "layer:domain-modeling"
  },
  "name": "Value Object",
  "ref": "architecture:value-object",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-value-equality",
          "json": "https://banes-lab.com/json/records/lexicon/value-equality",
          "label": "Value Equality",
          "markdown": "https://banes-lab.com/records/lexicon/value-equality.md",
          "ref": "lexicon:value-equality"
        }
      ],
      "relation": "requires"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-immutability",
          "json": "https://banes-lab.com/json/records/architecture/immutability",
          "label": "Immutability",
          "markdown": "https://banes-lab.com/records/architecture/immutability.md",
          "ref": "architecture:immutability"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-encapsulation",
          "json": "https://banes-lab.com/json/records/architecture/encapsulation",
          "label": "Encapsulation",
          "markdown": "https://banes-lab.com/records/architecture/encapsulation.md",
          "ref": "architecture:encapsulation"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-self-validating-values",
          "json": "https://banes-lab.com/json/records/lexicon/self-validating-values",
          "label": "Self-Validating Values",
          "markdown": "https://banes-lab.com/records/lexicon/self-validating-values.md",
          "ref": "lexicon:self-validating-values"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-side-effect-free-equality",
          "json": "https://banes-lab.com/json/records/lexicon/side-effect-free-equality",
          "label": "Side-Effect-Free Equality",
          "markdown": "https://banes-lab.com/records/lexicon/side-effect-free-equality.md",
          "ref": "lexicon:side-effect-free-equality"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-primitive-obsession",
          "json": "https://banes-lab.com/json/records/architecture/primitive-obsession",
          "label": "Primitive Obsession",
          "markdown": "https://banes-lab.com/records/architecture/primitive-obsession.md",
          "ref": "architecture:primitive-obsession"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-data-clumps",
          "json": "https://banes-lab.com/json/records/architecture/data-clumps",
          "label": "Data Clumps",
          "markdown": "https://banes-lab.com/records/architecture/data-clumps.md",
          "ref": "architecture:data-clumps"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-long-parameter-list",
          "json": "https://banes-lab.com/json/records/architecture/long-parameter-list",
          "label": "Long Parameter List",
          "markdown": "https://banes-lab.com/records/architecture/long-parameter-list.md",
          "ref": "architecture:long-parameter-list"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-object-count",
          "json": "https://banes-lab.com/json/records/lexicon/object-count",
          "label": "Object Count",
          "markdown": "https://banes-lab.com/records/lexicon/object-count.md",
          "ref": "lexicon:object-count"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-entity",
          "json": "https://banes-lab.com/json/records/architecture/entity",
          "label": "Entity",
          "markdown": "https://banes-lab.com/records/architecture/entity.md",
          "ref": "architecture:entity"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#tension-entity-value-object",
          "json": "https://banes-lab.com/json/records/tension/entity-value-object",
          "label": "Entity / Value Object",
          "markdown": "https://banes-lab.com/records/tension/entity-value-object.md",
          "ref": "tension:entity-value-object"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-object-count-value-object",
          "json": "https://banes-lab.com/json/records/tension/object-count-value-object",
          "label": "Value Object / Object Count",
          "markdown": "https://banes-lab.com/records/tension/object-count-value-object.md",
          "ref": "tension:object-count-value-object"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-primitive-obsession",
          "json": "https://banes-lab.com/json/records/architecture/primitive-obsession",
          "label": "Primitive Obsession",
          "markdown": "https://banes-lab.com/records/architecture/primitive-obsession.md",
          "ref": "architecture:primitive-obsession"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#vocabulary-severity-recommended",
          "json": "https://banes-lab.com/json/records/vocabulary/severity-recommended",
          "label": "recommended",
          "markdown": "https://banes-lab.com/records/vocabulary/severity-recommended.md",
          "ref": "vocabulary:severity-recommended"
        }
      ],
      "relation": "severity"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-domain-architecture",
          "json": "https://banes-lab.com/json/records/architecture-category/domain-architecture",
          "label": "Domain Architecture",
          "markdown": "https://banes-lab.com/records/architecture-category/domain-architecture.md",
          "ref": "architecture-category:domain-architecture"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-anemic-domain-model",
          "json": "https://banes-lab.com/json/records/architecture/anemic-domain-model",
          "label": "Anemic Domain Model",
          "markdown": "https://banes-lab.com/records/architecture/anemic-domain-model.md",
          "ref": "architecture:anemic-domain-model"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-utility-dump",
          "json": "https://banes-lab.com/json/records/architecture/utility-dump",
          "label": "Utility Dump",
          "markdown": "https://banes-lab.com/records/architecture/utility-dump.md",
          "ref": "architecture:utility-dump"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-domain-model",
          "json": "https://banes-lab.com/json/records/architecture/domain-model",
          "label": "Domain Model",
          "markdown": "https://banes-lab.com/records/architecture/domain-model.md",
          "ref": "architecture:domain-model"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-intent-revealing-interface",
          "json": "https://banes-lab.com/json/records/architecture/intent-revealing-interface",
          "label": "Intent-Revealing Interface",
          "markdown": "https://banes-lab.com/records/architecture/intent-revealing-interface.md",
          "ref": "architecture:intent-revealing-interface"
        }
      ],
      "relation": "refactors"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-anti-patterns",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-anti-patterns",
          "label": "Anti-patterns",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-anti-patterns.md",
          "ref": "chapter:/ontology#architecture-category-anti-patterns"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-domain-architecture",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-domain-architecture",
          "label": "Domain Architecture",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-domain-architecture.md",
          "ref": "chapter:/ontology#architecture-category-domain-architecture"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-correctness-determinism-verification",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-correctness-determinism-verification",
          "label": "Correctness / Determinism / Verification",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-correctness-determinism-verification.md",
          "ref": "chapter:/ontology#architecture-category-correctness-determinism-verification"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-core-modular-design",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-core-modular-design",
          "label": "Core Modular Design",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-core-modular-design.md",
          "ref": "chapter:/ontology#architecture-category-core-modular-design"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-schema-canonical-data-semantics",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-schema-canonical-data-semantics",
          "label": "Schema / Canonical Data / Semantics",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-schema-canonical-data-semantics.md",
          "ref": "chapter:/ontology#architecture-category-schema-canonical-data-semantics"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-domain-architecture",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-domain-architecture",
          "label": "Domain Architecture",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-domain-architecture.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-domain-architecture"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-vocabulary-severity",
          "json": "https://banes-lab.com/json/ontology/schema/the-vocabulary-severity",
          "label": "Severity levels",
          "markdown": "https://banes-lab.com/ontology/schema/the-vocabulary-severity.md",
          "ref": "chapter:/ontology/schema#the-vocabulary-severity"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-resolutions",
          "json": "https://banes-lab.com/json/ontology/schema/the-resolutions",
          "label": "The resolutions",
          "markdown": "https://banes-lab.com/ontology/schema/the-resolutions.md",
          "ref": "chapter:/ontology/schema#the-resolutions"
        }
      ],
      "relation": "linked-from"
    }
  ],
  "summary": "A design pattern that models a domain value as an immutable, self-validating object compared by its attributes.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-entity",
      "json": "https://banes-lab.com/json/records/architecture/entity",
      "label": "Entity",
      "markdown": "https://banes-lab.com/records/architecture/entity.md",
      "ref": "architecture:entity"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-aggregate",
      "json": "https://banes-lab.com/json/records/architecture/aggregate",
      "label": "Aggregate",
      "markdown": "https://banes-lab.com/records/architecture/aggregate.md",
      "ref": "architecture:aggregate"
    }
  },
  "up": {
    "href": null,
    "json": "https://banes-lab.com/json/api/records/architecture",
    "label": "Architecture principles",
    "markdown": "https://banes-lab.com/api/records/architecture.md",
    "ref": "api:records/architecture"
  },
  "aliases": [],
  "exemplar": {
    "after": "class Money {\n  private constructor(readonly amount: number, readonly currency: string) {}\n  static of(amount: number, currency: string): Money {\n    if (amount < 0) throw new Error(\"negative money\");\n    return new Money(amount, currency);\n  }\n  equals(other: Money) { return this.amount === other.amount && this.currency === other.currency; }\n  add(other: Money): Money { return Money.of(this.amount + other.amount, this.currency); }\n}",
    "before": "function priceFoo(amount: number, currency: string) { return { amount, currency }; }",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "domain",
    "modeling",
    "immutability"
  ],
  "severity": "recommended"
}