“Lookup fields” customitzats en Django

Django, de manera genèrica, ens proveeix una API del seu ORM a través de la qual ens permet executar els “querysets” que necessitem de manera més o menys optima. Malgrat això, es pot donar el cas que necessitem realitzar algun tipus de consulta una mica més customitzada o millorada. Per a tal efecte, disposem de tota una sèrie d’eines, ja siguin els objectes Q, les expressions F, els Field Lookups, etc. Sobre aquest darrer grup, els Field lookup‘s tenim la possibilitat de definir els nostres propis.

Per a implementar un “Lookup field” hem d’implementar una classe que ens permeti personalitzar la part esquerra i la part dreta de la clàusula sql. Es fa estenent la classe Lookup del paquet “django.db.models.fields.Lookup” i, posteriorment, registrant aquest classe personalitzada amb el mètode register_lookup de la classe django.db.models.fields.Field. E.g.:

from django.db.models import Lookup
from django.db.models.fields import Field


class Lower(Lookup):
    """
    Custom lookup for postgres "lower" function implementation
    """

    lookup_name = 'lower'

    def as_sql(self, qn, connection):

        lhs, lhs_params = self.process_lhs(qn, connection)
        rhs, rhs_params = self.process_rhs(qn, connection)
        params = lhs_params + rhs_params
        return 'lower({}) = {}'.format(lhs, rhs), params

Field.register_lookup(Lower)

L’exemple en concret implementa la funcionalitat de comparar el contingut d’un camp en minúscula amb la cadena que nosaltres li passem. Hi ha varis punts importants:

lookup_name = 'lower'
Defineix el nom que emprarem per executar la clàusula.

lhs, lhs_params = self.process_lhs(qn, connection)
Compila la part esquerra de la clàusula

rhs, rhs_params = self.process_rhs(qn, connection)
Compila la part dreta de la clàusula

Field.register_lookup(Lower)
Registrem el custom lookup per tal de poder-lo emprar.

Finalment, un exemple d’ús del nostre custom lookup seria:

try:
    task = TransTask.objects.filter(object_class__lower=class_name).get()
except TransTask.DoesNotExist:
    task = None

object_class__lower=class_name
és la part on s’aplica el “custom lookup”. Compararà el contingut en minúscula del camp object_class amb el contingut de la variable class_name.

Deixa un comentari

L'adreça electrònica no es publicarà. Els camps necessaris estan marcats amb *