A nova "moda" no mundo do Microsoft .NET é Estrutura do .NET CoreCouchbase Core: uma implementação de código aberto e plataforma cruzada (OSX, Linux e Windows) da estrutura .NET. Em um esforço para fornecer o melhor ambiente para desenvolvedores, hoje o Couchbase está lançando um SDK compatível com o .NET Core! Essa versão inicial é uma prévia para desenvolvedores e, na verdade, oferece suporte ao .NET Framework 4.5 e ao .NET Core 1.0. Mais informações sobre isso em breve.
O que está incluído neste pacote?
Se você estiver acompanhando o Couchbase .NET SDK, perceberá que aumentamos a versão secundária de 2.3.X para 2.4.X nesta versão. O motivo é que a versão GA final do 2.4.0 conterá vários recursos novos que ampliam essa API pública do SDK:
- Autenticação em nível de cluster
- Estruturas de dados API
- Consulta em nível de cluster
- "Localizar" genérico
Esses recursos estão em desenvolvimento ou prestes a começar a ser desenvolvidos e serão incluídos nos DP&apos subsequentes. Esta versão, DP1, inclui apenas a compatibilidade com o .NET Core.
É importante observar que esse pacote inclui o .NET Framework 4.5 (nossa versão básica do .NET compatível com o SDK) e o .NET Core 1.0 (via NetStandard1.5). Seu tipo de projeto de destino determinará qual versão do SDK será usada. Isso também significa que o pacote NuGet será compatível com as versões anteriores de seu código existente desde que você não converta seus projetos em projetos .NET Core.
Além disso, há uma grande probabilidade de que o SDK não ofereça suporte a métodos síncronos para a versão final do .NET Core; isso se deve ao fato de a Microsoft estar se afastando das APIs síncronas mais antigas para usar tudo assíncrono. Você ainda poderá chamar os métodos assíncronos de forma síncrona por meio de Task.Result, mas não ofereceremos uma versão síncrona pura.
Primeiros passos no Linux
Na seção a seguir, mostrarei como usar o Couchbase .NET Core 2.4.0-dp1 em um aplicativo de console simples executado no Ubuntu 14.0.4. Presumo que você já tenha instalado o .NET Core 1.0.1 no computador; se não tiver, siga estas instruções direções. Ele também pressupõe que você tenha instalado o Couchbase Server 4.5. Se você não tiver Faça o download e instale-o.
Primeiro, abra um terminal e crie um diretório chamado cb-core-example e, em seguida, mude para esse diretório e execute dotnet new:
Usando o VIM ou seu editor favorito, abra o arquivo project.json que foi criado quando você executou o dotnet new. Adicione a dependência ao pacote CouchbaseNetClient no NuGet get, especificando a versão correta (2.4.0-dp1):
Novamente usando o VIM ou seu editor favorito, abra o arquivo Program.cs e digite o seguinte código:
Depois de fazer isso, basta fazer um dotnet restore e dotnet run para atualizar as dependências e executar o aplicativo. Se tudo der certo, você verá as palavras SUCCESS escritas no terminal.
Mais uma vez, os comandos são os seguintes:
1 2 3 4 5 6 7 |
mkdir cb-núcleo-exemplo1 cd cb-núcleo-exemplo1 dotnet novo vim projeto.json vim Programa.cs dotnet restaurar dotnet executar |
Destaques da comunidade
Essa prévia para desenvolvedores foi elaborada durante meses e incluiu várias contribuições da comunidade. Um grande agradecimento a Brant Burnett, da CenterEdge Software para fazer contribuições essenciais e orientação com empacotamento e migrações de API para bibliotecas compatíveis com o Core.
Contribuir e relatar bugs
O SDK do Couchbase .NET está sempre buscando contribuições e comentários da comunidade. Se você quiser contribuir, o O repositório do Github está aqui. Se você encontrar um bug, crie um Tíquete do Jira ou fazer um publicação nos fóruns.
Como obtê-lo?
- Instale o Pacote NuGet.
- Clonar o Repositório do Github
- Baixar os binários
[...] A adição de suporte direto a listas, mapas, conjuntos e filas na API de subdocumentos usando o novo recurso SDK de estrutura de dados simplifica ainda mais o desenvolvimento de aplicativos. As novas estruturas de dados funcionam perfeitamente com a mesma representação de dados subjacente, permitindo que os desenvolvedores em N1QL, Java, .NET e outras linguagens acessem os mesmos dados em diferentes linguagens de programação e interfaces. A adição do suporte ao .NET Core permite que os desenvolvedores de aplicativos da Microsoft desenvolvam e integrem facilmente seus aplicativos ao Couchbase Server. Confira a documentação sobre estruturas de dados e o blog do .NET Core. [...]