# 创建插件组件

## 概述

Webclient-Vue-Cesium 是针对原始的 cesium 脚本的封装。很多额外的高效的插件也是项目开发中常常使用的。因此为了将常用的 cesium 的插件也通过 Vue 的方式使用，下面将介绍如何创建插件组件。

一个插件组件本质上还是通过 Vue 组件的方式，核心思想是通过获取 根组件`mapgis-web-scene`中的 `Cesium` 和 `CesiumZondy` 以及 `webGlobe` 对象来进行对应的拓展功能。

Webclient-Vue-Mapboxgl 内部使用独立的 VUE 注入机制[provide/inject](https://vuejs.org/v2/api/#provide-inject)。

当`mapgis-web-scene`组件创建的时候，必须等到地图初始化加载完毕后，然后才会渲染子组件 同时通过 provide 的方式提供下面三个组件:

::: tip

1. `Cesium` @mapgis/cesium
2. `CesiumZondy` @mapgis/webclient-ceisum-plugin.js
3. `webGlobe` mapgis Cesium.WebGlobe 对象
   :::

只要是注入了上面的属性,你就可以添加地图要素或者执行对应的地图方法。 注入方法如下：

```js
inject: ["Cesium", "CesiumZondy", "webGlobe"],
```

封装插件的核心思想是： 保持 Vue 本身的声明规范，这样做可以容易封装额外的控制组件和图层组件.同时也容易封装第三方插件，适应不同的业务需求。

## 基本示例

**App 项目代码**

```vue
<template>
  <div class="custom-geojson-layer"></div>
</template>

<script>
export default {
  name: "mapgis-3d-custom-geojson-layer",
  inject: ["Cesium", "CesiumZondy", "webGlobe"],
  components: {},
  props: {
    // import VueOptions from '@components/Base/Vue/VueOptions'
    // ...VueOptions    // VueOptions就是下面的vueKey， vueIndex
    vueKey: { type: String, default: "default" },
    vueIndex: {
      type: String | Number,
      default: (Math.random() * 10000).toFixed(0)
    }
  },
  data() {
    return {};
  },
  created() {},
  mounted() {
    this.mount();
  },
  destroyed() {
    this.unmount();
  },
  methods: {
    createCesiumObject() {
      const { url, options } = this;
      return new Cesium.GeoJsonDataSource.load(url);
    },
    mount() {
      const { CesiumZondy, webGlobe, options, type, vueKey, vueIndex } = this;
      const { viewer } = webGlobe;
      const { dataSources } = viewer;
      const vm = this;
      let datasource = this.createCesiumObject();
      // datasource这里绝对不能放到vue.data上
      // this.$_datasource = datasource; $_前缀也不行，还是会触发更新机制

      datasource.then(function(dataSource) {
        // viewer.zoomTo(dataSource);
        dataSources.add(dataSource).then(() => {
          let entities = dataSource.entities.values;
          // 可以认为是一个范式，在 @components/WebGlobe/manager.js中新增/使用对应的XXXManager对象
          // Cesium管理中心添加对应的记录，这段代码可以认为是对应的vue的mounted的生命周期中的初始化data属性
          CesiumZondy.GeojsonManager.addSource(
            vueKey,
            vueIndex,
            dataSource,
            {}
          );
          this.$emit("load", vm);
        });
      });
    },
    unmount() {
      let { CesiumZondy, webGlobe, vueKey, vueIndex } = this;
      const { viewer } = webGlobe;
      const { dataSources, scene } = viewer;

      // 这段代码可以认为是对应的vue的获取data属性
      let find = CesiumZondy.GeojsonManager.findSource(vueKey, vueIndex);
      if (find) {
        if (dataSources) {
          dataSources.remove(find.source, true);
        }
      }
      // 这段代码可以认为是对应的vue的获取destroyed生命周期
      CesiumZondy.GeojsonManager.deleteSource(vueKey, vueIndex);
      this.$emit("unload", this);
    }
  }
};
</script>
```

```javascript
  window.CesiumZondy.GeojsonManager = window.CesiumZondy.GeojsonManager || new GeojsonManager();
  export class GeojsonManager extends BaseManager {}
    constructor(vueKey) {
    this.default = [];
    this.vueKey = vueKey || "default";
  }

  // 添加数据
  addSource(vueKey, vueIndex, source, options) {
    vueKey = vueKey ? vueKey : this.vueKey;
    vueIndex = vueIndex ? vueIndex : this.vueIndex;
    vueIndex = `${vueIndex}`;
    if (!this[vueKey]) {
      this[vueKey] = [];
    }
    this[vueKey].push({
      key: vueIndex,
      source: source,
      options: options,
    });
  }

  // 删除数据
  deleteSource(vueKey, vueIndex) {
    let index = -1;
    vueIndex = `${vueIndex}`;
    this[vueKey].find((s, i) => {
      let result = false;
      if (s && s.key === vueIndex) {
        index = i;
        result = true;
      }
      return result;
    });
    if (index >= 0) {
      this[vueKey].splice(index, 1);
    }
  }

  // 获取指定vue组件数据
  findSource(vueKey, vueIndex) {
    vueKey = vueKey ? vueKey : this.vueKey;
    vueIndex = vueIndex ? vueIndex : this.vueIndex;
    vueIndex = `${vueIndex}`;
    let index = -1;
    let findSource = undefined;
    if (!this[vueKey]) return findSource;

    let find = this[vueKey].find((s, i) => {
      let result = false;
      if (s && s.key === vueIndex) {
        index = i;
        result = true;
      }
      return result;
    });
    if (find) {
      findSource = {
        ...find,
        index: index,
      };
    }
    return findSource;
  }

  // 获取全部vue组件数据
  findAllSource(vueKey) {
    vueKey = vueKey ? vueKey : this.vueKey;
    return this[vueKey];
  }
}
```

::: warning
可能看完上面的源码分析，可能会存在一个疑问，为什么不采取 vue 的 data 属性来控制 Cesium 的图层对象，而是实现了一个 CesiumZondy.XXXXManager 来实现对应的生命周期管理。本质原因在于：

1. Cesium 的对象只能通过自身或者全局 window 来管理，一旦被 vue 框架管理，很容易出现 Cesuim 对象被 vue 自身的更新机制`反复强制更新`，这点在多屏联动以及 WebGL 渲染的时候尤其明显。
2. Vue 的内存占用其实很低，绝大部分的内存、CPU、GPU 资源都是被 Cesium 本身占据，Cesium 本身有自身的内存管理方式，因此不能将`Cesium的生命周期让Vue框架来托管`
3. 直接表现就是不类似这么处理，封装的 Cesium 组件在加载使用后会变得`异常卡顿`
   :::

**一言以蔽之：**

::: tip

> Vue 组件`创建`的时候，vue 组件`mounted`的时候通过

```js
let datasource = `this.createCesiumObject()`; // 创建Cesium本身对象
```

```js
// 可以认为是一个范式，在 @components/WebGlobe/manager.js中新增/使用对应的XXXManager对象
// 这段代码可以认为是对应的vue的mounted的生命周期
CesiumZondy.GeojsonManager.addSource(vueKey, vueIndex, `dataSource`, {});
```

:::

::: tip

> Vue 组件使用`data`属性的时候，vue 组件获取`data`的时候通过下面的代码来类比 this.data

```js
let find = CesiumZondy.GeojsonManager.findSource(vueKey, vueIndex);
let value = find.source; // 获取mounted的时候记录的真实的Cesium对象`dataSource`
```

:::

::: tip

> Vue 组件`释放`的时候，vue 组件获取 data 的 cesium 对象进行对应的释放

```js
// 类比data属性，获取对应的资源
let find = CesiumZondy.GeojsonManager.findSource(vueKey, vueIndex);
```

```js
// 真正释放大量占用内存、GPU、CPU资源的地方
dataSources.remove(find.source, true);
```

```js
// Cesium管理中心删除对应的记录
// 释放真正占内存的cesium对象
CesiumZondy.GeojsonManager.deleteSource(vueKey, vueIndex);
```

:::

::: danger
上面的核心思想就一句话，通过 XXXManager 来`托管类比`实现 Vue 的创建、使用、销毁的生命周期,一定要实际实战一下才能体会到这样设计的原因
:::
