2.9 对象基本操作

这一节我们学习JS API中对象的通用操作模式。

对于大部分对象来说，其生命周期一般具备创建、更新属性、获取结果、销毁这四种方式。

这里拿DistanceMeasure对象进行举例，来介绍这四种方式，同时，对开发者的开发流程进行开发引导示范。

创建对象

创建对象之前注意别忘了 CooSDK 前缀，关于对象所需参数，可查询API文档。

在搜索框搜索“DistanceMeasure”：

点进去后可以看到其初始化所需参数列表：

参数列表注明了各个属性的类型、默认值、描述，可以根据需要填写。 需要注意的是，如果某属性不带 optional 标识，则该属性必须进行赋值。

var measure = new CooSDK.DistanceMeasure({
    pointColor: new CooSDK.ColorObj(0.5, 0.5, 0.5, 1.0),
    lineWidth: 5
});

若使用默认配置，也可这么写：

var measure = new CooSDK.DistanceMeasure();

更新属性

这是update方法的参数列表：

有两种方式，当只修改单个属性的时候，可以这么写：

measure.lineWidth = 7;

当有多个属性待修改，推荐使用批量更新属性接口 update ：

measure.update({
    pointColor: new CooSDK.ColorObj(1, 0.5, 0.5, 0.5),
    lineWidth: 1,
    ......
});

获取结果

通常Analysis、Measure、Provider、Tool这些模块类具有该方法，主要是获取这些功能计算后的相关结果。

这是getResult方法的参数列表：

measure.getResult(CooSDK.EnumMeasureDistance.CLICKPOS);

可点击进EnumMeasureDistance，这里注明了枚举常量，按照自身所需来查询相关结果：

销毁

当对象不再使用，需要被销毁的时候，即可调用destroy接口。

measure = measure.destroy();

相信你现在已经学会JS API绝大部分对象的常规使用流程，也对如何使用API文档有了更深的理解，下面就可以按照业务需求开发实战吧！