Jugador Repository

Repository for managing player (Jugador) entities with team and position associations

Overview

The IRepositorioJugador interface and RepositorioJugador implementation provide data access operations for managing players. Each player is associated with a team (Equipo) and a position (Posicion).

Interface Definition

IRepositorioJugador.cs

using Torneo.App.Dominio;

namespace Torneo.App.Persistencia
{
    public interface IRepositorioJugador
    {
        public Jugador AddJugador(Jugador jugador, int idEquipo, int idPosicion);
        public IEnumerable<Jugador> GetAllJugadores();
        public Jugador GetJugador(int idJugador);
        public Jugador UpdateJugador(Jugador jugador, int idEquipo, int idPosicion);
        public Jugador DeleteJugador(int idJugador);
        public bool validateDuplicates(Jugador jugador, int idEquipo, int idPosicion);
    }
}

Implementation

RepositorioJugador.cs

using Microsoft.EntityFrameworkCore;
using Torneo.App.Dominio;

namespace Torneo.App.Persistencia
{
    public class RepositorioJugador : IRepositorioJugador
    {
        private DataContext _dataContext = new DataContext();
        
        // Implementation methods...
    }
}

Methods Reference

AddJugador

Adds a new player to the database with associations to team and position.

jugador · Jugador · required

The Jugador entity to add

idEquipo · int · required

The ID of the team the player belongs to

idPosicion · int · required

The ID of the player’s position

return · Jugador

The inserted Jugador entity with its generated ID and populated relationships

Implementation (Lines 8-17)

public Jugador AddJugador(Jugador jugador, int idEquipo, int idPosicion)
{
    var equipoEncontrado = _dataContext.Equipos.Find(idEquipo);
    var posicionEncontrada = _dataContext.Posiciones.Find(idPosicion);
    jugador.Equipo = equipoEncontrado == null ? null : equipoEncontrado;
    jugador.Posicion = posicionEncontrada == null ? null : posicionEncontrada;
    var jugadorInsertado = _dataContext.Jugadores.Add(jugador);
    _dataContext.SaveChanges();
    return jugadorInsertado.Entity;
}

Key Features:

• Validates team and position exist before association
• Sets relationships to null if referenced entities don’t exist
• Returns complete entity with relationships

Usage Example:

var nuevoJugador = new Jugador
{
    Nombre = "Carlos Rodríguez",
    Numero = 10
};

var jugadorCreado = repositorioJugador.AddJugador(
    nuevoJugador,
    idEquipo: 5,
    idPosicion: 3  // Delantero
);

Console.WriteLine($"Jugador creado: {jugadorCreado.Nombre} #{jugadorCreado.Numero}");
Console.WriteLine($"Equipo: {jugadorCreado.Equipo?.Nombre}");
Console.WriteLine($"Posición: {jugadorCreado.Posicion?.Nombre}");

---

GetAllJugadores

Retrieves all players with their team and position relationships.

return · IEnumerable<Jugador>

Collection of all Jugador entities with eagerly loaded Equipo and Posicion

Implementation (Lines 18-28)

public IEnumerable<Jugador> GetAllJugadores()
{
    var jugadores = _dataContext.Jugadores
                    .Include(j => j.Equipo)
                    .Include(j => j.Posicion)
                    .AsNoTracking()
                    .ToList();
    
    return jugadores;
}

Included Relationships:

• Equipo - The player’s team
• Posicion - The player’s position (e.g., Delantero, Defensa, etc.)

Usage Example:

var todosJugadores = repositorioJugador.GetAllJugadores();

foreach (var jugador in todosJugadores)
{
    Console.WriteLine($"#{jugador.Numero} {jugador.Nombre}");
    Console.WriteLine($"  Equipo: {jugador.Equipo?.Nombre}");
    Console.WriteLine($"  Posición: {jugador.Posicion?.Nombre}");
    Console.WriteLine();
}

---

GetJugador

Retrieves a specific player by ID with team and position relationships.

idJugador · int · required

The ID of the player to retrieve

return · Jugador

The Jugador entity with Equipo and Posicion loaded, or null if not found

Implementation (Lines 30-38)

public Jugador GetJugador(int idJugador)
{
    var jugadorEncontrado = _dataContext.Jugadores
                           .Include(j => j.Equipo)
                           .Include(j => j.Posicion)
                           .FirstOrDefault(j => j.Id == idJugador);
    
    return jugadorEncontrado;
}

Usage Example:

var jugador = repositorioJugador.GetJugador(15);

if (jugador != null)
{
    Console.WriteLine($"Jugador: {jugador.Nombre}");
    Console.WriteLine($"Número: {jugador.Numero}");
    Console.WriteLine($"Equipo: {jugador.Equipo?.Nombre}");
    Console.WriteLine($"Posición: {jugador.Posicion?.Nombre}");
}
else
{
    Console.WriteLine("Jugador no encontrado");
}

---

UpdateJugador

Updates an existing player’s information and relationships.

jugador · Jugador · required

The Jugador entity with updated values (must include valid Id)

idEquipo · int · required

The ID of the new or existing team

idPosicion · int · required

The ID of the new or existing position

return · Jugador

The updated Jugador entity with current relationships

Implementation (Lines 40-52)

public Jugador UpdateJugador(Jugador jugador, int idEquipo, int idPosicion)
{
    var jugadorEncontrado = GetJugador(jugador.Id);
    var equipoEncontrado = _dataContext.Equipos.Find(idEquipo);
    var posicionEncontrada= _dataContext.Posiciones.Find(idPosicion);
    jugadorEncontrado.Nombre = jugador.Nombre;
    jugadorEncontrado.Numero = jugador.Numero;
    jugadorEncontrado.Equipo = equipoEncontrado == null ? null : equipoEncontrado;
    jugadorEncontrado.Posicion = posicionEncontrada == null ? null : posicionEncontrada;
    _dataContext.SaveChanges();
    
    return jugadorEncontrado;
}

Updated Properties:

• Nombre - Player name
• Numero - Jersey number
• Equipo - Associated team
• Posicion - Player position

Usage Example:

var jugador = repositorioJugador.GetJugador(15);
if (jugador != null)
{
    jugador.Numero = 7;  // Change jersey number
    jugador.Nombre = "Carlos Alberto Rodríguez";
    
    var jugadorActualizado = repositorioJugador.UpdateJugador(
        jugador,
        idEquipo: 5,      // Same team
        idPosicion: 2     // New position: Mediocampista
    );
    
    Console.WriteLine($"Jugador actualizado: {jugadorActualizado.Nombre} #{jugadorActualizado.Numero}");
    Console.WriteLine($"Nueva posición: {jugadorActualizado.Posicion?.Nombre}");
}

---

DeleteJugador

Deletes a player from the database.

idJugador · int · required

The ID of the player to delete

return · Jugador

The deleted Jugador entity

exception · Exception

Throws exception with message “Jugador not found” if the ID doesn’t exist

Implementation (Lines 54-65)

public Jugador DeleteJugador(int idJugador)
{
    var jugadorEncontrado = _dataContext.Jugadores.Find(idJugador);
    if (jugadorEncontrado != null)
    {
        _dataContext.Jugadores.Remove(jugadorEncontrado);
        _dataContext.SaveChanges();
    }
    else
    {
        Console.WriteLine("No se encontró el Jugador");
    }
    return jugadorEncontrado ?? throw new Exception("Jugador not found");
}

Usage Example:

try
{
    var jugadorEliminado = repositorioJugador.DeleteJugador(15);
    Console.WriteLine($"Jugador eliminado: {jugadorEliminado.Nombre}");
}
catch (Exception ex)
{
    Console.WriteLine($"Error: {ex.Message}");
}

---

validateDuplicates

Validates whether a player with the same name, number, team, and position already exists.

jugador · Jugador · required

The Jugador entity to validate

idEquipo · int · required

The team ID to check against

idPosicion · int · required

The position ID to check against

return · bool

true if a duplicate player exists (different ID but same name, number, team, and position), false otherwise

Implementation (Lines 67-90)

public bool validateDuplicates(Jugador jugador, int idEquipo, int idPosicion)
{
    try
    {
        IEnumerable<Jugador> allJugadores = GetAllJugadores();
        bool duplicado = false;
        
        foreach(Jugador j in allJugadores)
        {
            if(jugador.Id != j.Id)
            {
                if(j.Nombre.ToLower() == jugador.Nombre.ToLower().Trim() 
                   && j.Numero == jugador.Numero 
                   && j.Equipo.Id == idEquipo 
                   && j.Posicion.Id == idPosicion)
                {
                    duplicado = true;
                }
            }
        }
        
        Console.WriteLine("Jugador duplicado al Crear/Editar " + jugador.Nombre + " - " + duplicado);
        return duplicado;
    }
    catch(Exception e)
    {
        Console.WriteLine("Error Validacion " + e.Message);
        return false;
    }
}

Validation Logic:

1. Case-insensitive name comparison
2. Exact number match
3. Same team ID
4. Same position ID
5. Excludes current player when updating (checks jugador.Id != j.Id)

Usage Example:

var nuevoJugador = new Jugador
{
    Nombre = "Carlos Rodríguez",
    Numero = 10
};

if (repositorioJugador.validateDuplicates(nuevoJugador, idEquipo: 5, idPosicion: 3))
{
    Console.WriteLine("Error: Ya existe un jugador con el mismo nombre, número, equipo y posición");
}
else
{
    repositorioJugador.AddJugador(nuevoJugador, idEquipo: 5, idPosicion: 3);
    Console.WriteLine("Jugador creado exitosamente");
}

The duplicate validation checks ALL four fields (name, number, team, position). A player can have the same name or number if they play in a different team or position.

Dependency Injection

Register the repository in Program.cs:

Program.cs (Line 21)

builder.Services.AddSingleton<IRepositorioJugador, RepositorioJugador>();

Inject into controllers:

public class JugadorController : Controller
{
    private readonly IRepositorioJugador _repositorioJugador;
    private readonly IRepositorioEquipo _repositorioEquipo;
    private readonly IRepositorioPosicion _repositorioPosicion;
    
    public JugadorController(
        IRepositorioJugador repositorioJugador,
        IRepositorioEquipo repositorioEquipo,
        IRepositorioPosicion repositorioPosicion)
    {
        _repositorioJugador = repositorioJugador;
        _repositorioEquipo = repositorioEquipo;
        _repositorioPosicion = repositorioPosicion;
    }
}

Common Workflows

Adding a Player to a Team

// 1. Create player entity
var jugador = new Jugador
{
    Nombre = "Carlos Rodríguez",
    Numero = 10
};

// 2. Validate duplicates
int equipoId = 5;
int posicionId = 3; // Delantero

if (!repositorioJugador.validateDuplicates(jugador, equipoId, posicionId))
{
    // 3. Add player
    var resultado = repositorioJugador.AddJugador(jugador, equipoId, posicionId);
    Console.WriteLine($"Jugador {resultado.Nombre} #{resultado.Numero} agregado al equipo");
}
else
{
    Console.WriteLine("Ya existe un jugador con estos datos");
}

Transferring a Player to Another Team

// 1. Get player
var jugador = repositorioJugador.GetJugador(15);

if (jugador != null)
{
    int nuevoEquipoId = 8;
    int posicionActual = jugador.Posicion.Id;
    
    // 2. Validate transfer
    if (!repositorioJugador.validateDuplicates(jugador, nuevoEquipoId, posicionActual))
    {
        // 3. Update team
        var jugadorTransferido = repositorioJugador.UpdateJugador(
            jugador,
            idEquipo: nuevoEquipoId,
            idPosicion: posicionActual
        );
        
        Console.WriteLine($"{jugador.Nombre} transferido a {jugadorTransferido.Equipo?.Nombre}");
    }
}

Listing Players by Position

var todosJugadores = repositorioJugador.GetAllJugadores();

// Group by position
var jugadoresPorPosicion = todosJugadores
    .GroupBy(j => j.Posicion?.Nombre)
    .OrderBy(g => g.Key);

foreach (var grupo in jugadoresPorPosicion)
{
    Console.WriteLine($"\n{grupo.Key}:");
    foreach (var jugador in grupo.OrderBy(j => j.Numero))
    {
        Console.WriteLine($"  #{jugador.Numero} {jugador.Nombre} - {jugador.Equipo?.Nombre}");
    }
}

Finding Players by Team

var todosJugadores = repositorioJugador.GetAllJugadores();

// Filter by team
int equipoId = 5;
var jugadoresEquipo = todosJugadores
    .Where(j => j.Equipo?.Id == equipoId)
    .OrderBy(j => j.Numero)
    .ToList();

Console.WriteLine($"Jugadores del equipo (Total: {jugadoresEquipo.Count}):");
foreach (var jugador in jugadoresEquipo)
{
    Console.WriteLine($"#{jugador.Numero} {jugador.Nombre} - {jugador.Posicion?.Nombre}");
}

Related Entities

Jugador Entity

Domain model for players

Equipo Repository

Team data access

Posicion Repository

Position data access

Business Rules

Unique Player Constraint:

A player is considered unique by the combination of:

• Name (case-insensitive)
• Jersey number
• Team
• Position

This means:

• Same player can have different numbers in different teams
• Same number can be used by different players in different teams
• Same player can play different positions in different teams

Error Handling

The DeleteJugador method throws an exception when the player is not found. Always handle this exception:

try
{
    var resultado = repositorioJugador.DeleteJugador(15);
}
catch (Exception ex)
{
    Console.WriteLine($"Error: {ex.Message}");
}