Appearance
Class method and Static method - Методы @classmethod и @staticmethod
Обычный метод класса получает self — ссылку на экземпляр. Но есть ситуации, когда методу нужен не экземпляр, а сам класс (@classmethod), либо вообще ничего из класса (@staticmethod).
Три вида методов
| Вид | Первый параметр | Доступ к | Когда нужен |
|---|---|---|---|
| обычный | self (экземпляр) | self.*, Class.* | логика, привязанная к объекту |
@classmethod | cls (класс) | cls.* | фабрики-конструкторы, счётчики, работа с классом |
@staticmethod | отсутствует | только аргументы | вспомогательная функция, логически связанная с классом |
@staticmethod — функция в пространстве имён класса
Статический метод не получает ни self, ни cls. Это обычная функция, «переехавшая» внутрь класса ради группировки:
python
class ParcelBox:
material = 'paper'
def __init__(self, length, width, height):
self.length, self.width, self.height = length, width, height
@staticmethod
def volume(length, width, height):
"""Вычислить объём без создания объекта."""
return length * width * height
print(ParcelBox.volume(2, 3, 4)) # 24
box = ParcelBox(2, 3, 4)
print(box.volume(5, 6, 7)) # 210 — вызов через экземпляр тоже работает@classmethod — метод, которому нужен класс
Первый параметр cls — сам класс, а не экземпляр. Типичное применение — альтернативные конструкторы (фабрики):
python
class ParcelBox:
material = 'paper'
count = 0 # общий счётчик всех коробок
def __init__(self, length, width, height):
self.length, self.width, self.height = length, width, height
ParcelBox.count += 1
@classmethod
def get_box_small(cls):
"""Фабричный метод для создания маленькой коробки (куб 1x1x1)."""
return cls(1, 1, 1)
@classmethod
def get_box_middle(cls):
"""Фабричный метод для создания средней коробки (куб 5x5x5)."""
return cls(5, 5, 5)
@classmethod
def get_box_large(cls):
"""Фабричный метод для создания большой коробки (куб 10x10x10)."""
return cls(10, 10, 10)
@classmethod
def from_volume(cls, volume):
"""Создать куб по заданному объёму."""
side = round(volume ** (1 / 3), 2)
return cls(side, side, side)
@classmethod
def show_count(cls):
print(f'Создано коробок: {cls.count}')
# Использование фабричных методов
box_small = ParcelBox.get_box_small()
print(box_small, box_small.__dict__)
box_large = ParcelBox.get_box_large()
print(box_large, box_large.__dict__)
# Создание через объем
box = ParcelBox.from_volume(8)
print(box.length, type(box) is ParcelBox) # 2.0 True
# Обычное создание через __init__
box = ParcelBox(1, 1, 1)
print(box.__dict__)
# Проверка общего счетчика
ParcelBox.show_count() # Создано коробок: 4Пояснения к коду
- Фабричные методы (
get_box_small,get_box_middle,get_box_large): Внутри этих методов вызовcls(...)— это динамическое обращение к конструктору класса. Вместо жестко прописанногоParcelBox(1, 1, 1)мы пишемcls(1, 1, 1). Это инициализирует и возвращает новый объект. - Параметр
cls: Когда мы вызываем метод какParcelBox.get_box_small(), Python автоматически передает сам классParcelBoxв качестве первого аргумента. - Метод
show_count: Показывает, что@classmethodудобен не только для создания объектов, но и для работы с атрибутами самого класса (в данном случае с глобальным счетчикомcount), без привязки к конкретному экземпляру.
Почему cls, а не имя класса?
Использование параметра cls вместо жестко прописанного имени класса ParcelBox защищает код от поломок при изменении проекта (рефакторинге).
Если в процессе разработки вы решите переименовать класс ParcelBox, например, в Container, то при явном использовании имени класса вам придется вручную искать и менять его во всех методах. Но если внутри методов используется cls, код продолжит работать автоматически. Переменная cls всегда динамически указывает на текущий класс, как бы он ни назывался на самом деле.
Пример защиты от переименования:
python
# Если мы решим переименовать класс, код внутри from_volume продолжит работать,
# так как cls автоматически примет новое актуальное имя класса.
class ParcelBox:
def __init__(self, side):
self.side = side
@classmethod
def from_volume(cls, volume):
side = round(volume ** (1 / 3), 2)
return cls(side) # Автоматически превращается в вызов ParcelBox(side)
box = ParcelBox.from_volume(27)
print(type(box) is ParcelBox) # True — фабрика вернула именно объект ParcelBoxСравнение вызовов
Методы класса (@classmethod) и статические методы (@staticmethod) можно вызывать как напрямую через сам класс, так и через его созданные объекты (экземпляры). Однако работают они с разным уровнем доступа к данным:
python
class ParcelBox:
def __init__(self, length, width, height):
self.length, self.width, self.height = length, width, height
@staticmethod
def get_static():
# Статический метод ведет себя как обычная изолированная функция.
# У него нет доступа ни к самому классу ParcelBox, ни к его внутренним переменным.
return 'static'
@classmethod
def get_class(cls):
# Метод класса всегда автоматически получает ссылку на класс (cls) в качестве первого аргумента,
# поэтому он имеет полный доступ к атрибутам и имени текущего класса.
return cls.__name__
# Вызов через класс
print(ParcelBox.get_static(), ParcelBox.get_class()) # static ParcelBox
# Вызов через экземпляр
box_instance = ParcelBox(1, 1, 1)
print(box_instance.get_static(), box_instance.get_class()) # static ParcelBoxГлавные отличия:
@classmethod— это метод, который накрепко связан с самим классом. Python автоматически передает ему класс в аргументcls. Этот метод незаменим, когда нужно создать альтернативный конструктор (фабрику объектов) или изменить настройки/счетчики самого класса.@staticmethod— это простая функция, которую поместили внутрь класса исключительно ради логической группировки кода. Она не получает никаких скрытых аргументов и не может влиять на переменные класса.
Проверьте себя
Какой первый параметр у метода с декоратором `@classmethod`?
Что такое `@staticmethod`?
Зачем фабричные методы пишут как `@classmethod`?
Почему внутри фабрики используют `cls`, а не имя `ParcelBox`?
Что делает атрибут класса `count` в примере урока?
Как можно вызывать `@classmethod` и `@staticmethod`?
Упражнения:
Создайте класс
Studentсо статическим методомis_adult(age), возвращающимTrue, если возраст больше 17:- Добавьте в
Studentатрибут классаenrolled(число зачисленных) и метод__init__, увеличивающий его. - Реализуйте
@classmethodfrom_full_name(cls, full_name), создающий студента из строки «Имя Фамилия». - Создайте наследника
Teacher(Student)и убедитесь, чтоTeacher.from_full_name('A B')возвращает объект типаTeacher.
- Добавьте в
Добавьте в класс
ParcelBoxиз урока:- атрибут класса
count(счётчик созданных коробок) и его инкремент в__init__; @classmethod show_count(cls), выводящийf'Создано коробок: {cls.count}';- фабрику
@classmethod from_side(cls, side)— квадратная коробка; @staticmethod check_side(side), возвращающуюTrue, если сторона положительна.
Создайте 3 коробки тремя разными способами (
from_side,from_volume,__init__) и убедитесь, чтоshow_countвыводит «Создано коробок: 3».- атрибут класса
Создайте класс
Converter, в котором все методы помечены@staticmethodи переводят температуру между единицами измерения:fahrenheit_to_celsius(fahrenheit)— °F в °C:°C = (°F – 32) × 5 ÷ 9;fahrenheit_to_kelvin(fahrenheit)— °F в K:K = (°F – 32) × 5 ÷ 9 + 273.15;celsius_to_kelvin(celsius)— °C в K:K = °C + 273.15;celsius_to_fahrenheit(celsius)— °C в °F:°F = °C × 9 ÷ 5 + 32;kelvin_to_celsius(kelvin)— K в °C:°C = K – 273.15;kelvin_to_fahrenheit(kelvin)— K в °F:°F = (K – 273.15) × 9 ÷ 5 + 32.
Убедитесь, что все методы можно вызвать без создания экземпляра класса:
pythonprint(Converter.fahrenheit_to_celsius(212)) # 100.0 print(Converter.celsius_to_fahrenheit(0)) # 32.0 print(Converter.kelvin_to_celsius(273.15)) # 0.0 print(round(Converter.fahrenheit_to_kelvin(-40), 2)) # 233.15 print(Converter.kelvin_to_fahrenheit(373.15)) # 212.0Создайте класс проверки строки как числа
NumberCheckerсо статическими методами (каждый принимает строку и возвращаетbool):is_positive_int— целое положительное число;is_negative_int— целое отрицательное число;is_int— целое число;is_positive_float— дробное положительное число;is_negative_float— дробное отрицательное число;is_float— дробное число;is_positive— положительное число;is_negative— отрицательное число;is_number— число;is_zero— ноль.
Постарайтесь переиспользовать уже написанные методы (например,
is_positive_intчерезis_intиis_positive). Проверьте работу методов на наборе тестовых строк. Используйте класс для проверки числовых полей калькулятора котенка (цена, количество, дней, года).Создайте класс
GoodCheckerс методами проверки строк для калькулятора котенка (каждый принимает строку и возвращаетbool):is_valid_name— название товара: не короче двух символов и содержит хотя бы одну букву;is_valid_quantity— количество товара: целое положительное число, не ноль;is_valid_price— цена товара: положительное число, не более двух знаков после запятой;is_valid_day— день: целое положительное число, не ноль;is_valid_year— год: целое или половинное число (например, 5 или 5.5), не ноль.
Используйте класс в решении программы калькулятора котенка.