重构第六章:重构API

发布时间:2023年12月19日

在这一章中作者像我们交代了对外部API(Application Programming Interface)的重构,旨在确保代码对外部的依赖关系和接口设计既清晰又简洁,笔记如下:

以函数对象取代函数(Replace Function with Function Pointer):

问题: 在API中传递函数时,直接使用函数指针(或函数对象)。

解决方法: 将函数封装成对象,通常是实现了特定接口的类,然后传递对象而非直接传递函数。
// Before
void processFunction(void (*func)(int)) {
    // Function logic here
}

// After
void processFunction(FunctionObject funcObject) {
    // Function logic using funcObject
}

以命令取代函数(Replace Function with Command):

问题: 在API中传递的函数逻辑过于简单,难以方便地进行扩展。

解决方法: 将函数封装成一个命令对象,以更灵活地扩展和组合不同的逻辑。

// Before
void processFunction(Function func) {
    // Function logic here
}

// After
void processCommand(Command command) {
    command.execute();
}

以函数取代命令(Replace Command with Function):

问题: 使用命令对象的开销较大,逻辑相对简单。

解决方法: 将命令对象替换为函数,以简化代码结构。

// Before
class Command {
    void execute() {
        // Command logic here
    }
}

// After
void processFunction(Function func) {
    // Function logic here
}

以明确的函数取代参数方法(Replace Parameter with Explicit Methods):

问题: 使用一个参数控制函数的行为,而这个参数可能有多个取值。

解决方法: 将带有参数的函数替换为多个明确的函数,每个函数对应一个可能的参数值。

// Before
void process(int type) {
    // Process based on type
}

// After
void processTypeA() {
    // Process for type A
}

void processTypeB() {
    // Process for type B
}

以工厂函数取代构造函数(Replace Constructor with Factory Method):

问题: 直接使用构造函数创建对象,但可能需要更多的灵活性。

解决方法: 使用工厂函数创建对象,允许在创建时进行更多的逻辑操作。

// Before
class Product {
    Product(int param) {
        // Constructor logic
    }
}

// After
class ProductFactory {
    static Product createProduct(int param) {
        // Factory logic
        return new Product(param);
    }
}

封装向下转型(Encapsulate Downcast):

问题: 在API中存在向下转型,使得代码依赖于具体的实现类。

解决方法: 将向下转型的操作封装在一个函数中,使得API不再直接依赖于具体的实现。

// Before
void process(Object obj) {
    ConcreteClass concreteObj = (ConcreteClass) obj;
    // Process using concreteObj
}

// After
void process(Object obj) {
    if (obj instanceof ConcreteClass) {
        processConcrete((ConcreteClass) obj);
    }
}

void processConcrete(ConcreteClass concreteObj) {
    // Process using concreteObj
}

以异常取代错误码(Replace Error Code with Exception):

问题: API返回错误码,调用者需要检查错误码并做出相应处理。

解决方法: 使用异常替代错误码,使得调用者可以更自然地处理异常情况。

// Before
int process() {
    // Process logic
    if (errorCondition) {
        return ERROR_CODE;
    }
    return SUCCESS_CODE;
}

// After
void process() throws CustomException {
    // Process logic
    if (errorCondition) {
        throw new CustomException("Error description");
    }
}

以断言取代错误码(Replace Error Code with Assertion):

问题: 在API中使用错误码来处理不应该发生的情况。

解决方法: 使用断言来标识代码中不应该出现的条件,当条件失败时抛出异常。

// Before
int process() {
    // Process logic
    if (errorCondition) {
        assert false : "Unexpected error condition";
    }
    return SUCCESS_CODE;
}

// After
void process() {
    // Process logic
    assert !errorCondition : "Unexpected error condition";
}

引入Null对象(Introduce Null Object):

问题: 在API返回null,调用者需要处理null情况。

解决方法: 引入一个特殊的Null对象,代表缺失的对象,避免返回null。

// Before
Result getResult() {
    if (condition) {
        return new Result();
    }
    return null;
}

// After
Result getResult() {
    if (condition) {
        return new Result();
    }
    return new NullResult();
}

以对象取代数据值(Replace Data Value with Object):

问题: API传递的参数是一组原始数据。

解决方法: 将这组原始数据封装成一个对象,提高参数的表达力和可读性。

 // Before
    void processData(String name, int age, String address) {
        // Process logic using name, age, and address
    }

    // After
    class Person {
        String name;
        int age;
        String address;
    }

    void processData(Person person) {
        // Process logic using person object
    }

通过这些具体的示例代码,我们更清晰地展示了每种重构方法的实际应用场景和代码转换过程。这有助于读者更好地理解如何优化与外部API的交互,提升代码的质量和可维护性。

文章来源:https://blog.csdn.net/qq_44444470/article/details/134809849
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。