{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-ports-and-adapters-architecture",
  "id": "ports-and-adapters-architecture",
  "kind": "style",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-structural-core",
    "json": "https://banes-lab.com/json/records/layer/structural-core",
    "label": "Structural Core",
    "markdown": "https://banes-lab.com/records/layer/structural-core.md",
    "ref": "layer:structural-core"
  },
  "name": "Ports and Adapters Architecture",
  "ref": "architecture:ports-and-adapters-architecture",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-ports",
          "json": "https://banes-lab.com/json/records/lexicon/ports",
          "label": "Ports",
          "markdown": "https://banes-lab.com/records/lexicon/ports.md",
          "ref": "lexicon:ports"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-adapters",
          "json": "https://banes-lab.com/json/records/lexicon/adapters",
          "label": "Adapters",
          "markdown": "https://banes-lab.com/records/lexicon/adapters.md",
          "ref": "lexicon:adapters"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-dependency-inversion",
          "json": "https://banes-lab.com/json/records/architecture/dependency-inversion",
          "label": "Dependency Inversion Principle (DIP)",
          "markdown": "https://banes-lab.com/records/architecture/dependency-inversion.md",
          "ref": "architecture:dependency-inversion"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-domain-core",
          "json": "https://banes-lab.com/json/records/lexicon/domain-core",
          "label": "Domain Core",
          "markdown": "https://banes-lab.com/records/lexicon/domain-core.md",
          "ref": "lexicon:domain-core"
        }
      ],
      "relation": "requires"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-replaceability",
          "json": "https://banes-lab.com/json/records/architecture/replaceability",
          "label": "Replaceability",
          "markdown": "https://banes-lab.com/records/architecture/replaceability.md",
          "ref": "architecture:replaceability"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-testability",
          "json": "https://banes-lab.com/json/records/architecture/testability",
          "label": "Testability",
          "markdown": "https://banes-lab.com/records/architecture/testability.md",
          "ref": "architecture:testability"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-clean-architecture",
          "json": "https://banes-lab.com/json/records/architecture/clean-architecture",
          "label": "Clean Architecture",
          "markdown": "https://banes-lab.com/records/architecture/clean-architecture.md",
          "ref": "architecture:clean-architecture"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-infrastructure-independence",
          "json": "https://banes-lab.com/json/records/lexicon/infrastructure-independence",
          "label": "Infrastructure Independence",
          "markdown": "https://banes-lab.com/records/lexicon/infrastructure-independence.md",
          "ref": "lexicon:infrastructure-independence"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-external-system-isolation",
          "json": "https://banes-lab.com/json/records/lexicon/external-system-isolation",
          "label": "External System Isolation",
          "markdown": "https://banes-lab.com/records/lexicon/external-system-isolation.md",
          "ref": "lexicon:external-system-isolation"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-framework-leakage",
          "json": "https://banes-lab.com/json/records/architecture/framework-leakage",
          "label": "Framework Leakage",
          "markdown": "https://banes-lab.com/records/architecture/framework-leakage.md",
          "ref": "architecture:framework-leakage"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-boilerplate",
          "json": "https://banes-lab.com/json/records/lexicon/boilerplate",
          "label": "Boilerplate",
          "markdown": "https://banes-lab.com/records/lexicon/boilerplate.md",
          "ref": "lexicon:boilerplate"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-initial-complexity",
          "json": "https://banes-lab.com/json/records/lexicon/initial-complexity",
          "label": "Initial Complexity",
          "markdown": "https://banes-lab.com/records/lexicon/initial-complexity.md",
          "ref": "lexicon:initial-complexity"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-boilerplate-ports-and-adapters-architecture",
          "json": "https://banes-lab.com/json/records/tension/boilerplate-ports-and-adapters-architecture",
          "label": "Ports and Adapters Architecture / Boilerplate",
          "markdown": "https://banes-lab.com/records/tension/boilerplate-ports-and-adapters-architecture.md",
          "ref": "tension:boilerplate-ports-and-adapters-architecture"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#tension-initial-complexity-ports-and-adapters-architecture",
          "json": "https://banes-lab.com/json/records/tension/initial-complexity-ports-and-adapters-architecture",
          "label": "Ports and Adapters Architecture / Initial Complexity",
          "markdown": "https://banes-lab.com/records/tension/initial-complexity-ports-and-adapters-architecture.md",
          "ref": "tension:initial-complexity-ports-and-adapters-architecture"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-concrete-coupling",
          "json": "https://banes-lab.com/json/records/architecture/concrete-coupling",
          "label": "Concrete Coupling",
          "markdown": "https://banes-lab.com/records/architecture/concrete-coupling.md",
          "ref": "architecture:concrete-coupling"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-framework-leakage",
          "json": "https://banes-lab.com/json/records/architecture/framework-leakage",
          "label": "Framework Leakage",
          "markdown": "https://banes-lab.com/records/architecture/framework-leakage.md",
          "ref": "architecture:framework-leakage"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-introduce-port",
          "json": "https://banes-lab.com/json/records/lexicon/introduce-port",
          "label": "Introduce Port",
          "markdown": "https://banes-lab.com/records/lexicon/introduce-port.md",
          "ref": "lexicon:introduce-port"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-extract-adapter",
          "json": "https://banes-lab.com/json/records/lexicon/extract-adapter",
          "label": "Extract Adapter",
          "markdown": "https://banes-lab.com/records/lexicon/extract-adapter.md",
          "ref": "lexicon:extract-adapter"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-move-framework-outward",
          "json": "https://banes-lab.com/json/records/lexicon/move-framework-outward",
          "label": "Move Framework Outward",
          "markdown": "https://banes-lab.com/records/lexicon/move-framework-outward.md",
          "ref": "lexicon:move-framework-outward"
        }
      ],
      "relation": "refactored-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-codebase-system-architecture-styles",
          "json": "https://banes-lab.com/json/records/architecture-category/codebase-system-architecture-styles",
          "label": "Codebase / System Architecture Styles",
          "markdown": "https://banes-lab.com/records/architecture-category/codebase-system-architecture-styles.md",
          "ref": "architecture-category:codebase-system-architecture-styles"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/software-architecture#the-layer-spine",
          "json": "https://banes-lab.com/json/software-architecture/model/the-layer-spine",
          "label": "The layer spine",
          "markdown": "https://banes-lab.com/software-architecture/model/the-layer-spine.md",
          "ref": "chapter:/software-architecture#the-layer-spine"
        },
        {
          "href": "https://banes-lab.com/software-architecture#the-direction-axis",
          "json": "https://banes-lab.com/json/software-architecture/model/the-direction-axis",
          "label": "The direction axis",
          "markdown": "https://banes-lab.com/software-architecture/model/the-direction-axis.md",
          "ref": "chapter:/software-architecture#the-direction-axis"
        },
        {
          "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-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-solid-object-oriented-design",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-solid-object-oriented-design",
          "label": "SOLID / Object-Oriented Design",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-solid-object-oriented-design.md",
          "ref": "chapter:/ontology#architecture-category-solid-object-oriented-design"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-plugin-extensibility-ioc",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-plugin-extensibility-ioc",
          "label": "Plugin / Extensibility / IoC",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-plugin-extensibility-ioc.md",
          "ref": "chapter:/ontology#architecture-category-plugin-extensibility-ioc"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-codebase-system-architecture-styles",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-codebase-system-architecture-styles",
          "label": "Codebase / System Architecture Styles",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-codebase-system-architecture-styles.md",
          "ref": "chapter:/ontology#architecture-category-codebase-system-architecture-styles"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-codebase-system-architecture-styles",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-codebase-system-architecture-styles",
          "label": "Codebase / System Architecture Styles",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-codebase-system-architecture-styles.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-codebase-system-architecture-styles"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-core-vocabulary",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-core-vocabulary",
          "label": "Core Vocabulary",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-core-vocabulary.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-core-vocabulary"
        },
        {
          "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 convention of keeping a domain core free of framework and data types, with every external dependency behind a port the application owns and implemented by an adapter outside it.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-clean-architecture",
      "json": "https://banes-lab.com/json/records/architecture/clean-architecture",
      "label": "Clean Architecture",
      "markdown": "https://banes-lab.com/records/architecture/clean-architecture.md",
      "ref": "architecture:clean-architecture"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-session-management",
      "json": "https://banes-lab.com/json/records/architecture/session-management",
      "label": "Session Management",
      "markdown": "https://banes-lab.com/records/architecture/session-management.md",
      "ref": "architecture:session-management"
    }
  },
  "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": [
    "Hexagonal Architecture",
    "Ports and Adapters"
  ],
  "exemplar": {
    "after": "interface SaveFooPort { save(foo: Foo): Promise<void>; }\nclass FooService {\n  constructor(private readonly port: SaveFooPort) {}\n  save(foo: Foo) { return this.port.save(foo); }\n}\nclass SqlFooAdapter implements SaveFooPort { save(foo: Foo) { return sqlFooStore.save(foo); } }",
    "before": "class FooService {\n  save(foo: Foo) { return sql.query(\"insert into foo values (?)\", foo); }\n}",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "application",
    "service",
    "component"
  ],
  "severity": "recommended"
}