La nueva "moda" en el mundo Microsoft .NET es Marco .NET CoreCouchbase Core: una implementación de código abierto y multiplataforma (OSX, Linux y Windows) del framework .NET. En un esfuerzo por ofrecer el mejor entorno para desarrolladores, Couchbase lanza hoy un SDK compatible con .NET Core. Esta versión inicial es una vista previa para desarrolladores, y en realidad es compatible con .NET Framework 4.5 y .NET Core 1.0. Más sobre esto más adelante.
¿Qué incluye este paquete?
Si estás siguiendo el SDK .NET de Couchbase, te habrás dado cuenta de que hemos subido la versión menor de 2.3.X a 2.4.X en esta versión. La razón es que la versión final GA de 2.4.0 contendrá varias nuevas características que amplían esta API de cara al público del SDK:
- Autenticación a nivel de clúster
- API de estructuras de datos
- Consulta a nivel de clúster
- Búsqueda genérica
Estas funciones se están desarrollando o están a punto de empezar a desarrollarse y llegarán a los próximos PD's. esta versión, DP1, sólo incluye compatibilidad con .NET Core.
Es importante tener en cuenta que este paquete incluye tanto .NET Framework 4.5 (nuestra versión .NET base compatible con el SDK) como .NET Core 1.0 (a través de NetStandard1.5). Su tipo de proyecto de destino determinará qué versión del SDK se utiliza. También significa que el paquete NuGet será compatible con el código existente. siempre que no convierta sus proyectos en proyectos .NET Core.
Adicionalmente, hay una alta probabilidad de que el SDK no soporte métodos síncronos para la versión final de .NET Core; esto se debe a que Microsoft se ha estado alejando de las antiguas API síncronas hacia todo lo asíncrono. Aún podrá llamar a los métodos asíncronos de forma síncrona a través de Task.Result, sólo que no ofreceremos una versión síncrona pura.
Introducción a Linux
En la siguiente sección mostraré como usar Couchbase .NET Core 2.4.0-dp1 en una simple aplicación de consola corriendo en Ubuntu 14.0.4. Asumo que ya has instalado .NET Core 1.0.1 en la máquina, si no lo has hecho por favor sigue estos pasos direcciones. También asume que ha instalado Couchbase Server 4.5. Si no lo ha hecho descárguelo e instálelo.
Primero abre un terminal y crea un directorio llamado cb-core-example y luego cambia a ese directorio y ejecuta dotnet new:
Usando VIM o tu editor favorito, abre el archivo project.json que se creó cuando ejecutaste dotnet new. Añade la dependencia al paquete CouchbaseNetClient en NuGet get, especificando la versión correcta (2.4.0-dp1):
De nuevo usando VIM o tu editor favorito, abre el archivo Program.cs e introduce el siguiente código:
Una vez hecho esto, sólo tienes que hacer un dotnet restore y dotnet run para actualizar las dependencias y ejecutar la aplicación. Si todo funciona, deberías ver las palabras SUCCESS escritas en el terminal.
Una vez más, los comandos son los siguientes:
1 2 3 4 5 6 7 |
mkdir cb-núcleo-ejemplo1 cd cb-núcleo-ejemplo1 dotnet nuevo vim proyecto.json vim Programa.cs dotnet restaurar dotnet ejecute |
Agradecimientos de la Comunidad
Este avance para desarrolladores se ha estado preparando durante meses y ha contado con varias contribuciones de la comunidad. Un gran agradecimiento a Brant Burnett, de CenterEdge Software para realizar contribuciones al núcleo y orientación con el empaquetado y las migraciones de API a bibliotecas compatibles con el núcleo.
Contribución y notificación de errores
El SDK .NET de Couchbase siempre está buscando contribuciones y comentarios de la comunidad. Si desea contribuir, el El repositorio de Github está aquí. Si encuentra un error, cree un Jira ticket o hacer un puesto en el foro.
¿Cómo conseguirlo?
- Instale el Paquete NuGet.
- Clonar el Repo de Github
- Descargar los binarios
[...] La incorporación de la compatibilidad directa con listas, mapas, conjuntos y colas en la API de subdocumentos mediante la nueva función SDK de estructura de datos simplifica aún más el desarrollo de aplicaciones. Las nuevas estructuras de datos funcionan sin problemas con la misma representación de datos subyacente, permitiendo a los desarrolladores en N1QL, Java, .NET, y otros lenguajes acceder a los mismos datos a través de diferentes lenguajes de programación e interfaces.Añadir soporte .NET Core permite a los desarrolladores de aplicaciones de Microsoft desarrollar e integrar fácilmente sus aplicaciones con Couchbase Server. Consulta la documentación de Estructuras de datos y el blog de .NET Core. [...]