Quickstarters
CRUD Samples
¿Cómo crear una aplicación CRUD básica con Blazor?
41 min
descripción general esta guía te llevará a través de la construcción de una aplicación crud completa (crear, leer, actualizar, eliminar) utilizando blazor en este tutorial, configurarás un proyecto de back4app, diseñarás tu esquema de base de datos e integrarás tu frontend de blazor con back4app a través de apis rest este proceso te ayudará a establecer un backend robusto mientras aseguras que tu aplicación web pueda gestionar datos de manera eficiente inicialmente, configurarás un proyecto de back4app titulado basic crud app blazor , que servirá como la columna vertebral de tu sistema de gestión de datos a continuación, crearás un diseño de base de datos escalable estableciendo colecciones y campos detallados, ya sea manualmente o con la ayuda del agente ai de back4app después de eso, aprovecharás el poder de la aplicación administrativa de back4app—una interfaz fácil de usar, de arrastrar y soltar—para gestionar tus colecciones sin esfuerzo finalmente, conectarás tu frontend de blazor a back4app utilizando apis rest y asegurarás tu backend con un control de acceso adecuado al final de este tutorial, tendrás una aplicación web lista para producción que soporta operaciones crud esenciales junto con autenticación de usuarios y actualizaciones de datos seguras puntos clave de aprendizaje construir aplicaciones crud que manejen operaciones de datos sin problemas utilizando un backend confiable adquirir conocimientos sobre la creación de un backend escalable e integrarlo con un frontend de blazor utilizar las capacidades de arrastrar y soltar de la aplicación de administración de back4app para simplificar la gestión de datos aprender técnicas de implementación, incluyendo la contenedorización con docker, para lanzar rápidamente tu aplicación requisitos previos antes de comenzar, asegúrate de tener una cuenta de back4app y un nuevo proyecto configurado visita introducción a back4app https //www back4app com/docs/get started/new parse app si necesitas ayuda un entorno de desarrollo de blazor usa visual studio o visual studio code con el sdk de net más reciente (versión 6 o superior) conocimientos básicos de c#, blazor y apis restful consulta la documentación de blazor https //docs microsoft com/en us/aspnet/core/blazor si es necesario paso 1 – configuración inicial del proyecto estableciendo un nuevo proyecto en back4app inicia sesión en tu cuenta de back4app selecciona el botón “nueva aplicación” desde tu panel de control ingresa el título del proyecto basic crud app blazor y sigue las instrucciones en pantalla para completar el proceso de creación crear nuevo proyecto después de la configuración, tu nuevo proyecto se mostrará en tu panel de control, proporcionando una base sólida para configurar tu backend paso 2 – diseñando el esquema de tu base de datos creando tu modelo de datos para esta aplicación crud básica, necesitarás crear varias colecciones a continuación se presentan ejemplos de las colecciones junto con los campos requeridos y los tipos de datos para configurar tu base de datos de manera eficiente 1\ colección de artículos campo tipo de dato propósito id objectid identificador único generado automáticamente título cadena el nombre o título del artículo descripción cadena un breve resumen del artículo creado en fecha la marca de tiempo cuando se creó el elemento actualizado en fecha la marca de tiempo cuando el elemento fue modificado por última vez 2\ colección de usuarios campo tipo de dato propósito id objectid identificador único generado automáticamente nombre de usuario cadena identificador único para el usuario correo electrónico cadena dirección de correo electrónico del usuario hash de contraseña cadena contraseña encriptada para un inicio de sesión seguro creado en fecha marca de tiempo de la creación de la cuenta actualizado en fecha marca de tiempo de la última actualización de la cuenta puedes crear estas colecciones manualmente en el panel de control de back4app estableciendo una nueva clase para cada colección y añadiendo las columnas necesarias crear nueva clase puedes definir columnas eligiendo un tipo de dato, nombrando el campo, estableciendo valores predeterminados y determinando si el campo es obligatorio crear columna empleando el agente ai de back4app para la creación de esquemas el agente ai de back4app simplifica la creación de esquemas directamente desde tu panel de control al ingresar un aviso detallando tus colecciones y campos, el agente ai genera automáticamente el esquema de base de datos necesario cómo utilizar el agente ai accede al agente ai inicia sesión en tu panel de back4app y localiza el agente ai en la configuración o en el menú principal define tu modelo de datos pega un aviso descriptivo que enumere las colecciones y sus campos revisa y confirma verifica el esquema sugerido y aplícalo a tu proyecto ejemplo de aviso create the following collections in my back4app project 1\) collection items \ fields \ id objectid (auto generated) \ title string \ description string \ created at date (auto generated) \ updated at date (auto updated) 2\) collection users \ fields \ id objectid (auto generated) \ username string (unique) \ email string (unique) \ password hash string \ created at date (auto generated) \ updated at date (auto updated) usar este agente ai no solo ahorra tiempo, sino que también asegura una configuración de esquema consistente y eficiente paso 3 – activando la aplicación de administración y gestionando operaciones crud introducción a la aplicación de administración la aplicación de administración de back4app proporciona una interfaz sin código, de arrastrar y soltar para gestionar tus datos de backend esta herramienta intuitiva te permite realizar operaciones crud con facilidad activando la aplicación de administración navega al “más” menú en tu panel de back4app haz clic en “aplicación de administración” y luego selecciona “habilitar aplicación de administración ” configura tus credenciales de administrador creando un usuario administrador inicial, lo que también establecerá roles predeterminados y colecciones del sistema habilitar aplicación de administración después de habilitar, inicia sesión en la aplicación de administración para gestionar tus colecciones y datos panel de administración de la aplicación realizando operaciones crud con la aplicación de administración dentro de la aplicación de administración puedes crear registros haz clic en el botón “agregar registro” dentro de una colección (por ejemplo, artículos) para agregar nuevas entradas leer/actualizar registros haz clic en un registro para inspeccionar sus detalles o modificar sus campos eliminar registros elimina entradas que ya no son necesarias esta interfaz simple, de arrastrar y soltar, mejora significativamente la experiencia de gestión de datos paso 4 – conectando blazor con back4app ahora que tu backend está configurado, es hora de integrar tu frontend de blazor con back4app usando apis rest en blazor dado que el sdk de parse no es aplicable a blazor, aprovecharás las apis rest para realizar operaciones crud en tu aplicación blazor, utiliza el httpclient para interactuar con los puntos finales rest de back4app ejemplo recuperando elementos a través de rest crea un servicio en tu proyecto blazor para recuperar elementos por ejemplo // services/itemservice cs using system net http; using system net http headers; using system text json; using system threading tasks; using system collections generic; public class item { public string id { get; set; } public string title { get; set; } public string description { get; set; } } public class itemservice { private readonly httpclient httpclient; private const string baseurl = "https //parseapi back4app com/classes/items"; public itemservice(httpclient httpclient) { httpclient = httpclient; httpclient defaultrequestheaders add("x parse application id", "your application id"); httpclient defaultrequestheaders add("x parse rest api key", "your rest api key"); } public async task\<list\<item>> getitemsasync() { var response = await httpclient getasync(baseurl); response ensuresuccessstatuscode(); var json = await response content readasstringasync(); var itemsdata = jsonserializer deserialize\<itemsresponse>(json); return itemsdata results; } } public class itemsresponse { public list\<item> results { get; set; } } integra tales llamadas a la api dentro de tus componentes blazor para gestionar operaciones crud paso 5 – asegurando tu backend implementando listas de control de acceso (acls) protege tus datos estableciendo acls en tus objetos por ejemplo, para crear un elemento privado public async task createprivateitemasync(item newitem, string ownerid) { // prepare your item data with proper access controls // in your rest call, include acl information as required by your backend // this is a conceptual example; refer to back4app documentation for acl details } configurando permisos a nivel de clase (clps) dentro del panel de control de back4app, ajusta los clps para cada colección para asegurar que solo los usuarios autorizados puedan acceder o modificar datos sensibles paso 6 – gestionando la autenticación de usuarios configurando cuentas de usuario en blazor back4app utiliza la clase user de parse para manejar la autenticación en tu aplicación blazor, gestiona el registro e inicio de sesión de usuarios a través de llamadas rest por ejemplo // services/authservice cs using system net http; using system net http json; using system threading tasks; public class authservice { private readonly httpclient httpclient; private const string signupurl = "https //parseapi back4app com/users"; public authservice(httpclient httpclient) { httpclient = httpclient; httpclient defaultrequestheaders add("x parse application id", "your application id"); httpclient defaultrequestheaders add("x parse rest api key", "your rest api key"); } public async task signupasync(string username, string password, string email) { var user = new { username, password, email }; var response = await httpclient postasjsonasync(signupurl, user); response ensuresuccessstatuscode(); // handle success, such as storing tokens or redirecting the user } } métodos similares se pueden implementar para el inicio de sesión y la gestión de sesiones funcionalidades adicionales como inicios de sesión sociales, verificación de correo electrónico y recuperación de contraseña se pueden configurar a través del panel de control de back4app paso 7 – desplegando tu frontend de blazor la función de despliegue web de back4app te permite alojar sin problemas tu aplicación blazor desplegando tu código desde un repositorio de github 7 1 creando tu build de producción abre el directorio de tu proyecto en una terminal ejecuta el comando de publicación dotnet publish c release este comando genera una carpeta publicada con archivos estáticos optimizados para tu aplicación blazor verifica la construcción confirma que la carpeta de salida contiene los archivos necesarios (por ejemplo, index html , javascript, css, etc ) 7 2 organizando y subiendo tu código tu repositorio de git debe encapsular la fuente completa de tu aplicación blazor una estructura de carpetas de ejemplo podría ser basic crud app blazor frontend/ \| wwwroot/ \| | index html \| pages/ \| | index razor \| | items razor \| | login razor \| services/ \| | itemservice cs \| | authservice cs \| program cs \| basic crud app blazor csproj \| readme md archivo de ejemplo program cs using microsoft aspnetcore components web; using microsoft aspnetcore components webassembly hosting; using basic crud app blazor; using basic crud app blazor services; var builder = webassemblyhostbuilder createdefault(args); builder rootcomponents add\<app>("#app"); builder rootcomponents add\<headoutlet>("head after"); builder services addscoped(sp => new httpclient { baseaddress = new uri(builder hostenvironment baseaddress) }); builder services addscoped\<itemservice>(); builder services addscoped\<authservice>(); await builder build() runasync(); confirmar y enviar a github inicializa git en tu carpeta de proyecto (si no se ha hecho ya) git init agrega tus archivos git add confirma tus cambios git commit m "confirmación inicial del código fuente del frontend de blazor" crea un repositorio en github nómbralo basic crud app blazor frontend envía tu repositorio git remote add origin https //github com/tu nombre de usuario/basic crud app blazor frontend git git push u origin main 7 3 integrando tu repositorio con el despliegue web accede a la opción de despliegue web en tu panel de back4app, abre tu proyecto ( basic crud app blazor ) y navega a la sección de despliegue web conecta tu cuenta de github sigue las instrucciones para vincular tu cuenta de github, permitiendo que back4app acceda a tu repositorio selecciona el repositorio y la rama elige el repositorio (por ejemplo, basic crud app blazor frontend ) y la rama (por ejemplo, main ) que contiene tu código blazor 7 4 configuración de despliegue proporcione detalles adicionales como comando de construcción si la carpeta publicada no está pre generada, especifique un comando como dotnet publish c release directorio de salida establezca la ruta de salida (por ejemplo, bin/release/net6 0/wwwroot ) variables de entorno agregue cualquier configuración de entorno requerida (como claves api) en la configuración 7 5 contenerizando su aplicación blazor con docker si prefiere docker para el despliegue, incluya un dockerfile en su repositorio aquí hay un ejemplo \# use the official net sdk image for building the app from mcr microsoft com/dotnet/sdk 6 0 as build workdir /src copy \["basic crud app blazor csproj", " /"] run dotnet restore "basic crud app blazor csproj" copy run dotnet publish "basic crud app blazor csproj" c release o /app/publish \# use the official asp net core runtime image to run the app from mcr microsoft com/dotnet/aspnet 6 0 as runtime workdir /app copy from=build /app/publish expose 80 entrypoint \["dotnet", "basic crud app blazor dll"] luego, en la configuración de despliegue web, seleccione la opción docker para desplegar su aplicación contenerizada 7 6 lanzando tu aplicación iniciar el despliegue haz clic en el desplegar botón en el panel de back4app monitorear la construcción back4app obtendrá tu código de github, ejecutará el comando de construcción si es necesario, y desplegará tu aplicación en un contenedor obtén tu url una vez que el proceso de despliegue esté completo, back4app proporcionará una url para tu aplicación blazor alojada 7 7 confirmando el despliegue abre la url proporcionada visita la url en un navegador para ver tu aplicación desplegada prueba la aplicación verifica que todas las páginas se carguen correctamente y que las operaciones crud funcionen como se espera soluciona problemas si es necesario utiliza las herramientas de desarrollador del navegador y revisa los registros de despliegue en back4app para diagnosticar cualquier problema paso 8 – resumen y exploración adicional ¡felicidades! has construido con éxito una aplicación crud básica utilizando blazor y back4app configuraste un proyecto titulado basic crud app blazor , diseñaste colecciones para items y users, y utilizaste la aplicación de administración de back4app para una gestión de datos sin problemas además, integraste tu frontend de blazor con back4app utilizando apis rest y aplicaste medidas de seguridad robustas pasos futuros expande tu frontend mejora tu aplicación blazor con vistas más detalladas, funcionalidad de búsqueda o notificaciones en vivo agrega características avanzadas considera incorporar funciones en la nube, integraciones de terceros o permisos basados en roles consulta recursos adicionales revisa la documentación de back4app https //www back4app com/docs y otros tutoriales avanzados para optimizar y expandir aún más tu aplicación siguiendo esta guía, ahora tienes la base para construir un backend crud escalable y seguro para tu aplicación blazor utilizando back4app ¡feliz codificación!