Cocos 重载函数的实现

版本：2.4.4

目录：

一 重载函数

二 重载函数声明

三 函数参数重新赋值

四 整体代码
五 测试

 

一 重载函数

重载函数是功能相似的同名函数，具有以下特点：

1. 函数名相同

2. 参数个数不同

3. 参数类型不同或顺序不同

 

TypeScript并没有重载函数，如下定义同名函数会报错：

 

在TypeScript中实现重载函数，需要重载声明+参数重新赋值来实现函数重载功能。

 

二  重载函数声明

现在以加载类Loader来举例。

首先定义重载声明，重载声明只有声明，没有具体实现方法。

 

函数实现方法只能有一个。

 

三 函数参数重新赋值

load方法使用可如下：

 

第一个函数第2个参数是进度回调，第3个参数是完成回调

第二个函数第2个参数是完成回调，第3个参数是this

 

在TypeScript中函数同名方法就只能有1个，那么我们怎么判断第2个参数在上面2个使用案例中究竟是进度回调，还是完成回调？

这就需要根据参数数量和参数类型将参数重新赋值。

 

    public load(url: string, progress: Function, complete: Function, target: any): void;   //重载1
    public load(url: string, complete: Function, target: any): void;                                   //重载2
    public load(url: string): void;                                                                                       //重载3

 

 

第四个参数target为null时，表示不是重载1，只能是重载2或重载3。

第二个参数和第三个参数都不为null时，可以确定当前一定是重载2。

 

那么将实现方法 load(url，progress，complete，target) 的参数重新赋值。

重载2的第一个参数是url，和load方法一致，无需修改。

重载2的第二个参数是complete，将load的第二个参数progress赋值给complete。

重载2的第三个参数是target，将load的第三个参数complete赋值给target。

重载2的第四个参数是null，无需重新赋值。

 

    private parseParameters(url, progress, complete, target) {
        //不是重载1，则可能是重载2、重载3
        if (target == null) {
            //判断是否是重载2，如果是则重置参数
            if (complete != null && progress != null) {
                target = complete;
                complete = progress;
                progress = null;
            }
        }
        return { url: url, progress: progress, complete: complete, target: target };
    }

 

四 整体代码

ResManager.ts：

export default class ResManager extends cc.Component {

    //单例
    private static instance: ResManager;
    public static get ins(): ResManager {
        if (this.instance == null) {
            this.instance = new ResManager();
        }
        return this.instance;
    }

    //重载声明，重载的要求如下
    //1.参数数量不一致
    //2.若参数数量一致，则参数类型需要不一致
    public load(url: string, progress: Function, complete: Function, target: any): void;  //重载1
    public load(url: string, complete: Function, target: any): void;                      //重载2
    public load(url: string): void;                                                       //重载3
    /**
     * 加载
     * @param url        资源路径
     * @param progress   加载进度回调
     * @param complete   加载完成回调
     * @param target     回调执行对象
     */
    public load(url: string, progress?: Function, complete?: Function, target?: any) {
        let param = this.parseParameters(url, progress, complete, target);
        url = param.url;
        progress = param.progress;
        complete = param.complete;
        target = param.target;

        console.log("重置后的参数:", param);

        progress && progress.call(target, "进度99");
        complete && complete.call(target, "完成");
    }

    private parseParameters(url, progress, complete, target) {
        //不是重载1，则可能是重载2、重载3
        if (target == null) {
            //判断是否是重载2，如果是则重置参数
            if (complete != null && progress != null) {
                target = complete;
                complete = progress;
                progress = null;
            }
        }
        return { url: url, progress: progress, complete: complete, target: target };
    }
}

 

MainScene.ts：

export default class MainScene extends cc.Component {

    onLoad() {
        ResManager.ins.load("");
        ResManager.ins.load("", this.onComplete, this);
        ResManager.ins.load("", this.onProgress, this.onComplete, this);
    }

    private onProgress(data) {
        console.log("加载进度:", data);  //输出：加载进度：99
    }

    private onComplete(data) {
        console.log("加载完成:", data);  //输出：加载完成：完成
    }
}

　　

五 测试

运行上述项目，浏览器输出如下