Decorador de Método de Classe

Parte da seção Object Oriented Programming do Journey de Python da Coddy — lição 12 de 64.

O decorador @classmethod cria métodos que recebem a própria classe como o primeiro parâmetro (cls) em vez de uma instância (self).

Aqui está um exemplo de uma classe com métodos de classe:

class Student:
    school_name = "Python Academy"
    student_count = 0
    
    def __init__(self, name):
        self.name = name
        Student.student_count += 1
    
    @classmethod
    def get_school_info(cls):
        return f"School: {cls.school_name}, Students: {cls.student_count}"
    
    @classmethod
    def create_guest_student(cls):
        return cls("Guest")

Chame métodos de classe usando o nome da classe:

info = Student.get_school_info()
print(info)

Crie alguns estudantes:

alice = Student("Alice")
bob = Student("Bob")

updated_info = Student.get_school_info()
print(updated_info)

Use métodos de classe como construtores alternativos:

guest = Student.create_guest_student()
print(guest.name)
print(Student.get_school_info())

Saída:

School: Python Academy, Students: 0
School: Python Academy, Students: 2
Guest
School: Python Academy, Students: 3

Métodos de classe também podem ser chamados a partir de instâncias:

alice = Student("Alice")
info_from_instance = alice.get_school_info()
print(info_from_instance)

Saída:

School: Python Academy, Students: 1

Ponto Chave: Use @classmethod quando você precisar acessar atributos da classe ou criar formas alternativas de construir objetos. O primeiro parâmetro é cls (a própria classe), não self.

Folha de consulta

O decorador @classmethod cria métodos que recebem a própria classe como o primeiro parâmetro (cls) em vez de uma instância (self).

class Student:
    school_name = "Python Academy"
    student_count = 0
    
    def __init__(self, name):
        self.name = name
        Student.student_count += 1
    
    @classmethod
    def get_school_info(cls):
        return f"School: {cls.school_name}, Students: {cls.student_count}"
    
    @classmethod
    def create_guest_student(cls):
        return cls("Guest")

Chame métodos de classe usando o nome da classe:

info = Student.get_school_info()
guest = Student.create_guest_student()

Métodos de classe também podem ser chamados a partir de instâncias:

alice = Student("Alice")
info_from_instance = alice.get_school_info()

Use @classmethod quando precisar acessar atributos de classe ou criar formas alternativas de construir objetos.

Experimente você mesmo

Esta lição não inclui um desafio de código.

Teste seus conhecimentos

Esta lição inclui um quiz rápido. Comece a lição para respondê-lo e acompanhar seu progresso.

Todas as lições de Object Oriented Programming

2Decoradores

Introdução aos Decoradores Decorador de Propriedade Decorador de Método EstáticoDecorador de Método de Classe

5Polimorfismo

Sobrescrita de Método Revisitada Duck Typing Classes e Métodos Abstratos Design de Interfaces Recapitulação - Calculadora de Formas

8Conceitos Avançados de POO

Composição vs Herança Mixins Métodos Estáticos e de Classe Decoradores de Classe Gerenciadores de Contexto

11Padrões de Projeto Parte 2

Padrão Command Padrão Adapter Padrão Decorator Padrão Template Method Padrão State Padrão Composite

3Propriedades de Classe

Variáveis de Instância vs de Classe Decoradores de Propriedade Atributos Privados Recapitulação - Gerenciador de Conta Bancária

6Encapsulamento

Membros Públicos, Protegidos e Privados Modificadores de Acesso Ocultação de Informação Property Decorators Avançados Recapitulação - Sistema de Registro de Alunos

9Argumentos Avançados

O *args O **kwarg

12Projeto: Gerenciamento de Biblioteca

Visão Geral do Projeto Classes Livro e Usuário

Sistema de Empréstimos

Funcionalidade de Busca

Interface Administrativa

Testes e Integração