12. Conclusão
Este documento apresentou o desenvolvimento de uma aplicação web MVC com o framework [Flask]: uma aplicação cujas páginas HTML são geradas pelo servidor, usando views [Jinja2], sem um framework [JavaScript] no navegador. Ele seguiu passo a passo o curso [Spring MVC], que por sua vez se baseia nos cursos [ASP.NET Core MVC] e [NestJS]: ações e roteamento para views, formulários, internacionalização, segurança e acesso a dados, seguidos de um estudo de caso completo.
Os mesmos 28 exemplos e a mesma aplicação foram, assim, escritos com quatro frameworks: [TypeScript], [C#], [Java] e [Python]. Os conceitos são os mesmos; só os nomes e os mecanismos mudam. As correspondências entre [Spring MVC] e [Flask]:
Spring MVC | Flask |
classe [@SpringBootApplication], classes [@Configuration], métodos [@Bean] | factory [create_app], objetos armazenados em [app.extensions] |
arquivo [pom.xml], starters [Maven] | arquivo [requirements.txt], ambiente virtual, [pip] |
[application.properties], perfis, [@ConfigurationProperties] | [config.py], [config_<profile>.py], variáveis [FLASK_...] ([app.config]) |
Injeção de dependência: beans singleton, [@Service], [@Component] | objetos criados manualmente pela factory, obtidos por meio de [current_app] |
[@Controller], [@GetMapping], [@PostMapping], nome da view ou [redirect:...] | blueprints, [@bp.get], [@bp.post], [render_template], [redirect] |
vinculação ao modelo, [@RequestParam], conversores | [request.args], [request.form], conversores do [Werkzeug] ([<int:id>]) |
[Bean Validation]: [@NotBlank], [@Min], [@Max]..., [@Valid], [BindingResult] | [Pydantic] (parâmetros, JSON); [WTForms]: validadores, [form.validate()], [form.errors] |
views [Thymeleaf] ([.html]), [th:text], [th:each], [th:if] | views [Jinja2], [{{ }}], [{% for %}], [{% if %}] |
template e fragmentos ([th:replace], [th:fragment]) | [{% extends %}] e blocos, [{% include %}], macros |
[@ControllerAdvice] e [@ModelAttribute] | context processor ([@app.context_processor]) |
flash attributes ([RedirectAttributes]) | mensagens flash ([flash], [get_flashed_messages]), no cookie de sessão |
filtros de servlet, interceptors | WSGI, [before_request], [after_request], [teardown_request] middleware |
[@ControllerAdvice] / [@ExceptionHandler], [ErrorController] | [@app.errorhandler] |
[Spring Security]: [SecurityFilterChain], resource server, [@PreAuthorize] | [before_request] e decoradores escritos à mão ([PyJWT], [bcrypt]) |
proteção CSRF do [Spring Security] | [CSRFProtect] do [Flask-WTF] |
dicionários JSON lidos por um [MessageSource], [#{...}] ou [LocaleResolver] | dicionários JSON, [t(...)] função de view, [g.language] definido por um [before_request] |
[Spring Data JPA] e [Hibernate], [JpaRepository], consultas derivadas, [JPQL] | [SQLAlchemy]: entidades mapeadas, [select(...)], sessões, classes DAO escritas à mão |
[@Transactional], [TransactionTemplate] | [with sessions.begin() as session:] |
[@Version], gerenciado pelo [Hibernate] | [version_id_col], gerenciado pelo [SQLAlchemy] |
[mvnw spring-boot:run], [Spring Boot DevTools] | [python app.py] em modo de depuração (recarga automática) |
arquivo executável ([java -jar]), com [Tomcat] incluído | servidor WSGI: [Waitress], [Gunicorn] |
Em comparação com o [Spring MVC], os principais pontos a observar são:
- O [Flask] é um micro-framework: ele oferece roteamento, requisições e respostas, as views [Jinja2] e o gerenciamento de sessão, e nada além disso. Todo o resto (validação, formulários, segurança, acesso a dados, tradução) fica a cargo de bibliotecas escolhidas pelo desenvolvedor ou escritas por ele. Isso significa mais código a escrever, mas um código transparente: nada acontece “por mágica”, e é possível acompanhar cada objeto desde a sua criação (em [create_app]) até o seu uso;
- não há contêiner de injeção de dependência: os objetos compartilhados são criados pela factory, armazenados em [app.extensions] e obtidos por meio de [current_app]. Para uma aplicação deste porte, isso é simples e suficiente;
- Os objetos [request], [g], [session] e [current_app] são proxies que, durante uma requisição, remetem aos objetos dessa requisição. Eles dispensam a passagem da requisição de uma função para outra, mas só podem ser usados durante o processamento de uma requisição (ou dentro de um contexto de aplicação criado manualmente);
- os decoradores do [Python] têm a mesma finalidade que as anotações do [Java]: rotas, marcações ([@public]) e controles de acesso ([@roles_required]). Mas um decorador é simplesmente uma função que você mesmo pode escrever em poucas linhas;
- [Python] é uma linguagem de tipagem dinâmica: as anotações de tipo ([list[Doctor]], [Protocol], classes genéricas) documentam o código e orientam o editor, mas não são verificadas em tempo de execução. Ferramentas como o [Pylance] (no [Visual Studio Code]) ou o [mypy] as verificam antes da execução;
- O [SQLAlchemy] exige a escrita da camada DAO (algumas linhas por consulta), mas suas consultas, construídas com objetos [Python], permanecem próximas do SQL que produzem, e a exibição dos comandos SQL ([SQL_ECHO]) permite verificar o que é enviado ao banco de dados. O carregamento das relações é controlado explicitamente, consulta por consulta;
- As views [Jinja2] misturam HTML e tags [{{ }}] / [{% %}] : não são páginas HTML válidas como as do [Thymeleaf], mas sua linguagem, semelhante ao [Python], é poderosa (filtros, macros, herança de templates), e o escape automático protege contra injeção de HTML.
O estudo de caso mostra que uma aplicação HTML clássica, sem o [JavaScript] como elemento essencial, continua sendo uma solução simples e robusta: cada página é uma URL, o botão “Voltar” do navegador funciona e o servidor controla tudo. O uso limitado de [JavaScript] (janelas de confirmação) melhora a experiência do usuário sem ser necessário para o funcionamento da aplicação.
Para saber mais, você pode consultar a documentação do [Flask] (flask.palletsprojects.com), [Jinja2] (jinja.palletsprojects.com), [Werkzeug] (werkzeug.palletsprojects.com), [WTForms] (wtforms.readthedocs.io) e [Flask-WTF] (flask-wtf.readthedocs.io), do [SQLAlchemy] (docs.sqlalchemy.org), do [Pydantic] (docs.pydantic.dev) e comparar esta aplicação com suas equivalentes em [Spring MVC], [ASP.NET Core MVC] e [NestJS].