{"id":10163,"date":"2023-12-19T11:26:05","date_gmt":"2023-12-19T14:26:05","guid":{"rendered":"https:\/\/elemarjr.com\/clube-de-estudos\/?post_type=artigos&#038;p=10163"},"modified":"2023-12-22T09:03:22","modified_gmt":"2023-12-22T12:03:22","slug":"quer-melhorar-seu-design-aplique-cqs","status":"publish","type":"artigos","link":"https:\/\/elemarjr.com\/clube-de-estudos\/artigos\/quer-melhorar-seu-design-aplique-cqs\/","title":{"rendered":"Quer Melhorar Seu Design? Aplique CQS"},"content":{"rendered":"\n<p>Nesse mundo cada vez mais acelerado da tecnologia da informa\u00e7\u00e3o, uma das metas constantes para desenvolvedores \u00e9 a otimiza\u00e7\u00e3o e a clareza do c\u00f3digo-fonte. Como especialista em padr\u00f5es de design, posso afirmar que uma das ferramentas mais eficazes para atingir esse objetivo \u00e9 o <em>Command Query Separation<\/em> (CQS), uma proposta de Bertrand Meyer que resiste bravamente ao teste do tempo.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">A Ess\u00eancia do CQS e a Linha T\u00eanue com o SOLID<\/h2>\n\n\n\n<p>Imagine por um momento seu c\u00f3digo como um jardim bem cuidado. Assim como as plantas requerem espa\u00e7os dedicados para florescerem, assim tamb\u00e9m o seu c\u00f3digo se beneficia de clareza e organiza\u00e7\u00e3o. O CQS estabelece essa organiza\u00e7\u00e3o ao defender que m\u00e9todos devem ser claramente divididos em comandos, que alteram o estado do sistema, e consultas, que retornam dados sem altera\u00e7\u00f5es de estado. Mas como isso se relaciona com os princ\u00edpios <em>SOLID<\/em>?<\/p>\n\n\n\n<p>Os princ\u00edpios <em>SOLID<\/em> s\u00e3o essenciais para o desenvolvimento de software orientado a objeto e, em particular, o Princ\u00edpio da Responsabilidade \u00danica (SRP) se alinha perfeitamente com o CQS. Ao adotar o CQS, voc\u00ea est\u00e1 implicitamente seguindo o SRP, pois cada m\u00e9todo tem uma \u00fanica responsabilidade \u2014 ou altera o estado ou responde a uma consulta.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Aprofundamento T\u00e9cnico e Exemplos Pr\u00e1ticos<\/h2>\n\n\n\n<p>Entendido o conceito, como podemos levar o CQS para al\u00e9m do b\u00e1sico e aplic\u00e1-lo em situa\u00e7\u00f5es mais complexas? Consideremos o seguinte exemplo em C# em um cen\u00e1rio de e-commerce:<\/p>\n\n\n\n<div class=\"wp-block-kevinbatdorf-code-block-pro\" style=\"font-size:.875rem;line-height:1.25rem\"><span style=\"display:block;padding:16px 0 0 16px;margin-bottom:-1px;width:100%;text-align:left;background-color:#2e3440ff\"><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"54\" height=\"14\" viewBox=\"0 0 54 14\"><g fill=\"none\" fill-rule=\"evenodd\" transform=\"translate(1 1)\"><circle cx=\"6\" cy=\"6\" r=\"6\" fill=\"#FF5F56\" stroke=\"#E0443E\" stroke-width=\".5\"><\/circle><circle cx=\"26\" cy=\"6\" r=\"6\" fill=\"#FFBD2E\" stroke=\"#DEA123\" stroke-width=\".5\"><\/circle><circle cx=\"46\" cy=\"6\" r=\"6\" fill=\"#27C93F\" stroke=\"#1AAB29\" stroke-width=\".5\"><\/circle><\/g><\/svg><\/span><span role=\"button\" tabindex=\"0\" data-code=\"public class ShoppingCartService\n{\n    \/\/ Comando\n    public void AddItem(Product item)\n    {\n        if (item == null)\n        {\n            throw new ArgumentNullException(nameof(item), &quot;Item cannot be null.&quot;);\n        }\n\n        _shoppingCart.Add(item);\n        UpdateInventory(item, decrementedBy: 1);\n    }\n\n    \/\/ Comando\n    private void UpdateInventory(Product item, int decrementedBy)\n    {\n        \/\/ L\u00f3gica para atualizar o invent\u00e1rio\n    }\n\n    \/\/ Consulta\n    public IReadOnlyCollection<Product&gt; GetCartItems()\n    {\n        return _shoppingCart.AsReadOnly();\n    }\n\n    private List<Product&gt; _shoppingCart = new List<Product&gt;();\n}\" style=\"color:#d8dee9ff;display:none\" aria-label=\"Copy\" class=\"code-block-pro-copy-button\"><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" style=\"width:24px;height:24px\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\" stroke-width=\"2\"><path class=\"with-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4\"><\/path><path class=\"without-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2\"><\/path><\/svg><\/span><pre class=\"shiki nord\" style=\"background-color: #2e3440ff\"><code><span class=\"line\"><span style=\"color: #81A1C1\">public<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #81A1C1\">class<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #8FBCBB\">ShoppingCartService<\/span><\/span>\n<span class=\"line\"><span style=\"color: #ECEFF4\">{<\/span><\/span>\n<span class=\"line\"><span style=\"color: #ECEFF4\">    <\/span><span style=\"color: #616E88\">\/\/ Comando<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #81A1C1\">public<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #81A1C1\">void<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #88C0D0\">AddItem<\/span><span style=\"color: #ECEFF4\">(<\/span><span style=\"color: #D8DEE9FF\">Product item<\/span><span style=\"color: #ECEFF4\">)<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">{<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">        <\/span><span style=\"color: #81A1C1\">if<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">(<\/span><span style=\"color: #D8DEE9\">item<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #81A1C1\">==<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #81A1C1\">null<\/span><span style=\"color: #ECEFF4\">)<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">        <\/span><span style=\"color: #ECEFF4\">{<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">            <\/span><span style=\"color: #81A1C1\">throw<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #81A1C1\">new<\/span><span style=\"color: #D8DEE9FF\"> ArgumentNullException<\/span><span style=\"color: #ECEFF4\">(<\/span><span style=\"color: #81A1C1\">nameof<\/span><span style=\"color: #ECEFF4\">(<\/span><span style=\"color: #D8DEE9\">item<\/span><span style=\"color: #ECEFF4\">),<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">Item cannot be null.<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">)<\/span><span style=\"color: #81A1C1\">;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">        <\/span><span style=\"color: #ECEFF4\">}<\/span><\/span>\n<span class=\"line\"><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">        <\/span><span style=\"color: #D8DEE9\">_shoppingCart<\/span><span style=\"color: #ECEFF4\">.<\/span><span style=\"color: #88C0D0\">Add<\/span><span style=\"color: #ECEFF4\">(<\/span><span style=\"color: #D8DEE9\">item<\/span><span style=\"color: #ECEFF4\">)<\/span><span style=\"color: #81A1C1\">;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">        <\/span><span style=\"color: #88C0D0\">UpdateInventory<\/span><span style=\"color: #ECEFF4\">(<\/span><span style=\"color: #D8DEE9\">item<\/span><span style=\"color: #ECEFF4\">,<\/span><span style=\"color: #D8DEE9FF\"> decrementedBy<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #B48EAD\">1<\/span><span style=\"color: #ECEFF4\">)<\/span><span style=\"color: #81A1C1\">;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">}<\/span><\/span>\n<span class=\"line\"><\/span>\n<span class=\"line\"><span style=\"color: #ECEFF4\">    <\/span><span style=\"color: #616E88\">\/\/ Comando<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #81A1C1\">private<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #81A1C1\">void<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #88C0D0\">UpdateInventory<\/span><span style=\"color: #ECEFF4\">(<\/span><span style=\"color: #D8DEE9FF\">Product item<\/span><span style=\"color: #ECEFF4\">,<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #81A1C1\">int<\/span><span style=\"color: #D8DEE9FF\"> decrementedBy<\/span><span style=\"color: #ECEFF4\">)<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">{<\/span><\/span>\n<span class=\"line\"><span style=\"color: #ECEFF4\">        <\/span><span style=\"color: #616E88\">\/\/ L\u00f3gica para atualizar o invent\u00e1rio<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">}<\/span><\/span>\n<span class=\"line\"><\/span>\n<span class=\"line\"><span style=\"color: #ECEFF4\">    <\/span><span style=\"color: #616E88\">\/\/ Consulta<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #81A1C1\">public<\/span><span style=\"color: #D8DEE9FF\"> IReadOnlyCollection<\/span><span style=\"color: #ECEFF4\">&lt;<\/span><span style=\"color: #D8DEE9FF\">Product<\/span><span style=\"color: #ECEFF4\">&gt;<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #88C0D0\">GetCartItems<\/span><span style=\"color: #ECEFF4\">()<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">{<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">        <\/span><span style=\"color: #81A1C1\">return<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #D8DEE9\">_shoppingCart<\/span><span style=\"color: #ECEFF4\">.<\/span><span style=\"color: #88C0D0\">AsReadOnly<\/span><span style=\"color: #ECEFF4\">()<\/span><span style=\"color: #81A1C1\">;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">}<\/span><\/span>\n<span class=\"line\"><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #81A1C1\">private<\/span><span style=\"color: #D8DEE9FF\"> List<\/span><span style=\"color: #ECEFF4\">&lt;<\/span><span style=\"color: #D8DEE9FF\">Product<\/span><span style=\"color: #ECEFF4\">&gt;<\/span><span style=\"color: #D8DEE9FF\"> _shoppingCart <\/span><span style=\"color: #81A1C1\">=<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #81A1C1\">new<\/span><span style=\"color: #D8DEE9FF\"> List<\/span><span style=\"color: #ECEFF4\">&lt;<\/span><span style=\"color: #D8DEE9FF\">Product<\/span><span style=\"color: #ECEFF4\">&gt;()<\/span><span style=\"color: #81A1C1\">;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #ECEFF4\">}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n<p>Aqui, <code>AddItem<\/code> claramente se define como um comando e <code>GetCartItems<\/code> como uma consulta. O m\u00e9todo <code>UpdateInventory<\/code> \u00e9 privado e serve como um auxiliar para o comando <code>AddItem<\/code>, mantendo assim a clareza de prop\u00f3sitos e responsabilidades. Dessa forma, o sistema de carrinho de compras torna-se mais confi\u00e1vel e intuitivo para quem for mant\u00ea-lo ou test\u00e1-lo.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Conclus\u00e3o<\/h2>\n\n\n\n<p>Melhorar o design de software \u00e9 um processo cont\u00ednuo de aperfei\u00e7oamento e adapta\u00e7\u00e3o. O CQS, com sua simplicidade enganosamente profunda, oferece uma rota segura para o c\u00f3digo mais organizado e sustent\u00e1vel. Quando associamos CQS com os princ\u00edpios SOLID, especialmente o SRP, criamos n\u00e3o apenas c\u00f3digo mais limpo, mas tamb\u00e9m uma arquitetura mais resiliente.<\/p>\n\n\n\n<p>A pr\u00e1tica de tais princ\u00edpios e como eles podem ser integrados em desafios de design mais complexos fazem parte do meu dia-a-dia e do conte\u00fado que compartilho em meus grupos de estudo e sess\u00f5es de mentoria. Ali, n\u00f3s nos aprofundamos em como o CQS pode ser o alicerce para padr\u00f5es arquiteturais ainda mais abrangentes como o CQRS, explorando assim um universo de possibilidades na arte da engenharia de software.<\/p>\n\n\n\n<p>Que outros padr\u00f5es voc\u00ea pode aprender a partir da aplica\u00e7\u00e3o do CQS? Como esses princ\u00edpios podem elevar a qualidade do seu pr\u00f3ximo projeto? Essas reflex\u00f5es s\u00e3o essenciais para o crescimento como profissional de tecnologia.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">TL;DR<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>O CQS \u00e9 um conceito de Bertrand Meyer que melhora a clareza do design, distinguindo m\u00e9todos em comandos e consultas.<\/li>\n\n\n\n<li>Ao separar comandos e consultas, aplicamos tamb\u00e9m o Princ\u00edpio da Responsabilidade \u00danica do SOLID, aumentando a manutenabilidade do c\u00f3digo.<\/li>\n\n\n\n<li>Exemplos pr\u00e1ticos, como o cen\u00e1rio de e-commerce em C#, ilustram a aplica\u00e7\u00e3o de CQS em situa\u00e7\u00f5es complexas e seu impacto positivo no design do software.<\/li>\n<\/ol>\n","protected":false},"featured_media":10120,"parent":0,"template":"","cursos":[7],"class_list":["post-10163","artigos","type-artigos","status-publish","has-post-thumbnail","hentry","cursos-gof"],"acf":[],"_links":{"self":[{"href":"https:\/\/elemarjr.com\/clube-de-estudos\/wp-json\/wp\/v2\/artigos\/10163","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\/10120"}],"wp:attachment":[{"href":"https:\/\/elemarjr.com\/clube-de-estudos\/wp-json\/wp\/v2\/media?parent=10163"}],"wp:term":[{"taxonomy":"cursos","embeddable":true,"href":"https:\/\/elemarjr.com\/clube-de-estudos\/wp-json\/wp\/v2\/cursos?post=10163"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}