{"id":14283,"date":"2023-04-11T12:39:02","date_gmt":"2023-04-11T19:39:02","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=14283"},"modified":"2025-06-13T20:19:09","modified_gmt":"2025-06-14T03:19:09","slug":"extending-dotnet-caching-provider-collections","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/pt\/extending-dotnet-caching-provider-collections\/","title":{"rendered":"Extens\u00e3o do provedor de cache do .NET para cole\u00e7\u00f5es"},"content":{"rendered":"

Para ajudar os desenvolvedores de .NET a usar melhor o Couchbase em seus aplicativos, h\u00e1 uma cole\u00e7\u00e3o de aplicativos compat\u00edveis com a comunidade <\/span>Extens\u00f5es do Couchbase<\/span><\/a>. Isso inclui extens\u00f5es para cache, sess\u00e3o, multiop, compacta\u00e7\u00e3o e bloqueio. E h\u00e1 algumas extens\u00f5es oficialmente suportadas para inje\u00e7\u00e3o de depend\u00eancia<\/a>, telemetria aberta e transa\u00e7\u00f5es.<\/span><\/p>\n

A principal extens\u00e3o a ser discutida hoje \u00e9 <\/span>Couchbase.Extensions.Caching<\/b>que implementa o <\/span>Interface do cache distribu\u00eddo do .NET<\/span><\/a> usando o Couchbase. Isso pode ser adicionado ao seu projeto com <\/span>NuGet<\/span><\/a> (<\/span>dotnet add package Couchbase.Extensions.Caching<\/span><\/em>).<\/span><\/p>\n

Recentemente, trabalhei com um cliente do setor de cruzeiros que est\u00e1 gerenciando v\u00e1rios aplicativos e deseja armazenar dados de cache separadamente para cada aplicativo. No entanto, criar um bucket totalmente novo para cada aplicativo \u00e9 um exagero. Eles estavam se perguntando como especificar um escopo\/cole\u00e7\u00e3o ao usar o Couchbase.Extensions.Caching<\/em> biblioteca.<\/span><\/p>\n

Extens\u00f5es de sess\u00e3o e de cache<\/h2>\n

Nos \u00faltimos anos, a mudan\u00e7a do Couchbase SDK 2 para o SDK 3 introduziu muitos novos recursos e aprimoramentos, incluindo <\/span>Suporte a escopos\/cole\u00e7\u00f5es<\/span><\/a>. O Couchbase.Extensions<\/em> A fam\u00edlia tamb\u00e9m foi atualizada para oferecer suporte ao SDK 3.<\/span><\/p>\n

No entanto, o <\/span>padr\u00e3o<\/b> O uso dessa biblioteca usa o <\/span>Padr\u00e3o<\/span><\/em> escopo e <\/span>Padr\u00e3o<\/span><\/em> sem nenhuma op\u00e7\u00e3o integrada para especificar qualquer outra coisa.<\/span><\/p>\n

Para ver isso em a\u00e7\u00e3o, aqui est\u00e1 a linha de configura\u00e7\u00e3o para adicionar o Couchbase como um cache distribu\u00eddo (extra\u00eddo do arquivo <\/span>Projeto de exemplo do GitHub<\/span><\/a>):<\/span><\/p>\n

builder.Services.AddDistributedCouchbaseCache(\"myproject\", opt => { });<\/pre>\n
Nesse c\u00f3digo, meu projeto<\/em>\u00a0\u00e9 um nome de bucket. O <\/span>optar<\/span><\/em> n\u00e3o tem uma op\u00e7\u00e3o para o nome do escopo\/cole\u00e7\u00e3o.<\/span><\/p>\n
Usando o projeto de amostra, voc\u00ea ter\u00e1 informa\u00e7\u00f5es em cache como estas:<\/span><\/p>\n
\"\"<\/p>\n
(Observe que os nomes do bucket, do escopo e da cole\u00e7\u00e3o s\u00e3o meu projeto<\/em>, Padr\u00e3o<\/em>e Padr\u00e3o<\/em>).<\/span><\/p>\n
Extens\u00e3o da extens\u00e3o<\/h2>\n
Felizmente, a biblioteca \u00e9 extens\u00edvel o suficiente para que, com um pouco de c\u00f3digo, ela possa ser apontada para qualquer cole\u00e7\u00e3o que voc\u00ea queira.<\/span><\/p>\n
Vamos examinar um pouco mais a fundo o projeto, especificamente ICouchbaseCacheCollectionProvider.cs<\/em> e DefaultCouchbaseCacheCollectionProvider.cs<\/em><\/span><\/p>\n