← Volver al Hub de ArquitecturaMÓDULO 1 DE 4

1. URLs y Enrutamiento Avanzado 🌐

El enrutador de URLs es la primera parada en el patrón MVT de Django. Inspecciona la URL recibida en la petición HTTP y decide qué vista debe procesar la solicitud.

SUBMÓDULO 1.1

El Patrón MVT y el Enrutador de Rutas

Django organiza las aplicaciones bajo el patrón Model (ORM), View (Lógica) y Template (HTML). El enrutador analiza la URL solicitada y determina la vista receptora.

Arquitectura MVT de Django — Diagrama del patrón MVT en Django: URL Dispatcher -> View -> Model/Template (clic para ampliar).

SUBMÓDULO 1.2

Estructura Modular y Namespaces

En proyectos profesionales, el archivo principal config/urls.py delega el tráfico a las URLs de cada app mediante include() y define espacios de nombres para evitar colisiones entre rutas con el mismo nombre.

config/urls.py

PYTHON

# config/urls.py (Enrutador Principal del Proyecto)
from django.contrib import admin
from django.urls import path, include
 
urlpatterns = [
    path('admin/', admin.site.urls),
    
    # Delegación modular a la app 'biblioteca' con espacio de nombres
    path('biblioteca/', include('biblioteca.urls'), namespace='biblioteca'),
]

SUBMÓDULO 1.3

Path Converters Nativos

Django incluye 5 convertidores automáticos de rutas que capturan segmentos de la URL y los transforman al tipo de dato en Python antes de entregarlos a la vista:

<int:id>: Enteros positivos (ej: /libro/42/ → id = 42).
<slug:slug>: Cadenas alfanuméricas amigables para SEO (ej: /libro/clean-code/).
<str:cadena>: Texto simple sin barras (ej: /autor/gabriel/).
<uuid:token>: Identificadores UUID v4 (ej: /prestamo/550e8400-e29b-41d4-a716-446655440000/).
<path:subruta>: Captura rutas completas incluyendo barras (ej: /archivos/2024/09/doc.pdf).

biblioteca/urls.py

PYTHON

# biblioteca/urls.py (Enrutador de la Aplicación)
from django.urls import path
from . import views
 
app_name = 'biblioteca'
 
urlpatterns = [
    path('', views.catalogo_libros, name='catalogo'),
    path('libro/<int:pk>/', views.libro_detalle_id, name='libro_detalle_id'),
    path('libro/slug/<slug:slug>/', views.libro_detalle_slug, name='libro_detalle_slug'),
    path('prestamo/<uuid:codigo>/', views.comprobante_prestamo, name='comprobante_prestamo'),
]

SUBMÓDULO 1.4

Convertidores Personalizados (Custom Path Converters)

Permiten validar reglas de negocio complejas en la URL (como un código ISBN o un año de 4 dígitos) mediante una clase con atributo regex y métodos to_python() y to_url().

biblioteca/converters.py

PYTHON

# biblioteca/converters.py
import re
 
class ISBNConverter:
    """Valida códigos ISBN de 10 o 13 dígitos y limpia guiones automáticamente."""
    regex = r'(?:(?:d{3}[- ]?)?d{1,5}[- ]?d+[- ]?d+[- ]?[dX])'
 
    def to_python(self, value: str) -> str:
        return re.sub(r'[- ]', '', value)
 
    def to_url(self, value: str) -> str:
        return str(value)

Registro e integración en el archivo de rutas:

biblioteca/urls_custom.py

PYTHON

# biblioteca/urls.py
from django.urls import path, register_converter
from . import converters, views
 
register_converter(converters.ISBNConverter, 'isbn')
 
urlpatterns = [
    path('libro/isbn/<isbn:codigo>/', views.libro_por_isbn, name='libro_por_isbn'),
]

SUBMÓDULO 1.5

Expresiones Regulares con `re_path()`

Para patrones de ruta que requieren expresiones regulares exactas (como fechas combinadas con nombres de sección):

re_path.py

PYTHON

from django.urls import re_path
from . import views
 
urlpatterns = [
    re_path(
        r'^archivo/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/(?P<seccion>[a-zA-Z0-9_-]+)/$',
        views.archivo_historico,
        name='archivo_historico'
    ),
]

SUBMÓDULO 1.6

Query Parameters (Parámetros GET)

Los parámetros tras el signo de interrogación (?q=python&categoria=backend) se capturan en la vista mediante el diccionario de consulta request.GET:

captura_query_params.py

PYTHON

def catalogo_libros(request):
    busqueda = request.GET.get('q', '').strip()
    categoria = request.GET.get('categoria', None)
    tags_seleccionados = request.GET.getlist('tag')
    
    return render(request, 'catalogo.html', {
        'busqueda': busqueda,
        'categoria': categoria,
        'tags_seleccionados': tags_seleccionados,
    })

SUBMÓDULO 1.7

Generación Inversa de URLs (Reverse Resolution)

Evita URLs estáticas escritas a mano. Genera URLs dinámicamente con reverse() en Python o el tag {% url %} en las plantillas HTML:

reverse_python.py

PYTHON

# En vistas o redirecciones Python:
from django.urls import reverse
url_libro = reverse('biblioteca:libro_detalle_id', kwargs={'pk': 15})

url_template.html

HTML

<!-- En plantillas HTML: -->
<a href="{% url 'biblioteca:libro_detalle_slug' slug=libro.slug %}">
    Ver detalle de {{ libro.titulo }}
</a>

Contenido

📚 Cursos de Café y Código

1. URLs y Enrutamiento Avanzado 🌐

El Patrón MVT y el Enrutador de Rutas

Estructura Modular y Namespaces

Path Converters Nativos

Convertidores Personalizados (Custom Path Converters)

Expresiones Regulares con `re_path()`

Query Parameters (Parámetros GET)

Generación Inversa de URLs (Reverse Resolution)

¡Hecho con mucho cariño! ☕

El Patrón MVT y el Enrutador de Rutas

Estructura Modular y Namespaces

Path Converters Nativos

Convertidores Personalizados (Custom Path Converters)

Expresiones Regulares con re_path()

Query Parameters (Parámetros GET)

Generación Inversa de URLs (Reverse Resolution)

Expresiones Regulares con `re_path()`