{"id":9362,"date":"2023-11-21T11:03:19","date_gmt":"2023-11-21T14:03:19","guid":{"rendered":"https:\/\/elemarjr.com\/clube-de-estudos\/?post_type=artigos&p=9362"},"modified":"2023-12-27T08:55:50","modified_gmt":"2023-12-27T11:55:50","slug":"ddd-ajuda-a-pensar-em-rest-do-jeito-certo","status":"publish","type":"artigos","link":"https:\/\/elemarjr.com\/clube-de-estudos\/artigos\/ddd-ajuda-a-pensar-em-rest-do-jeito-certo\/","title":{"rendered":"DDD Ajuda a Pensar em REST do Jeito Certo"},"content":{"rendered":"\n

Explorar a interse\u00e7\u00e3o de REST<\/em> e Domain-driven Design<\/em> (DDD) pode abrir um novo horizonte na maneira como estruturamos APIs. REST \u00e9 uma arquitetura escolhida por muitos para criar APIs na web devido \u00e0 sua simplicidade e efici\u00eancia. Por outro lado, DDD proporciona um foco intensivo no dom\u00ednio e na l\u00f3gica do neg\u00f3cio, algo que podemos usar para refinar e estruturar melhor nosso design de API.<\/p>\n\n\n\n

A Simbiose de REST e DDD<\/h2>\n\n\n\n

Como podemos alinhar os recursos de uma API REST com o modelo de dom\u00ednio do neg\u00f3cio usando DDD? A resposta passa pela percep\u00e7\u00e3o de que os recursos expostos pela API devem refletir os agregados definidos no DDD. Essa conex\u00e3o n\u00e3o s\u00f3 melhora a consist\u00eancia, mas tamb\u00e9m alinha a interface tecnol\u00f3gica com as necessidades do neg\u00f3cio.<\/p>\n\n\n\n

Agregados e Recursos REST<\/h2>\n\n\n\n

Os agregados s\u00e3o um conceito central em DDD, agrupando entidades e objetos de valor que se relacionam e s\u00e3o tratados como uma unidade. Suponha que temos um agregado chamado ‘Pedido’, que inclui itens, uma refer\u00eancia ao cliente e informa\u00e7\u00f5es de pagamento.<\/p>\n\n\n\n

Em REST, este agregado pode ser representado como um recurso com endpoints como:<\/p>\n\n\n\n

    \n
  • GET \/orders\/{id}<\/code>: para recuperar um pedido espec\u00edfico.<\/li>\n\n\n\n
  • POST \/orders<\/code>: para criar um novo pedido.<\/li>\n\n\n\n
  • PUT \/orders\/{id}<\/code>: para atualizar um pedido existente.<\/li>\n<\/ul>\n\n\n\n

    No c\u00f3digo C#, isso pode ser representado por uma classe Order<\/code> e m\u00e9todos correspondentes em um controlador:<\/p>\n\n\n\n

    <\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
    public<\/span> <\/span>class<\/span> <\/span>Order<\/span><\/span>\n{<\/span><\/span>\n    <\/span>public<\/span> Guid Id <\/span>{<\/span> <\/span>get;<\/span> <\/span>set;<\/span> <\/span>}<\/span><\/span>\n    <\/span>public<\/span> Customer Customer <\/span>{<\/span> <\/span>get;<\/span> <\/span>set;<\/span> <\/span>}<\/span><\/span>\n    <\/span>public<\/span> List<\/span><<\/span>Item<\/span>><\/span> Items <\/span>{<\/span> <\/span>get;<\/span> <\/span>set;<\/span> <\/span>}<\/span><\/span>\n    <\/span>public<\/span> Payment Payment <\/span>{<\/span> <\/span>get;<\/span> <\/span>set;<\/span> <\/span>}<\/span><\/span>\n}<\/span><\/span>\n<\/span>\n[<\/span>Route<\/span>(<\/span>"<\/span>api\/orders<\/span>"<\/span>)]<\/span><\/span>\npublic<\/span> <\/span>class<\/span> <\/span>OrdersController<\/span> <\/span>:<\/span> ApiController<\/span><\/span>\n{<\/span><\/span>\n    <\/span>[<\/span>HttpGet<\/span>(<\/span>"<\/span>{id}<\/span>"<\/span>)]<\/span><\/span>\n    <\/span>public<\/span> IActionResult <\/span>GetOrder<\/span>(<\/span>Guid id<\/span>)<\/span><\/span>\n    <\/span>{<\/span><\/span>\n        <\/span>\/\/ Implementa\u00e7\u00e3o para recuperar um pedido<\/span><\/span>\n    <\/span>}<\/span><\/span>\n<\/span>\n    <\/span>[<\/span>HttpPost<\/span>]<\/span><\/span>\n    <\/span>public<\/span> IActionResult <\/span>CreateOrder<\/span>([<\/span>FromBody<\/span>]<\/span> Order order<\/span>)<\/span><\/span>\n    <\/span>{<\/span><\/span>\n        <\/span>\/\/ Implementa\u00e7\u00e3o para criar um novo pedido<\/span><\/span>\n    <\/span>}<\/span><\/span>\n<\/span>\n    <\/span>[<\/span>HttpPut<\/span>(<\/span>"<\/span>{id}<\/span>"<\/span>)]<\/span><\/span>\n    <\/span>public<\/span> IActionResult <\/span>UpdateOrder<\/span>(<\/span>Guid id<\/span>,<\/span> <\/span>[<\/span>FromBody<\/span>]<\/span> Order order<\/span>)<\/span><\/span>\n    <\/span>{<\/span><\/span>\n        <\/span>\/\/ Implementa\u00e7\u00e3o para atualizar um pedido<\/span><\/span>\n    <\/span>}<\/span><\/span>\n}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
    Essa abordagem garante que os recursos da API estejam fortemente vinculados ao modelo do dom\u00ednio e mantenham a integridade e as regras de neg\u00f3cio contidas nos agregados.<\/p>\n\n\n\n
    REST Alinhado com o Neg\u00f3cio<\/h2>\n\n\n\n
    Utilizar DDD como base para modelar uma API REST garante que cada recurso fa\u00e7a sentido dentro do contexto maior do neg\u00f3cio. Isso n\u00e3o apenas facilita o entendimento da API para os desenvolvedores e stakeholders, mas tamb\u00e9m promove uma integra\u00e7\u00e3o mais natural com outros sistemas e uma evolu\u00e7\u00e3o mais sustent\u00e1vel da aplica\u00e7\u00e3o.<\/p>\n\n\n\n
    Conclus\u00e3o<\/h2>\n\n\n\n
    A aplica\u00e7\u00e3o de DDD no design de APIs RESTful n\u00e3o \u00e9 apenas uma metodologia; ela \u00e9 um reflexo da estrat\u00e9gia do neg\u00f3cio traduzida em tecnologia. Os agregados ajudam a definir os recursos da API de maneira clara, promovendo a consist\u00eancia e a modulariza\u00e7\u00e3o. Essa simbiose entre REST e DDD fornece uma estrutura significativa para a cria\u00e7\u00e3o de APIs robustas e alinhadas com o modelo de neg\u00f3cio.<\/p>\n\n\n\n
    Este entendimento \u00e9 valioso ao construir sistemas escal\u00e1veis e sustent\u00e1veis e \u00e9 um tema central em meus grupos de estudo e mentorias, onde discutimos e aplicamos conceitos como este em cen\u00e1rios do mundo real.<\/p>\n\n\n\n
    TL;DR<\/h2>\n\n\n\n
      \n
    1. REST e DDD se complementam para a cria\u00e7\u00e3o de APIs alinhadas com o dom\u00ednio do neg\u00f3cio.<\/li>\n\n\n\n
    2. Agregados do DDD servem como uma excelente base para estruturar os recursos em APIs REST.<\/li>\n\n\n\n
    3. A pr\u00e1tica incorpora integridade ao modelo, facilita a manuten\u00e7\u00e3o e promove a modulariza\u00e7\u00e3o das APIs.<\/li>\n<\/ol>\n","protected":false},"featured_media":9363,"parent":0,"template":"","cursos":[12],"class_list":["post-9362","artigos","type-artigos","status-publish","has-post-thumbnail","hentry","cursos-ddd-do-jeito-certo"],"acf":[],"_links":{"self":[{"href":"https:\/\/elemarjr.com\/clube-de-estudos\/wp-json\/wp\/v2\/artigos\/9362","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/elemarjr.com\/clube-de-estudos\/wp-json\/wp\/v2\/artigos"}],"about":[{"href":"https:\/\/elemarjr.com\/clube-de-estudos\/wp-json\/wp\/v2\/types\/artigos"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/elemarjr.com\/clube-de-estudos\/wp-json\/wp\/v2\/media\/9363"}],"wp:attachment":[{"href":"https:\/\/elemarjr.com\/clube-de-estudos\/wp-json\/wp\/v2\/media?parent=9362"}],"wp:term":[{"taxonomy":"cursos","embeddable":true,"href":"https:\/\/elemarjr.com\/clube-de-estudos\/wp-json\/wp\/v2\/cursos?post=9362"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}