<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Jason on Medium]]></title>
        <description><![CDATA[Stories by Jason on Medium]]></description>
        <link>https://medium.com/@jasonsantiagobutler?source=rss-50ca36b721d------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/0*lwl4XC-KhIUjiEBw.jpg</url>
            <title>Stories by Jason on Medium</title>
            <link>https://medium.com/@jasonsantiagobutler?source=rss-50ca36b721d------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Tue, 17 Nov 2026 13:14:40 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@jasonsantiagobutler/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Domain-Driven Design com Flutter]]></title>
            <link>https://medium.com/@jasonsantiagobutler/domain-driven-design-com-flutter-eba075dbf285?source=rss-50ca36b721d------2</link>
            <guid isPermaLink="false">https://medium.com/p/eba075dbf285</guid>
            <category><![CDATA[flutter]]></category>
            <category><![CDATA[mobx]]></category>
            <category><![CDATA[dart]]></category>
            <category><![CDATA[domain-driven-design]]></category>
            <category><![CDATA[ddd]]></category>
            <dc:creator><![CDATA[Jason]]></dc:creator>
            <pubDate>Wed, 09 Sep 2020 14:02:05 GMT</pubDate>
            <atom:updated>2020-09-09T14:02:05.876Z</atom:updated>
            <content:encoded><![CDATA[<p>Se você for um flutter-futurista, acredita que o ecossistema Dart está aqui para ficar, e quer garantir que sua aplicação Dart sobreviva aos longo dos anos, então você vai gostar de saber sobre Domain-Driven Design.</p><h3>O que é DDD?</h3><p>Domain-Driven Design é uma metodologia para criação de softwares que possuem regras de negócio complexas, onde ajuda a organizar o código, manter os módulos independentes e raciocinar sobre a lógica e as regras do sistema.</p><p>Esse artigo irá abordar apenas sobre a parte arquitetural de DDD, então recomendo você leia sobre os modos de usar DDD além do código (DDD tático) para construir sistemas melhores.</p><h3>Vantagens</h3><p>Em DDD, o principal foco é o seu negócio e as regras de como deve funcionar. Todo o resto são apenas detalhes, e podem ser facilmente substituídos. Logo, o foco de DDD é isolar o domínio (regras de negócio) do resto da aplicação, para que ela funcione independentemente do resto.</p><p>DDD também acredita que não é uma boa ideia criar uma arquitetura rígida que pode quebrar facilmente ao mudar os requisitos do sistema. Um dos focos de DDD é a flexibilidade, a organização do código e o poder de poder facilmente trocar as ferramentas usadas pelo aplicativo sem quebrar o resto do sistema.</p><p>Um diferencial que essa arquitetura tem é que ela não depende de nenhum framework externo: ela é completamente independente por usar design patterns robustos e conhecidos pela comunidade. Se você decidir deixar de usar DDD, ou usar algumas camadas a menos, ou usar outra arquitetura em outra parte da aplicação, todas as outras partes continuarão funcionando sem problemas.</p><p>Vantagens:</p><ul><li>Isolamento das Regras de Negócio</li><li>Flexibilidade</li><li>Independência de Frameworks e Bibliotecas</li><li>Organização do Código</li></ul><h3>Arquitetura</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/800/0*Ahy_hXrFysq-_j00.png" /></figure><p>Embora há varias maneiras de implementar DDD, a mais conhecida é a Onion Architecture que contém quatro camadas:</p><h3>Camada de Regras (Domain Model / Domain Services)</h3><p>Essa camada é o coração da nossa aplicação. Ela nunca precisará ser modificada por causa de mudanças em outras camadas (Ex: trocar o framework, trocar a API, trocar as bibliotecas).</p><p>Essa camada é composta por 3 partes:</p><h3>Entities</h3><p>Entities são a representação literal do nosso negócio, mostram todas as partes envolvidas e quais ações cada coisa pode fazer. Aqui é onde devemos guardar todas as regras de negócio que tem apenas uma Entity envolvida.</p><p>Toda Entity tem um identificador único (id), os setters normalmente sempre são privados, expondo apenas as ações de uma Entity (assim garantindo que a Entity sempre seja válida).</p><pre>// Entity<br>class Hospital {<br>  String get id =&gt; _id;<br>  String _id;<br>                <br>  String _name;<br>  String get name =&gt; _name;</pre><pre>  int _staffSize;<br>  int get staffSize =&gt; _staffSize;</pre><pre>  <br>  /*...construtor, validação, ações...*/<br>  <br>  hireDoctor(Doctor doctor) {<br>    /*... regras ...*/<br>    _staffSize += 1;<br>  }<br>  <br>}<br>// Entity<br>class Job {<br>  String _id;<br>  String get id =&gt; _id;<br>  <br>  String _name;<br>  String get name =&gt; _name;<br>  <br>  String _description;<br>  String get description =&gt; _description;<br>  <br>	/*...construtor, validação, ações...*/  <br>  <br>}<br>// Entity<br>class Doctor {<br>  <br>  String _id;<br>  String get id =&gt; _id;<br>  <br>  PersonName _name;<br>  PersonName get name =&gt; _name;</pre><pre>  Job _job;<br>  Job get job =&gt; _job;<br>  <br>  int _staffSize;<br>  int get staffSize =&gt; _staffSize;  <br>  <br>  bool _isHired;<br>  bool get isHired =&gt; _isHired;<br>  <br>  hireFor(Job job) {<br>    /* ...regras de negócio... */<br>    _isHired = true;<br>    _job = job;<br>  }</pre><pre>	/*...construtor, validação, ações...*/</pre><pre>}</pre><h3>Value Objects</h3><p>Value Objects são objetos imutáveis que são usados apenas como um valor, sem identificador único. Dois Value Objects com as mesmas propiedades podem ser considerados o mesmo objeto. Cada Value Object cuida de sua própia validação e garante que sempre esteja correto.</p><p>Exemplos: EmailAddress, PersonName, GpsPosition, etc…</p><pre>// Value Object<br>class PersonName {<br>  final String firstName;<br>  final String lastName;</pre><pre>  PersonName._(this.firstName, this.lastName);</pre><pre>  factory PersonName({String firstName, String lastName}) {<br>    if (firstName == null || lastName == null) {<br>      throw new InvalidPersonNameException(<br>          &#39;Nome ou sobrenome não podem estar vazios&#39;);<br>    }<br>    return PersonName._(firstName, lastName);<br>  }</pre><pre>  String get fullName =&gt; &quot;$firstName $lastName&quot;;<br>}</pre><h3>Domain Services</h3><p>Domain Services são usados para casos de uso que envolvem várias Entities diferentes, quando uma ação não cabe em apenas uma só Entity.</p><pre>// Domain Service<br>class HiringService {</pre><pre>  HireDoctorReturn hireDoctor(Doctor doctor, Hospital hospital, Job job) {<br>    doctor.hireFor(job);<br>    hospital.hireDoctor(doctor);<br>    return HireDoctorReturn(doctor, hospital);<br>  }</pre><pre>}<br>// Retorno do método<br>class HireDoctorReturn {<br>  final Doctor doctor;<br>  final Hospital hospital;<br>  HireDoctorReturn(this.doctor, this.hospital);<br>}</pre><h3>Camada de Serviços (Application Services)</h3><p>É nessa camada onde vamos expor todos os comportamentos (casos de uso) que o nosso aplicativo pode ter. Essa camada é responsável por orquestrar os Repositories (buscar / salvar dados), chamar as Entities / Domain Services para fazer as ações esperadas, e depois salvar os resultados.</p><p>Essa camada vai terá bem poucas regras de negócio, apenas o necessário para garantir que o usuário tem as permissões para a ação (authorization), e uma validação básica na informação que está entrando (garantir que é do tipo certo). Todas as regras de negócio de comportamento devem estar dentro das Entities e Domain Services, e essa camada vai apenas chamar os métodos, entregar os dados e salvar o resultado.</p><pre>// Application Service <br>class HospitalFacade {<br>  final HiringService hiringService;<br>  final DoctorRepository doctorRepository;<br>  final HospitalRepository hospitalRepository;<br>  final JobRepository jobRepository;<br>  <br>  HospitalFacade(this.hiringService, this.doctorRepository, this.hospitalRepository, this.jobRepository);<br>  <br>	void hireDoctor(String doctorId, String hospitalId, String jobId) async {<br>    final doctor = await doctorRepository.findOne(doctorId);<br>    final hospital = await hospitalRepository.findOne(hospitalId);<br>    final job = await jobRepository.findOne(jobId);<br>    hiringService.hireDoctor(doctor, hospital, job);<br>    await doctorRepository.save(doctor);<br>    await hospitalRepository.save(hospital);<br>    await jobRepository.save(job);<br>  }<br>}</pre><pre>abstract class DoctorRepository {<br>  Future&lt;Doctor&gt; findOne(String id);<br>  Future save(Doctor doctor);<br>}</pre><pre>abstract class HospitalRepository {<br>  Future&lt;Hospital&gt; findOne(String id);<br>  Future save(Hospital hospital);<br>}</pre><pre>abstract class JobRepository {<br>  Future&lt;Job&gt; findOne(String id);<br>  Future save(Job job);<br>}</pre><h3>Camada Infra (User Interface, Tests, Infrastructure, Presentation)</h3><p>É nessa camada onde vamos guardar as implementações: Widgets Flutter, chamadas na API, bibliotecas externas, bancos de dados locais.</p><p>Essa camada é a que tem mais chance de mudar, então ela não teve conter regra de negócio nenhum. Uma mudança nessa camada não deve afetar o resto do seu aplicativo.</p><pre>// Infrastructure Layer - Dio HTTP API repository<br>class DioDoctorRepository implements DoctorRepository {<br>  final Dio dio;</pre><pre>  DioDoctorRepository(this.dio);<br>  <br>  Future&lt;Doctor&gt; findOne(String id) async {<br>      final res = await dio.get(&#39;/doctors/&#39;+id);<br>      return DoctorDto.fromJson(res.data).toDoctor(); <br>  }</pre><pre>  /* ... outros métodos.  */</pre><pre>}</pre><pre>// Infrastructure Layer - MobX<br>class HireDoctorFormStore = _HireDoctorFormStore with _$HireDoctorFormStore;</pre><pre>class _HireDoctorFormStore with Store {<br>  final HospitalFacade hospitalFacade;</pre><pre>  @observable<br>  String doctorId;<br>  @observable<br>  String hospitalId;<br>  @observable<br>  String jobId;</pre><pre>  @observable<br>  bool loading;</pre><pre>  @observable<br>  String errorMessage;</pre><pre>  void submit() async {<br>    try {<br>      loading = true;<br>      await hospitalFacade.hireDoctor(doctorId, hospitalId, jobId);<br>    } on MessageException catch (e) {<br>      errorMessage = e.message;<br>    } catch (e) {<br>      errorMessage = &quot;Ocorreu um erro, por favor tente novamente&quot;;<br>    } finally {<br>      loading = false;<br>    }<br>  }<br>}</pre><pre>// Infrastructure Layer - Flutter Widget Presentor<br>class HireDoctorFormState extends State&lt;HireDoctorForm&gt; {<br>  final _formKey = GlobalKey&lt;FormState&gt;();<br>  HireDoctorFormStore hireDoctorFormStore;</pre><pre>  @override<br>  void initState() {<br>    hireDoctorFormStore = get&lt;HireDoctorFormStore&gt;();<br>    super.initState();<br>  }</pre><pre>  @override<br>  Widget build(BuildContext context) {<br>    return Form(<br>        key: _formKey,<br>        child: Column(children: &lt;Widget&gt;[<br>          TextFormField(<br>            onChanged: (value) { hireDoctorFormStore.doctorId = value; },<br>            decoration: const InputDecoration(<br>              icon: Icon(Icons.person),<br>              labelText: &#39;Doutor&#39;,<br>            ),<br>          ),<br>          TextFormField(<br>            onChanged: (value) { hireDoctorFormStore.hospitalId = value; },<br>            decoration: const InputDecoration(<br>              icon: Icon(Icons.local_hospital),<br>              labelText: &#39;Hospital&#39;,<br>            ),<br>          ),<br>          TextFormField(<br>            onChanged: (value) { hireDoctorFormStore.jobId = value; },<br>            decoration: const InputDecoration(<br>              icon: Icon(Icons.supervised_user_circle),<br>              labelText: &#39;Vaga&#39;,<br>            ),<br>          ),<br>          FlatButton(<br>            child: Text(&quot;Concluir&quot;),<br>            onPressed: () {<br>							if (_formKey.currentState.validate()) {<br>                hireDoctorFormStore.submit();<br>              }<br>            },<br>          )<br>        ]));<br>  }<br>}</pre><h3>Juntando as partes</h3><p>Quando usamos Inversão de Dependência acabamos separando as camadas da aplicação para que possam ser facilmente substituíveis: se eu quiser usar Http em vez de Dio eu teria que modificar apenas as classes Repository, e todas as outras partes da aplicação (Entities, Domain Services, Application Services, Widgets) continuariam funcionando exatamente igual.</p><p>A vantagem disso é que você pode trocar qualquer biblioteca ou trocar até o Flutter, que o resto da sua aplicação não quebrará.</p><p>Outra vantagem é a separação das responsabilidades, onde cada classe fica responsável por apenas um tipo de ação, então o seu código fica mais organizado e fácil de entender.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=eba075dbf285" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>