6. Escopos de dados
Uma aplicação web atende muitos usuários ao mesmo tempo, e cada um deles faz numerosas requisições. Os dados podem, portanto, ser compartilhados em três níveis, chamados de escopo:
- escopo de aplicação: os dados são compartilhados por todos os usuários durante todo o tempo de vida do servidor (a lista de médicos, por exemplo);
- escopo de requisição: os dados existem apenas durante uma requisição (o modelo de uma view);
- escopo de cliente: os dados são específicos de um usuário e devem persistir de uma requisição para a seguinte (o idioma escolhido, o usuário conectado).
As aplicações web há muito tempo usam sessões para esse último escopo: um espaço de memória, mantido pelo servidor, específico de cada navegador e recuperado por meio de um cookie de identificação ([JSESSIONID] em [Java]). [Spring MVC] ainda usa isso por padrão para os atributos flash (Exemplo 20). No entanto, o estudo de caso não o utiliza, nem os exemplos deste documento (exceto os atributos flash em alguns exemplos, como os Exemplos 20 e 21): os dados do lado do cliente são armazenados pelo navegador em cookies. O servidor não armazena nada entre duas requisições de um mesmo usuário: diz-se que ele é stateless ([stateless]). É isso que permite, por exemplo, executar vários servidores idênticos atrás de um balanceador de carga. A contrapartida: um cookie está sob o controle do usuário, que pode lê-lo e modificá-lo. Portanto, só se armazenam ali dados não sensíveis, ou dados assinados ou criptografados pelo servidor, que pode então detectar qualquer modificação: é o caso do token de autenticação (Capítulo 8).
No lado do servidor, os escopos de aplicação e de requisição correspondem a os escopos dos beans do [Spring] (veja o Exemplo 06). Um bean é criado e mantido pelo [Spring]; seu escopo especifica quantas instâncias são criadas e por quanto tempo. Três deles nos interessam:
Anotação | Escopo | Uma instância... |
(nenhuma) | singleton | durante todo o tempo de vida da aplicação, compartilhada por todas as requisições. É o escopo padrão |
[@RequestScope] | request | por requisição HTTP, compartilhada por todos que a solicitarem durante essa requisição |
[@Scope("prototype")] | prototype | A cada vez que o bean é solicitado ao [Spring]: duas solicitações, duas instâncias |
Esses são os tempos de vida [Singleton], [Scoped] e [Transient] do [ASP.NET Core]. Existe também um escopo de sessão ([@SessionScope]), que não usaremos.
6.1. Exemplo 23: Três escopos
Os arquivos [pom.xml], [application.properties], [Example23Application.java], e [WebConfig.java] (que simplesmente serve os arquivos do [Bootstrap]) são os dos exemplos anteriores.
6.1.1. Os três beans
O arquivo [services/CounterService.java]:
- linha 9: um bean, sem nenhuma outra especificação: é um singleton. Seu campo [total] tem, portanto, escopo de aplicação;
- Linhas 14–18: um servidor web processa várias requisições simultaneamente em várias threads ([threads]). Se duas requisições executarem [total++] ao mesmo tempo, ambas podem ler o mesmo valor, e um incremento se perde. Um [AtomicInteger] é um inteiro que o método [incrementAndGet] lê, incrementa e grava de volta em uma única operação indivisível. Um bean singleton deve sempre desconfiar desses acessos concorrentes.
O arquivo [services/RequestService.java]:
- linha 11: a anotação [@RequestScope] dá ao bean o escopo "request";
- linha 15: um campo [static] pertence à classe, não a uma instância; é compartilhado por todas as instâncias. Ele conta o número de instâncias criadas;
- linha 17: cada instância recebe um número ao ser criada. Como o bean tem escopo de requisição, o número muda a cada requisição.
O arquivo [services/ToolService.java]:
O mesmo contador de instâncias, para um bean com escopo [prototype] (linha 10).
6.1.2. Dados com escopo de requisição: os atributos da requisição
O arquivo [config/StartFilter.java]:
- Linhas 17–18: um filtro servlet (o próximo capítulo os descreve em detalhes). Ele processa cada requisição antes do [Spring MVC]. A classe [OncePerRequestFilter] do [Spring] garante que ele seja executado apenas uma vez por requisição; a anotação [@Component] basta para que o [Spring Boot] o adicione à cadeia de filtros;
- Linha 23: o filtro armazena o horário de recebimento da requisição em um atributo de requisição. O objeto [HttpServletRequest] contém um dicionário de atributos, criado e destruído junto com a requisição: tudo o que a processa (filtros, controller, view) pode lê-lo e escrever nele. É o equivalente de [HttpContext.Items] do [ASP.NET Core];
- linha 24: o filtro passa o controle para a etapa seguinte: os demais filtros e, em seguida, o [Spring MVC].
6.1.3. O controller
O arquivo [controllers/ScopesController.java]:
Vamos comentar este código:
- Linhas 16–17: um controller é, ele próprio, um bean e, portanto, um singleton: o [Spring] o cria uma única vez e injeta suas dependências nesse momento, de uma vez por todas (linhas 29–35). É aqui que as coisas ficam interessantes;
- linha 20: um singleton injetado em um singleton, nada fora do comum;
- linha 23: um bean com escopo de requisição injetado em um singleton. Na inicialização, não há nenhuma requisição ativa e, portanto, nenhuma instância de [RequestService] para injetar. Em vez disso, o [Spring] injeta um proxy (um intermediário): um objeto que tem os mesmos métodos que [RequestService] e que encaminha cada chamada para a instância da requisição atual, criada conforme a necessidade. É isso que [@RequestScope] faz;
- linha 25: um bean prototype injetado em um singleton. O [Spring] cria uma instância... apenas uma, durante a injeção. O controller a manterá durante todo o seu tempo de vida: esse campo nunca muda. Esta é a armadilha do escopo prototype: ele só cria uma nova instância a cada solicitação ao contêiner [Spring], e um singleton solicita suas dependências uma única vez;
- linha 27: para obter uma nova instância a cada vez, o controller recebe um [ObjectProvider<ToolService>], um objeto capaz de solicitar um [ToolService] ao [Spring] sempre que necessário, por meio de seu método [getObject()] (linha 50);
- linha 37: o modelo da view, um record (veja o Exemplo 03);
- Linha 41: o escopo de cliente, um contador armazenado em um cookie. A anotação [@CookieValue] vincula o parâmetro ao cookie [myVisits] enviado pelo navegador; [required = false]: o parâmetro recebe [null] se o cookie estiver ausente (na primeira visita);
- linha 45: o contador do navegador, incrementado de 1. O método [toInteger] (linhas 55–61) converte o texto do cookie em inteiro; [Integer.parseInt] lança uma [NumberFormatException] se o texto não for um inteiro ou se for igual a [null]: o contador é então reiniciado em 0;
- linhas 46–48: o cookie é redefinido com seu novo valor. [ResponseCookie] é uma classe do [Spring] que gera o valor de um cabeçalho [Set-Cookie]: os métodos que definem suas características (caminho, [HttpOnly], [SameSite]) são chamados em sequência e, depois, [build()] cria o objeto. O cabeçalho é adicionado à resposta por [response.addHeader];
- linhas 49–50: os valores são passados para a view: o contador da aplicação, o número da instância de [RequestService] da requisição atual, o número da instância do prototype injetado, o número da instância de um prototype solicitado naquele momento e o contador do cliente.
6.1.4. A view
O arquivo [templates/scopes/scopes.html]:
- linha 9: [th:object] (veja os exemplos 18 e 19) refere-se ao objeto [model]; as expressões [*{...}] nas tags filhas referem-se às suas propriedades: [*{total}] equivale a [${model.total}];
- linha 14: [[[...]]] insere o valor de uma expressão no texto, com escape, exatamente como [th:text] faria (veja o exemplo 14);
- Linhas 15 e 18: a expressão [${@name}] refere-se ao bean com esse nome (veja o Exemplo 16). A view, por sua vez, solicita os beans [requestService] and [toolService] ao [Spring] durante a mesma requisição da action: poderemos comparar as instâncias recebidas pelo controller e pela view;
- linha 16: o atributo de requisição definido pelo filtro. Para o [Thymeleaf], os atributos de requisição são variáveis como quaisquer outras.
6.1.5. Execução
Uma página, na URLhttp://localhost:5000/:

Vamos simular dois navegadores usando [curl] e dois arquivos de cookies, [a.txt] e [b.txt]: a opção [-b] envia os cookies do arquivo, enquanto a opção [-c] salva no arquivo os cookies definidos pelo servidor. O navegador A fez duas requisições, depois o navegador B fez uma e, em seguida, A fez uma última requisição (o servidor acabou de ser reiniciado):
(apenas os itens da lista são mostrados). Observamos que:
- o contador da aplicação conta todas as visitas: 1, 2, 3, 4;
- cada requisição tem sua própria instância de [RequestService]: 1, 2, 3, 4. Durante uma requisição, o controller (por meio de seu proxy) e a view acessam a mesma instância;
- o prototype injetado no controller é sempre o nº 1: criado na inicialização junto com o controller, nunca será substituído. Os prototypes solicitados são novos a cada vez: o controller e a view recebem dois diferentes, e cada requisição cria dois novos;
- o contador do cliente é exclusivo de cada navegador: A tem 3 visitas, B tem 1.
O arquivo [a.txt], mantido pelo [curl], contém o cookie do navegador A:
Esse cookie é controlado pelo cliente, que pode enviar o valor que quiser:
Para um contador de visitantes, isso é irrelevante. Para dados sensíveis (a identidade do usuário, seu papel), o servidor precisa ser capaz de detectar adulterações: o Capítulo 8 mostra como.
Desses escopos decorre uma regra: um bean não deve reter um bean com escopo mais curto. Um singleton que recebesse diretamente uma instância com escopo de requisição a manteria indefinidamente, muito além da requisição para a qual foi criada. O [ASP.NET Core] verifica essa regra na inicialização, em modo de desenvolvimento, e se recusa a iniciar se ela for violada. O [Spring] adota outra abordagem: para o escopo de requisição, [@RequestScope] injeta um proxy, o que torna a injeção segura; para o escopo prototype, não realiza nenhuma verificação, e acabamos de ver o resultado: um “prototype” que se comporta como um singleton. Quando uma nova instância é realmente necessária, ela é solicitada ao [Spring] por meio de um [ObjectProvider].
No estudo de caso:
Escopo | Dados | Onde? |
Aplicação | listas de médicos e clientes, dicionários, CAPTCHAs pendentes, contadores de tentativas | Beans singleton ([ApplicationModel], [Translator], [CaptchaService], [AttemptLimiterService]...); a camada de negócio e o acesso a dados também são singletons stateless |
requisição | modelo da view, usuário conectado | o modelo ([Model]), complementado por [CommonModel]; o contexto de segurança do [Spring Security] |
cliente | token de autenticação, idioma, mensagem flash | cookies |