python——常用公共类

在Python中，通用的公共类（即可以跨多个模块或项目使用的类）通常设计为高度可复用的组件，它们提供了基础功能或者特定领域的抽象接口。编写公共类时，需要注意设计原则，包括单一职责原则、开放封闭原则等，确保类的可扩展性和灵活性。以下是一些编写公共类的方法以及适用场景：

1. 抽象基类 (ABC, Abstract Base Classes)

场景：当需要定义一组共同的接口规范时，可以使用抽象基类。抽象基类主要用于继承，规定了子类必须实现哪些方法。

代码示例：

from abc import ABC, abstractmethod

class Animal(ABC):
    @abstractmethod
    def speak(self):
        pass

class Dog(Animal):
    def speak(self):
        return "Woof!"

class Cat(Animal):
    def speak(self):
        return "Meow!"

animal = Dog()
print(animal.speak())  # 输出 "Woof!"

2. 工具类或服务类

场景：提供通用的服务或工具方法，这类类通常包含一系列静态方法或类方法，可以被任何地方调用。

代码示例：

class StringUtils:
    @staticmethod
    def capitalize_first_char(string):
        return string[0].upper() + string[1:]

    @classmethod
    def pluralize(cls, word, count):
        if count != 1:
            return word + 's'
        return word

print(StringUtils.capitalize_first_char('hello'))  # 输出 "Hello"
print(StringUtils.pluralize('apple', 3))  # 输出 "apples"

3. 数据容器类

场景：封装数据结构和相关的操作方法，提供统一的数据处理接口。

代码示例：

class DataContainer:
    def __init__(self, data):
        self._data = data

    def sort_by_key(self, key_func):
        self._data.sort(key=key_func)

    def filter_items(self, condition_func):
        self._data = [item for item in self._data if condition_func(item)]

    def to_list(self):
        return list(self._data)

data_container = DataContainer([{"name": "Alice", "age": 25}, {"name": "Bob", "age": 30}])
data_container.sort_by_key(lambda x: x["age"])
print(data_container.to_list())

4. 资源管理类（例如数据库连接池）

场景：提供统一的资源获取和释放接口，适用于数据库连接、线程锁等场景。

代码示例（简化版）：

import threading

class ConnectionPool:
    def __init__(self, max_connections):
        self.connections = []
        self.max_connections = max_connections
        self.lock = threading.Lock()

    def acquire_connection(self):
        with self.lock:
            if len(self.connections) < self.max_connections or not self.connections:
                # 创建新的连接
                connection = create_new_database_connection()
                self.connections.append(connection)
            else:
                # 从池中取出一个连接
                connection = self.connections.pop(0)
        return connection

    def release_connection(self, connection):
        with self.lock:
            self.connections.append(connection)

pool = ConnectionPool(5)
connection = pool.acquire_connection()
# 使用连接...
pool.release_connection(connection)

以上展示了四种不同类型的公共类编写方法，每种方法都有其特定的使用场景和目的，旨在提高代码的复用性和组织性。在实际开发过程中，可以根据具体需求灵活设计和选择合适的公共类。