MetadataType

CesiumJS中的元数据类型（MetadataType）是一种用于定义实体、时间序列数据和其他Cesium对象的元数据结构。这些结构可以用于描述各种地球物理数据，如天气、海洋、气候等等。

元数据类型的定义

元数据类型使用JavaScript类定义，它们可以通过创建实例、继承和扩展来创建。

import { MetadataType } from 'cesium';

class MyMetadataType extends MetadataType {
    constructor(description) {
        super(description);
        
        // 添加属性
        this.addProperty('myProperty', 'string');
        this.addProperty('myNumber', 'number');
    }
}

上面的代码定义了一个名为MyMetadataType的元数据类型，并给它添加了两个属性：myProperty和myNumber。这些属性可以支持字符串、数字和其他基本数据类型。

元数据类型的使用

使用MetadataType可以描述和扩展Cesium中的各种对象和实体，包括模型、几何体和时间序列数据等等。一个元数据类型实例可以与一个对象一起使用，以添加元数据属性。

import { MetadataType, Model } from 'cesium';

// 定义元数据类型
class MyMetadataType extends MetadataType {
    constructor(description) {
        super(description);
        
        // 添加属性
        this.addProperty('myProperty', 'string');
        this.addProperty('myNumber', 'number');
    }
}

// 创建一个模型
const myModel = new Model({...});

// 向模型添加元数据
const myMetadata = new MyMetadataType({});
myModel.metadata = myMetadata;
myModel.myProperty = 'Hello World';
myModel.myNumber = 42;

上面的代码定义了一个名为myModel的cesium模型，并通过MyMetadataType元数据类型为其附加了两个元数据属性myProperty和myNumber。

元数据类型扩展

元数据类型还支持通过继承和扩展来创建新类型，这些新类型可以添加和修改现有的属性和方法。

import { MetadataType } from 'cesium';

class MyExtension extends MetadataType {
    constructor(description) {
        super(description);
        // 添加属性
        this.addProperty('myString', 'string');
    }
}

// 扩展现有类型
const myMetadata = new MyMetadataType({});
const myExtension = new MyExtension({});
myMetadata.extend(myExtension);

上面的代码创建了一个MyExtension扩展类型，并将其添加到现有的MyMetadataType类型。这样可以为现有的元数据类型添加新的属性和方法。

API

MetadataType

定义一个基本的MetadataType类

constructor(description: object)

• description: object - 元数据类型的描述，包含以下属性
  • id: string - 元数据类型的ID
  • name: string - 元数据类型的名字
  • description: string - 元数据类型的描述

getDefaultValue(propertyName: string)

获取属性的默认值

• propertyName: string - 属性名称

getPropertyNames()

获取元数据类型的所有属性名称

addProperty(propertyName: string, propertyType: string, defaultValue?: any, options?: object)

添加一个元数据属性

• propertyName: string - 属性名称
• propertyType: string - 属性类型，支持以下类型
  • string
  • number
  • boolean
  • object
  • array
  • position
  • number|position
  • image
  • uri
• defaultValue: any - 属性的默认值。可选项，默认为null。
• options: object - 选项对象。可选项。包括以下属性
  • override: boolean - 是否覆盖现有的属性
  • definitionChanged: function - 属性定义修改时的回调函数

getProperty(propertyName: string)

获取元数据属性

• propertyName: string - 属性名称

hasProperty(propertyName: string)

检查元数据类型是否具有指定的属性

• propertyName: string - 属性名称

setProperty(propertyName: string, value: any)

设置元数据属性的值

• propertyName: string - 属性名称
• value: any - 属性的值

getPropertyType(propertyName: string)

获取属性的类型

• propertyName: string - 属性名称

extend(extension: MetadataType)

扩展元数据类型

• extension: MetadataType - 扩展元数据类型

参考

• CesiumJS MetadataType文档