[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"$f3f4hbncvq249s":3,"$f13vdpth9iqj8j":108},{"data":4},[5],{"id":6,"slug":7,"locale":8,"type":9,"title":10,"subtitle":11,"summary":12,"body":13,"primary_topic":14,"knowledge_status":15,"practical_validation":16,"workflow_status":17,"author_id":18,"published_at":19,"updated_at":20,"review_due_at":18,"canonical_url":18,"seo_title":21,"seo_description":12,"hero_asset_id":18,"reading_time":22,"version":23,"technology_versions":24,"review_frequency_days":18,"parent_content_id":25,"sort_in_parent":26,"hub_entry_status":27,"content_blocks":28,"hero_alt_text":18,"hero_caption":18,"hero_credit":18,"publication_scope":100,"access_level":101,"approved_at":18,"approved_by":18,"review_note":18,"home_enabled":102,"home_slot":103,"home_variant":104,"home_priority":105,"home_eyebrow":18,"home_valid_from":18,"home_valid_to":18,"home_image_asset_id":18,"promotion_kind":106,"sponsor_name":18,"sponsor_url":18,"sponsor_disclosure":107},"7503adac-560f-42bb-876a-49f25456057d","microservizi-controller","it","CAPSULE","Controller","Internal Service Architecture","Limitare il Controller al protocollo: parsing e validazione superficiale della request, invocazione del caso d'uso, mapping della response e gestione degli status HTTP.","Famiglia: Internal Service Architecture\nOrigine contenuto: Approfondimento integrativo costruito sui materiali architetturali del progetto.\n\nProblema\nLa logica HTTP e la logica di business tendono a mescolarsi, rendendo il servizio difficile da testare e riusare.\n\nPattern\nLimitare il Controller al protocollo: parsing e validazione superficiale della request, invocazione del caso d'uso, mapping della response e gestione degli status HTTP.\n\nCome funziona\nIl Controller traduce HTTP in un comando o query applicativa. Autorizzazione e validation possono avere componenti dedicati, ma le regole di dominio non devono essere codificate negli endpoint.\n\nEsempio sanitario\nPOST \u002Forders valida forma e autenticazione, crea CreateOrderCommand e delega a CreateOrderService.\n\nBenefici\n• Endpoint sottili\n• Testabilità\n• Separazione protocollo\u002Fdominio\n\nTrade-off\n• Può diventare boilerplate\n• Serve disciplina per non inserire business logic\n\nQuando usarlo\nPer ogni API HTTP non banale.\n\nQuando evitarlo\nQuando si usa il Controller come Service Layer.\n\nPattern correlati\n• microservizi-dto\n• microservizi-service-layer\n","73f97745-5500-41e9-9bc7-a0d7a441f2bc","DEEPENED","EXAMPLE_ONLY","PUBLISHED",null,"2026-08-27T19:12:02.157Z","2026-09-05T13:22:19.783Z","Controller | Capsule Informatiche",6,4,{},"20676d31-9c90-432e-b23c-032bf2ba2a49",900,"PLANNED",[29,33,37,41,44,46,49,52,55,58,61,65,68,71,74,77,80,83,86],{"id":30,"text":31,"type":32},"ms-controller-01","Famiglia: Architettura applicativa · Approfondimento","callout",{"id":34,"text":35,"type":36},"ms-controller-02","Il problema","heading2",{"id":38,"text":39,"type":40},"ms-controller-03","La logica HTTP e la logica di business tendono a mescolarsi, rendendo il servizio difficile da testare e riusare.","paragraph",{"id":42,"text":43,"type":36},"ms-controller-04","Il pattern",{"id":45,"text":12,"type":40},"ms-controller-05",{"id":47,"text":48,"type":36},"ms-controller-06","Come funziona",{"id":50,"text":51,"type":40},"ms-controller-07","Il Controller traduce HTTP in un comando o query applicativa. Autorizzazione e validation possono avere componenti dedicati, ma le regole di dominio non devono essere codificate negli endpoint.",{"id":53,"text":54,"type":36},"ms-controller-08","Esempio sanitario",{"id":56,"text":57,"type":32},"ms-controller-09","POST \u002Forders valida forma e autenticazione, crea CreateOrderCommand e delega a CreateOrderService.",{"id":59,"text":60,"type":36},"ms-controller-10","Benefici",{"id":62,"type":63,"items":64},"ms-controller-11","bullet_list","Endpoint sottili\nTestabilità\nSeparazione protocollo\u002Fdominio",{"id":66,"text":67,"type":36},"ms-controller-12","Trade-off",{"id":69,"type":63,"items":70},"ms-controller-13","Può diventare boilerplate\nServe disciplina per non inserire business logic",{"id":72,"text":73,"type":36},"ms-controller-14","Quando usarlo",{"id":75,"text":76,"type":40},"ms-controller-15","Per ogni API HTTP non banale.",{"id":78,"text":79,"type":36},"ms-controller-16","Quando evitarlo",{"id":81,"text":82,"type":40},"ms-controller-17","Quando si usa il Controller come Service Layer.",{"id":84,"text":85,"type":36},"ms-controller-18","Pattern correlati",{"id":87,"type":88,"relations":89},"ms-controller-19","related_capsules",[90,95],{"slug":91,"title":92,"summary":93,"contentId":94},"microservizi-dto","DTO","Usare Data Transfer Object espliciti per request e response, versionabili indipendentemente dal modello interno.","b5b94c3a-4f8d-4fdc-8443-fa8f1fa5e41f",{"slug":96,"title":97,"summary":98,"contentId":99},"microservizi-service-layer","Service Layer \u002F Application Service","Usare un Application Service per implementare il caso d'uso e delimitare la transazione locale.","231d1683-6ff0-4c80-8b51-454493fe16a0","PORTAL","ANONYMOUS",false,"LATEST","AUTO",0,"EDITORIAL","Sponsorizzato",{"sources":109,"secondaryTopics":125,"tags":126,"primaryTopic":147,"technologies":151},[110,118],{"source_id":111},{"id":112,"type":113,"title":114,"author":18,"publisher":115,"edition":116,"url":18,"license_notes":117},"dfb11314-30d0-40ad-b93e-431188a3d6f0","PROJECT_NOTE","Riepilogo architetture piattaforma enterprise sanitaria","Capsule Informatiche","Materiale progettuale","Materiale progettuale già analizzato nel progetto Capsule Informatiche. Usato come riferimento integrativo per esempi sanitari e pattern moderni.",{"source_id":119},{"id":120,"type":121,"title":122,"author":18,"publisher":18,"edition":123,"url":18,"license_notes":124},"dffdee39-b493-4374-9ed8-ace3f16bb789","PDF","JavaScript Domain-Driven Design","Materiale di studio","Materiale di studio già caricato. Usato come riferimento integrativo per DDD, bounded context, modularità e separazione del dominio.",[],[127,132,137,142],{"tag_id":128},{"id":129,"name":130,"slug":131},"a94e416a-7400-4ff4-8671-a2fc5635c4e0","Microservizi","microservizi",{"tag_id":133},{"id":134,"name":135,"slug":136},"74df0420-fe01-463d-84f1-79bbc7ee7114","Design Pattern","design-pattern",{"tag_id":138},{"id":139,"name":140,"slug":141},"2cfaf938-ab4e-40ac-bbdf-265eda0b656a","API","api",{"tag_id":143},{"id":144,"name":145,"slug":146},"43524fb2-d0fe-4b4b-8143-137f73c134b5","DDD","ddd",[148],{"id":14,"name":149,"slug":150},"Architettura Applicativa","architettura-applicativa",[152,158],{"technology_id":153},{"id":154,"name":155,"slug":156,"vendor":157},"39cdf97c-a2aa-43ee-9aa0-15ea178c0f97","Java","java","Oracle \u002F OpenJDK",{"technology_id":159},{"id":160,"name":161,"slug":162,"vendor":163},"36e283e6-d1d9-4e62-a4b1-9d14f05b7e23","Spring Boot","spring-boot","Broadcom"]