[fix]文档注释修改 src：common remain review by jinny

Author: Wenxinyu1998

src/common/iServer/WebPrintingJobScaleBarOptions.js

@@ -10,7 +10,7 @@ import { Util } from '../commontypes/Util';
  * @category iServer WebPrintingJob
  * @version 10.1.0
  * @param {Object} option - 参数。
- * @param {string} [option.scaleText] - 比例尺文本信息。例如：1:1000000
+ * @param {string} [option.scaleText] - 比例尺文本信息。例如：1:1000000。
  * @param {WebScaleOrientationType} [option.orientation] - 比例尺的方位样式。
  * @param {WebScaleType} [option.type] - 比例尺的样式。
  * @param {number} [option.intervals] - 比例尺条的段数。

src/common/overlay/Graph.js

@@ -74,7 +74,7 @@ export class Graph extends Theme {
          * @readonly
          * @member {Array.<number>} FeatureThemeGraph.prototype.chartBox
          * @description 专题要素（图表）区域，即图表框，长度为 4 的一维数组，数组的 4 个元素依次表示图表框左端 x 坐标值、
-         *              下端 y坐标值、 右端 x坐标值、 上端 y 坐标值；[left, bottom, right, top]。
+         *              下端 y坐标值、右端 x坐标值、上端 y 坐标值；[left, bottom, right, top]。
          */
         this.chartBox = null;
 

src/common/overlay/ThemeVector.js

@@ -34,7 +34,7 @@ import {LonLat} from '../commontypes/LonLat';
  * @param {SuperMap.Layer} layer - 此专题要素所在图层。
  * @param {Object} style - 样式。
  * @param {Object} options - 创建专题要素时的可选参数。
- * @param {number} [options.nodesClipPixel=2] - 节点抽稀像素距离, 单位：像素。
+ * @param {number} [options.nodesClipPixel=2] - 节点抽稀像素距离，单位：像素。
  * @param {boolean} [options.isHoverAble=true] - 图形是否可 hover。
  * @param {boolean} [options.isMultiHover=true] - 是否使用多图形高亮，isHoverAble 为 true 时生效。
  * @param {boolean} [options.isClickAble=true] - 图形是否可点击。

src/common/overlay/feature/ShapeFactory.js

@@ -762,7 +762,7 @@ export class ShapeFactory {
      * // styleByCodomain 的每个元素是个包含值域信息和与值域对应样式信息的对象，该对象（必须）有三个属性：
      * // start: 值域值下限（包含）;
      * // end: 值域值上限（不包含）;
-     * // style: 数据可视化图形的 style，其可设属性根据图形类型参考 <ShapeParameters> 子类对象的 style 属性。。
+     * // style: 数据可视化图形的 style，其可设属性根据图形类型参考 <ShapeParameters> 子类对象的 style 属性。
      * // dataStyleByCodomain 数组形如：
      * [
      *   {

src/common/overlay/feature/ShapeParameters.js

@@ -18,7 +18,7 @@ export class ShapeParameters {
          * refOriginalPosition 表示图形的参考中心，通常情况下，图形是使用 canvas 的原点位置作为位置参考，
          * 但 refOriginalPosition 可以改变图形的参考位置，例如： refOriginalPosition = [80, 80],
          * 图形圆的 style.x = 20, style.y = 20，那么圆在 canvas 中的实际位置是 [100, 100]。
-         * 图形（Shape） 的所有位置相关属性都是以 refOriginalPosition 为参考中心，
+         * 图形（Shape）的所有位置相关属性都是以 refOriginalPosition 为参考中心，
          * 也就是说图形的所有位置信息在 canvas 中都是以 refOriginalPosition 为参考的相对位置，只有
          * refOriginalPosition 的值为 [0, 0] 时，图形的位置信息才是 canvas 绝对位置。
          * 图形的位置信息通常有：style.pointList，style.x，style.y。
@@ -27,7 +27,7 @@ export class ShapeParameters {
 
         /**
          * @member {string} ShapeParameters.prototype.refDataID
-         * @description 图形所关联数据的 ID（<{@link FeatureVector}> 的 id）。
+         * @description 图形所关联数据的 ID（<{@link FeatureVector}> 的 ID）。
          */
         this.refDataID = null;
 

src/common/overlay/levelRenderer/Storage.js

@@ -159,7 +159,7 @@ export class Storage {
      * @function LevelRenderer.Storage.prototype.getShapeList
      * @description 返回所有图形的绘制队列。
      *
-     * @param {boolean} [update=false] - 是否在返回前更新该数组。  详见：<LevelRenderer.Shape> updateShapeList。
+     * @param {boolean} [update=false] - 是否在返回前更新该数组。详见：<LevelRenderer.Shape> updateShapeList。
      * @return {LevelRenderer.Shape} 图形。
      */
     getShapeList(update) {
@@ -358,7 +358,7 @@ export class Storage {
      * @function LevelRenderer.Storage.prototype.delRoot
      * @description 删除指定的图形(Shape)或者组(Group)。
      *
-     * @param {Array.<string>} elId - 删除图形(Shape)或者组(Group)的 id 数组。如果为空清空整个Storage。
+     * @param {Array.<string>} elId - 删除图形(Shape)或者组(Group)的 ID 数组。如果为空清空整个Storage。
      *
      */
     delRoot(elId) {

src/common/overlay/levelRenderer/Transformable.js

@@ -13,19 +13,19 @@ export class Transformable {
     constructor() {
         /**
          * @member {Array.<number>} LevelRenderer.Transformable.prototype.position
-         * @description 平移， 默认值：[0, 0]。
+         * @description 平移，默认值：[0, 0]。
          */
         this.position = [0, 0];
 
         /**
          * @member {Array.<number>} LevelRenderer.Transformable.prototype.rotation
-         * @description 旋转，可以通过数组二三项指定旋转的原点， 默认值：[0, 0, 0]。
+         * @description 旋转，可以通过数组二三项指定旋转的原点，默认值：[0, 0, 0]。
          */
         this.rotation = [0, 0, 0];
 
         /**
          * @member {Array.<number>} LevelRenderer.Transformable.prototype.scale
-         * @description 缩放，可以通过数组三四项指定缩放的原点， 默认值：[1, 1, 0, 0]。
+         * @description 缩放，可以通过数组三四项指定缩放的原点，默认值：[1, 1, 0, 0]。
          */
         this.scale = [1, 1, 0, 0];
 
@@ -113,7 +113,7 @@ export class Transformable {
 
     /**
      * @function LevelRenderer.Transformable.prototype.updateTransform
-     * @description 判断是否需要有坐标变换，更新 needTransform 属性。如果有坐标变换, 则从 position, rotation, scale 以及父节点的 transform 计算出自身的 transform 矩阵
+     * @description 判断是否需要有坐标变换，更新 needTransform 属性。如果有坐标变换，则从 position, rotation, scale 以及父节点的 transform 计算出自身的 transform 矩阵。
      */
     updateTransform() {
         this.updateNeedTransform();

src/common/security/SecurityManager.js

@@ -13,7 +13,7 @@ import { Credential } from '../commontypes/Credential';
  *  > 使用说明：
  *  > 创建任何一个服务之前调用 {@link SecurityManager.registerToken}或
  *  > {@link SecurityManager.registerKey}注册凭据。
- *  > 发送请求时根据 url 或者服务 id 获取相应的 key 或者 token 并自动添加到服务地址中。
+ *  > 发送请求时根据 URL 或者服务 ID 获取相应的 key 或者 token 并自动添加到服务地址中。
  * @usage
  */
 export class SecurityManager {
@@ -57,7 +57,7 @@ export class SecurityManager {
      * @description 服务请求都会自动带上这个 token。
      * @function SecurityManager.registerToken
      * @param {string} url -服务器域名+端口：如http://localhost:8090。
-     * @param {string} token - token
+     * @param {string} token - token。
      */
     static registerToken(url, token) {
         this.tokens = this.tokens || {};
@@ -71,8 +71,8 @@ export class SecurityManager {
     /**
      * @description 注册 key,ids 为数组(存在一个 key 对应多个服务)。
      * @function SecurityManager.registerKey
-     * @param {Array} ids - 可以是服务 id 数组或者 url 地址数组或者 webAPI 类型数组。
-     * @param {string} key - key
+     * @param {Array} ids - 可以是服务 ID 数组或者 URL 地址数组或者 webAPI 类型数组。
+     * @param {string} key - key。
      */
     static registerKey(ids, key) {
         this.keys = this.keys || {};
@@ -99,10 +99,10 @@ export class SecurityManager {
     }
 
     /**
-     * @description 根据 Url 获取token。
+     * @description 根据 URL 获取token。
      * @function SecurityManager.getToken
      * @param {string} url - 服务器域名+端口，如：http://localhost:8092。
-     * @returns {string} token
+     * @returns {string} token。
      */
     static getToken(url) {
         if (!url) {
@@ -114,10 +114,10 @@ export class SecurityManager {
     }
 
     /**
-     * @description 根据 Url 获取 key。
+     * @description 根据 URL 获取 key。
      * @function SecurityManager.getKey
-     * @param {string} id - id
-     * @returns {string} key
+     * @param {string} id - ID。
+     * @returns {string} key。
      */
     static getKey(id) {
         this.keys = this.keys || {};
@@ -189,7 +189,7 @@ export class SecurityManager {
     /**
      * @description iPortal登录验证。
      * @function SecurityManager.loginiPortal
-     * @param {string} url - iportal 首页地址,如：http://localhost:8092/iportal.
+     * @param {string} url - iportal 首页地址,如：http://localhost:8092/iportal。
      * @param {string} username - 用户名。
      * @param {string} password - 密码。
      * @returns {Promise} 包含 iPortal 登录请求结果的 Promise 对象。
@@ -215,7 +215,7 @@ export class SecurityManager {
     /**
      * @description iPortal 登出。
      * @function SecurityManager.logoutiPortal
-     * @param {string} url - iportal 首页地址,如：http://localhost:8092/iportal.
+     * @param {string} url - iportal 首页地址，如：http://localhost:8092/iportal。
      * @returns {Promise} 如果登出成功，返回 true;否则返回 false。
      */
     static logoutiPortal(url) {
@@ -288,7 +288,7 @@ export class SecurityManager {
     /**
      * @description 清空令牌信息。
      * @function SecurityManager.destroyToken
-     * @param {string} url - iportal 首页地址,如：http://localhost:8092/iportal.
+     * @param {string} url - iportal 首页地址，如：http://localhost:8092/iportal。
      */
     static destroyToken(url) {
         if (!url) {
@@ -321,8 +321,8 @@ export class SecurityManager {
      * @description 服务URL追加授权信息，授权信息需先通过SecurityManager.registerKey或SecurityManager.registerToken注册。
      * @version 10.1.2
      * @function SecurityManager.appendCredential
-     * @param {string} url - 服务URL
-     * @returns {string} 绑定了token或者key的服务URL
+     * @param {string} url - 服务URL。
+     * @returns {string} 绑定了token或者key的服务URL。
      */
     static appendCredential(url) {
         var newUrl = url;

src/common/security/ServerInfo.js

@@ -7,38 +7,38 @@ import {ServerType} from '../REST';
 /**
  * @class ServerInfo
  * @deprecatedclass SuperMap.ServerInfo
- * @classdesc 服务器信息(安全相关)，包含服务器类型，服务地址，token服务地址等
+ * @classdesc 服务器信息(安全相关)，包含服务器类型，服务地址，token服务地址等。
  * @category Security
- * @param {string} type - 服务器类型
+ * @param {string} type - 服务器类型。
  * @param {Object} options - 参数。
- * @param {string} options.server - 服务器地址,如：http://supermapiserver:8090/iserver
- * @param {string} [options.tokenServiceUrl] - 如：http://supermapiserver:8090/iserver/services/security/tokens.json
- * @param {string} [options.keyServiceUrl] - 如：http://supermapiserver:8092/web/mycontent/keys/register.json
+ * @param {string} options.server - 服务器地址，如：http://supermapiserver:8090/iserver。
+ * @param {string} [options.tokenServiceUrl] - 如：http://supermapiserver:8090/iserver/services/security/tokens.json。
+ * @param {string} [options.keyServiceUrl] - 如：http://supermapiserver:8092/web/mycontent/keys/register.json。
  * @usage
  */
 export class ServerInfo {
     constructor(type, options) {
         /**
          * @member {ServerType} ServerInfo.prototype.type
-         * @description 服务器类型
+         * @description 服务器类型。
          */
         this.type = type;
 
         /**
          * @member {string} ServerInfo.prototype.server
-         * @description 服务器地址
+         * @description 服务器地址。
          */
         this.server = null;
 
         /**
          * @member {string} [ServerInfo.prototype.tokenServiceUrl]
-         * @description 如：http://supermapiserver:8090/iserver/services/security/tokens.json
+         * @description 如：http://supermapiserver:8090/iserver/services/security/tokens.json。
          */
         this.tokenServiceUrl = null;
 
         /**
          * @member {string} [ServerInfo.prototype.keyServiceUrl]
-         * @description 如：http://supermapiserver:8092/web/mycontent/keys/register.json
+         * @description 如：http://supermapiserver:8092/web/mycontent/keys/register.json。
          */
         this.keyServiceUrl = null;
 

src/common/security/TokenServiceParameter.js

@@ -15,7 +15,7 @@ import {ClientType} from '../REST';
  * @param {ClientType} [options.clientType='ClientType.NONE'] - token 申请的客户端标识类型。
  * @param {string} [options.ip] - clientType=IP 时，此为必选参数。
  * @param {string} [options.referer] -clientType=Referer 时，此为必选参数。如果按照指定 URL 的方式申请令牌，则设置相应的 URL。
- * @param {number} [options.expiration=60] - 申请令牌的有效期,从发布令牌的时间开始计算,单位为分钟。
+ * @param {number} [options.expiration=60] - 申请令牌的有效期，从发布令牌的时间开始计算，单位为分钟。
  * @usage
  *
  */
@@ -64,8 +64,8 @@ export class TokenServiceParameter {
 
     /**
      * @function TokenServiceParameter.prototype.toJSON
-     * @description 将所有信息转成 JSON 字符串
-     * @returns {string} 参数的 JSON 字符串
+     * @description 将所有信息转成 JSON 字符串。
+     * @returns {string} 参数的 JSON 字符串。
      */
     toJSON() {
         return {