Anotações do Hercules

Conditional GET é uma especificação do protocolo HTTP que disponibiliza uma forma dos servidores web dizerem para os navegadores que a resposta a uma requisição do tipo GET não mudou desde o último request, e que pode ser carregado a partir cache do navegador.

É de responsabilidade do servidor web verificar os headers HTTP_IF_NONE_MATCH e HTTP_IF_MODIFIED_SINCE e determinar quando enviar uma resposta completa. Com Rails é bem fácil fazer isso, vamos ver um exemplo.

Suponha que você tenha um site de screencasts sobre várias linguagens de programação, frameworks e bibliotecas. Nesse site há uma página para exibir o screencast, e nessa mesma página você faz uma recomendação de vários outros screencasts, mas essa consulta é bem pesada. Uma das formas de resolver isso pode ser usando conditional get. Veja o código abaixo:

class ScreencastsController < ApplicationController
  def show
    @screencast = Screencast.find(params[:id])
    if stale?(last_modified: @screencast.updated_at.utc, etag: @screencast.cache_key)
      # consulta custosa de recomendações aqui
    end
  end
end

Fazemos um if com o método stale? passando a última data de modificação do screencast e o seu cache_key como etag. O cache_key é um método do ActiveRecord que irá retornar uma chave combinando os valores do id, classe e updated_at do objeto.

O primeiro request a essa página irá realizar a consulta e o navegador irá realizar o cache da página. As chamadas subsequentes irão retornar apenas uma resposta com o status HTTP 304 (Not Modified), e o navegador irá saber que o conteúdo não foi alterado e recarregará do seu próprio cache.

Quando o screencast for alterado, o valor de updated_at e cache_key será diferente, o conteúdo será recarregado pelo servidor, e o navegador vai exibir a nova página e guardar cache com as novas informações.

No exemplo acima, como usamos apenas valores de um model podemos simplificar ainda mais, passando apenas o objeto do ActiveRecord:

class ScreencastsController < ApplicationController
  def show
    @screencast = Screencast.find(params[:id])
    if stale?(@screencast)
      # consulta custosa de recomendações aqui
    end
  end
end

Até aqui só consideramos que as recomendações eram baseadas no screencast. Mas e se as recomendações forem um pouco mais dinâmicas? Utilizando também as categorias preferidas do usuário, por exemplo. Sem problema, só precisamos criar uma chave única para fazer o cache da página. Veja o exemplo abaixo:

class ScreencastsController < ApplicationController
  def show
    @screencast = Screencast.find(params[:id])
    etag_key = "#{@screencast.cache_key}-#{current_user.cache_key}"
    if stale?(last_modified: @screencast.updated_at.utc, etag: etag_key)
      # consulta custosa de recomendações aqui
    end
  end
end

Aqui passamos como etag uma string composta com o cache_key de screencast e usuário. Assim toda vez que o screencast for alterado, ou o usuário atualizar suas informações, o cache será descartado e o conteúdo personalizado será exibido.

Logo abaixo deixo links para quem quiser ler e entender mais detalhes. Se tiver alguma dúvida deixe nos comentários.

####Links

Rails Guides: Conditional GET

Wikipedia: HTTP Etag