Scaffolding Entity

Cadre d'échafaudage

Création d'un projet de base sur un projet dans .NET avec entité Framework, unité de travail, un modèle de référentiel et une identité avec JWT Access Token.

Pour créer un nouveau crud pour une entité, vous devez faire:

Étape 1

Créer dans MBB.Abrigo.Core.Models modéliser votre entité

  public class Person
    {
        public string Id { get; set; }

        [Required]
        [MaxLength(50)]
        public string FirstName { get; set; }       
    }

Étape 2

Créer dans MBB.Abrigo.Core.DTO dto votre entité (DTO sera vu pour un client)

 public class PersonDTO
    {
        public string Id { get; set; }
        public string FirstName { get; set; }
    }

Étape 3

Vous devez ajouter une table dans DB, pour cela dans MBB.Abrigo.Infrastructure dans la classe BaseContext.cs Insérez la ligne suivante:

 public DbSet<Person> Persons { get; set; }

Étape 4

Créer dans MBB.Abrigo.Infrastructure.IRepository Une interface pour votre référentiel, après cela, vous devez créer dans MBB.Abrigo.Infrastructure.Repository votre référentiel.

Étape 5

Dans MBB.Abrigo.Infrastructure dans une classe UnitOfWork.cs vous devez ajouter un référentiel (modèle singleton) par exemple:

 public PersonRepository PersonRepository
        {
            get
            {
                if (this.personRepository == null)
                {
                    this.personRepository = new PersonRepository(context);
                }
                return personRepository;
            }
        }

Étape 6

Créer dans MBB.Abrigo.Infrastructure.IManager une interface pour les opérations que votre contrôleur recevra, après cela, mettre en œuvre ces opérations dans MBB.Abrigo.Infrastructure.Manager

Étape 7

Créer dans MBB.Abrigo.WebApi.Controller le contrôleur qui recevra les demandes du client, le contrôleur doit utiliser le gestionnaire. Par exemple:

 public class PersonController : ApiController
    {
        private PersonManager personManager = new PersonManager();

        // GET: api/Person
        public IEnumerable<PersonDTO> GetPersons()
        {
            return personManager.GetAll();
        }

}

Étape 8 - Sécurité JWT

Installer d'abord par console PM> Install-Package System.IdentityModel.Tokens.Jwt après cette création.

Étape 8.1

Ajouter MBB.Abrigo.WebApi.Models.AccountViewModels.cs Une classe pour le modèle de connexion, par exemple:

 public class LoginViewModel
    {
        public string Username { get; set; }
        public string Password { get; set; }
    }

Étape 8.2

Ajouter MBB.Abrigo.WebApi.Controllers.AccountController.cs un contrôleur de connexion, par exemple:

 public async Task<IHttpActionResult> Login(LoginViewModel model)
        {
            if (!ModelState.IsValid)
            {
                return BadRequest(ModelState);
            }

            var user = await UserManager.FindByEmailAsync(model.Username);
            
            if (user != null)
            {
                if (UserManager.CheckPassword(user, model.Password))
                {
                    var token = TokenGenerator.GenerateTokenJwt(model.Username);
                    return Ok(token);
                }
                else
                {
                   return Unauthorized();
                }
            }
            else
            {
                return Unauthorized();

            }
        }

Étape 8.3

Ajouter MBB.Abrigo.WebApi.Controllers.PersonController.cs l'autorisation des demandes, par exemple:

 // GET: api/Person
        [Authorize]
        public IEnumerable<PersonDTO> GetPersons()
        {
            return personManager.GetAll();
        }

Étape 8.4

Créez une classe pour la génération de jetons dans MBB.Abrigo.WebApi.Security . En voir plus dans ce répertoire.

Étape 8.5

Ajouter MBB.Abrigo.WebApi.App_Start.WebApiConfig.cs La ligne de code suivante:

 public static class WebApiConfig
    {
        public static void Register(HttpConfiguration config)
        {
            // Configuración de rutas y servicios de API
            config.MapHttpAttributeRoutes();

            config.MessageHandlers.Add(new TokenValidationHandler()); //THIS LINE TO ADD

            config.Routes.MapHttpRoute(
                name: "DefaultApi",
                routeTemplate: "api/{controller}/{id}",
                defaults: new { id = RouteParameter.Optional }
            );
        }
    }

Étape 8.6

Ajouter MBB.Abrigo.WebApi.WebApi.cs la ligne de code suivante:

 <appSettings>
    <add key="JWT_SECRET_KEY"     value="clave-secreta-api"/>
    <add key="JWT_AUDIENCE_TOKEN" value="http://localhost:49220"/>
    <add key="JWT_ISSUER_TOKEN"   value="http://localhost:49220"/>
    <add key="JWT_EXPIRE_MINUTES" value="30"/>   
  </appSettings>

N'oubliez pas d'utiliser JWT avec le jeton Bearier dans le facteur ou un autre débogueur Web.

Contact

Pour toute question ou suggestion, communiquez avec ([email protected])