Dekoraattorit

Dekoraattorit ovat Pythonin tehokas ominaisuus, jonka avulla voitte muuttaa funktioiden tai metodien toimintaa. Niitä käytetään usein toiminnallisuuden lisäämiseen funktioihin muuttamatta niiden koodia.

Tässä oppitunnissa opitte, mitä dekoraattorit ovat, kuinka niitä käytetään ja kuinka luotte omia dekoraattoreita.

Dekoraattori on funktio, joka ottaa toisen funktion syötteenä ja palauttaa uuden funktion, johon on lisätty toiminnallisuutta. Sitä käytetään usein syntaksin @decorator_name kanssa.

# Basic example of a decorator
def decorator(func):
    def wrapper():
        print("Before the function call")
        func()
        print("After the function call")
    return wrapper

@decorator
def say_hello():
    print("Hello!")

say_hello()

Kun käytätte dekoraattoria, Python korvaa alkuperäisen funktion dekoraattorin palauttamalla kääretoiminnolla.

# How decorators work
def decorator(func):
    def wrapper():
        print("Wrapper called")
        func()
    return wrapper

@decorator
def greet():
    print("Greetings!")

print(greet.__name__)  # Outputs: wrapper
greet()

Dekoraattorit voivat toimia argumentteja vastaanottavien funktioiden kanssa käyttämällä *args- ja **kwargs-parametreja kääretoiminnossa:

# Decorator for functions with arguments
def decorator(func):
    def wrapper(*args, **kwargs):
        print(f"Arguments: {args}, {kwargs}")
        return func(*args, **kwargs)
    return wrapper

@decorator
def add(a, b):
    return a + b

print(add(3, 5))

Voitte käyttää yhdessä funktiossa useita dekoratoreja. Ne otetaan käyttöön siinä järjestyksessä kuin ne esiintyvät ylhäältä alaspäin:

# Chaining multiple decorators
def decorator1(func):
    def wrapper():
        print("Decorator 1")
        func()
    return wrapper

def decorator2(func):
    def wrapper():
        print("Decorator 2")
        func()
    return wrapper

@decorator1
@decorator2
def greet():
    print("Hello!")

greet()

Parametroidut dekoratorit vastaanottavat argumentteja ja mahdollistavat joustavammat toiminnot:

# Parameterized decorator
def repeat(times):
    def decorator(func):
        def wrapper(*args, **kwargs):
            for _ in range(times):
                func(*args, **kwargs)
        return wrapper
    return decorator

@repeat(3)
def say_hello():
    print("Hello!")

say_hello()

Dekoratoreja käytetään yleisesti seuraaviin tarkoituksiin:

• Funktiokutsujen ja niiden argumenttien kirjaaminen lokiin.
• Funktioiden suoritusajan mittaaminen.
• Käyttöoikeuksien hallinta, esimerkiksi käyttäjän käyttöoikeuksien tarkistaminen.
• Tulosten tallentaminen välimuistiin suorituskyvyn parantamiseksi.

Python sisältää useita sisäänrakennettuja dekoratoreja, kuten:

• @staticmethod: Määrittää staattisen metodin.
• @classmethod: Määrittää luokkametodin.
• @property: Määrittää property-metodin.

Välttäkää seuraavia virheitä:

• Alkuperäisen funktion nimen ja dokumenttimerkkijonon säilyttämättä jättäminen (käyttäkää functools.wraps-toimintoa).
• Dekoratorien tarpeeton käyttäminen yksinkertaisissa tehtävissä.
• Argumenttien käsittelyn unohtaminen wrapper-funktiossa.

Tässä oppitunnissa opitte:

• Mitä dekoratorit ovat ja miten ne toimivat Pythonissa.
• Miten luodaan ja käytetään perusmuotoisia, parametroitua ja ketjutettuja dekoratoreja.
• Dekoratorien yleiset käyttötapaukset ja Pythonin sisäänrakennetut dekoratorit.

Hienosti tehty! Siirrytään seuraavaan aiheeseen.