aspnet quickstart minapi user profile
1.0.0
Este repositório foi projetado para ensinar como se conectar a um cluster Couchbase para criar, ler, atualizar e excluir documentos e como escrever consultas N1QL parametrizadas simples usando a nova estrutura API Minimum ASP.NET.
A documentação completa pode ser encontrada no portal do desenvolvedor da Couchbase.
Para executar este projeto pré -construído, você precisará:
cd src/Couchbase.Quickstart
dotnet restoreNota: Nuget Packages Restore Auto ao criar o projeto no Visual Studio Professional e Visual Studio para Mac
O Couchbase SDK para .NET inclui um pacote NUGET chamado Couchbase.Extensions.DependencyInjection , projetado para ambientes como o ASP.NET que recebe uma configuração para conectar -se ao CouchBase e registra automaticamente interfaces que você pode usar em seu código para executar CRUD (create, read, update, delete) e, as operações e seriam que você pode usar o código completo.
Toda a configuração para comunicação com o banco de dados é armazenada no arquivo appSsets.Development.json. Isso inclui a string de conexão, nome de usuário, senha, nome do balde, nome do colecson e nome do escopo. Presume -se que o nome de usuário padrão seja admin e a senha padrão é assumida como P@$$w0rd12 . Se estes forem diferentes em seu ambiente, você precisará alterá -los antes de executar o aplicativo.
Com este tutorial, é necessário que um usuário e um balde de banco de dados sejam criados antes da execução do aplicativo.
Para usuários de Capella, siga as instruções encontradas no site da documentação para criar um balde chamado user_profile . Em seguida, siga as instruções para configurar credenciais de banco de dados; Nomeie admin com uma senha de P@$$w0rd12 .
Em seguida, abra o arquivo appSettings.development.json. Localize a propriedade Connectionstring e atualize -a para corresponder ao seu nome de rede de ampla área encontrado na guia Capella Portal UI Connect. Observe que Capella usa o TLS para que a sequência de conexão deve começar com CouchBases: //. Essa configuração foi projetada apenas para ambientes de desenvolvimento.
"Couchbase" : {
"BucketName" : " user_profile " ,
"ScopeName" : " _default " ,
"CollectionName" : " profile " ,
"ConnectionString" : " couchbases://yourassignedhostname.cloud.couchbase.com " ,
"Username" : " admin " ,
"Password" : " P@$$w0rd12 " ,
"IgnoreRemoteCertificateNameMismatch" : true ,
"HttpIgnoreRemoteCertificateMismatch" : true ,
"KvIgnoreRemoteCertificateNameMismatch" : true
}Os usuários da Couchbase Capella que não seguem essas instruções receberão erros de exceção e o portal Swagger retornará erros ao executar as APIs.
Para usuários locais de instalação e docker, siga as instruções encontradas no site da documentação para criar um balde chamado user_profile . Em seguida, siga as instruções para criar um usuário; Nomeie admin com uma senha de P@$$w0rd12 . Para este tutorial, verifique se ele possui direitos Full Admin para que o aplicativo possa criar coleções e índices.
Em seguida, abra o arquivo appSsettings.development.json e valide as informações de configuração correspondem à sua configuração.
Nota: Para instalações do Docker e do Couchbase local, o Couchbase deve ser instalado e executado no localhost (http://127.0.0.1:8091) antes de executar o aplicativo ASP.NET.
Neste ponto, o aplicativo está pronto e você pode executá -lo:
cd src/Couchbase.Quickstart
dotnet runDepois que o site estiver em funcionamento, você poderá iniciar seu navegador e ir à página Iniciar Swagger para testar as APIs.
Para executar os testes de integração padrão, use os seguintes comandos:
cd ../Couchbase.Quickstart.IntegrationTests/
dotnet restore
dotnet build
dotnet test Este projeto foi baseado no projeto padrão do modelo ASP.NET e a API do tempo padrão foi removida.
A configuração de uma API de REST básica no ASP.NET APIs mínimas com Couchbase é bastante simples. Este projeto, quando a execução criará uma coleção, um índice para nossa consulta N1QL parametrizada e exibe operações básicas de CRUD necessárias na maioria dos aplicativos.
