「标准」Ux.toArray

将数据转换成标准的JavaScript数组：

1. 如果是Array则直接返回副本。
2. 如果是Set类型则将Set转换成Array的副本。
3. 如果是非集合类型的数据，则直接加入[]符号来生成新数组。

「引擎」Ux.toAssist

辅助数据专用函数

「标准」Ux.toCss

执行CSS前缀的注入流程，根据环境变量中配置的Z_CSS_PREFIX来追加CSS类名的前缀。

「标准」Ux.toFileSize

读取文件大小专用方法，解析成合适方法

「引擎」Ux.toForm

将两个form的配置进行合并的专用操作，主要合并项：

1. ui：两个表单直接连接。
2. hidden：两个表单的隐藏字段连接。
3. initial：初始值二者合并。
4. mapping：映射值二者合并。

「引擎」Ux.toGrid

生成 Grid 布局的宽度运算，表单中专用，1、2、3、4列不同布局处理。

{
    grid: "数值，不同数值对应不同宽度"
}

「引擎」Ux.toGridSpan

根据列计算 span / offset 等相关信息，针对布局执行核心操作。

「标准」Ux.toHeight

根据修正宽度计算组件最大高度信息，按分辨率智能切换。

「标准」Ux.toHeightState

高度修正专用的状态生成器：

{
    $heightStyle: {
         style: {
             maxHeight
         }
    },
    $heightValue: number
}

「标准」Ux.toJson

内部直接调用JSON.parse解析，将字符串转换成对象，如果转换出错则直接返回null值。

「标准」Ux.toKey

生成 Assist / Tabular 专用键值数据。

「引擎」Ux.toLimit

功能和 valueLimit相同，同样的执行操作，用于不同的场景。

• valueLimit 属于标准函数。
• toLimit 在自定义组件中调用。

「标准」Ux.toLink

1. 如果 data 是 Object，则针对 data 中的任何一个对象的 uri 执行路由转换。
2. 如果 data 是 Array，则针对 data 中的任何一个元素对象执行 uri 转换。
3. 如果 data 是 String，则直接执行转换。

「标准」Ux.toLoading

加载效果界面专用的延迟执行方法，主要用于 ajax 和界面效果联通。

「引擎」Ux.toLogout

登录注销专用函数，配合当前系统中的信息实现用户注销功能。

「标准」Ux.toMessage

消息配置转换函数

1. error = true：最终调用 message.error 处理。
2. error = false：最终调用 message.success 处理。

「引擎」Ux.toOriginal

带原始参数target的核心路由跳转功能，新参数中不包含key, id, target，可以和 toRoute 配合使用。

• target：该值为原始的路由路径，如果有值则直接跳转，用于登录控制过后返回原始页面专用。

「引擎」Ux.toPagination

data的数据结构

{
    "list": [],
    "count":10
}

查询条件类

{
    "pager":{
        "page": 1,
        "size": 10
    },
    "criteria": {

    },
    "sorter":[],
    "projection":[]
}

「引擎」Ux.toPassword

直接重定向到密码更改页，带参数控制 limitation=true

「引擎」Ux.toPid

根据 pid 的值计算 defaultOpenKeys 和 defaultSelectedKeys 值。

「标准」Ux.toProtocol

将一个合法协议地址解析成对象

• 协议格式如<protocol>://<username>:<password>@<hostname>:<port>/<path>
• 账号部分为<username>:<password>，是可选的。
• 端口部分可没有<hostname>:<port>和<hostname>两种格式都是合法的。

最终解析的结果如：

{
    "protocol": "协议类型",
    "username": "账号",
    "password": "密码",
    "hostname": "主机域名或IP",
    "port": "端口",
    "path": "路径地址"
}

系统会自动计算参数中的 key = value 相关信息

「标准」Ux.toQuery

直接读取查询路径中的查询参数，如：/uri?name=value&name1=value1。

import Ux from 'ux';

const value = Ux.toQuery("name");
const value1 = Ux.toQuery("name1");
// value 的值是 "value";
// value1 的值是 "value1";

特殊点需要说明：特殊参数 target 会在读取过程中进行判断：

1. 如果 target = x 的 x 中包含了 '/'，则表示当前的target不需要执行Base64的decoding操作。
2. 在 '/' 之外，target参数会被Base64算法执行解码操作，还原原始的链接信息。

「引擎」Ux.toRoute

执行 react-router 的路由跳转功能，路由地址中可以包含前缀，也可以不包含前缀，但框架内部会存在内部逻辑。

1. 特殊参数

1）mid为特殊参数，表示模块信息，对应动态中的module（app, module, page） 2）pid为特殊参数，表示页面信息，对应动态中的page（app, module, page） 3）target为Base64处理过的目标变量，它表示当前页面如果调用toRoute失败时会直接执行target页面

2. 参数读取流程

1. 如果params中传入了mid, pid，那么优先考虑params中的值：
   1. 如果是二参调用，则追加mid / pid参数到目标页面中（标准菜单处理办法）
   2. 如果是三参调用，只提供mid，则表示模块页面路由
   3. 如果是三参调用，提供了mid和pid，则表示直接引导到模块中的某个页面
2. 如果params中传入了target，则追加target参数并执行Base64编码，如果没传该参数则直接忽略
3. 其他参数直接忽略掉，不执行传入，除非在params中传入新参数。

3. 路径解析流程

1. 先处理基础路径
   1. 如果基础路径中包含了参数如：uri?p1=v1&p2=v2，则追加参数时&为前缀 --> baseUri
   2. 如果基础路径以Z_ROUTE为前缀，则不追加路由前缀，如果不以Z_ROUTE为前缀，则追加Z_ROUTE前缀，react-router专用
2. 参数对部分，主要考虑前缀信息，如果本身路径带了参数，则前缀使用&符号（追加参数模式），如果路径本身不带参数，则前缀使用?符号（设置参数模式）

「标准」Ux.toTime

设置 moment 对象中的固定时间信息（设置时、分、秒），根据 timeStr 进行日期格式解析。

「标准」Ux.toTree

整个树的每一个节点会包含 children 的叶节点信息，一个节点可能包含多个叶节点，顶层数组只包括顶层父类数组。

「标准」Ux.toTreeArray

构造树形数组，每个元素都是一个平行节点，核心结构：

{
    "data": {
        "...": "原始数据"
    },
    key: "树上的每个节点的主键字段",
    parent: "树上构造整个树的节点时的父节点字段",
    value: "树节点每个节点的值",
    text: "树节点每个节点显示文字",
    title: "树节点每个节点标题",
    sort: "树节点的排序字段",
    leaf: "当前树节点是否叶节点的检查字段",
    level: "当前节点的level字段，也可以直接计算",

    disabled: "是否禁用，提取属性",
    isLeaf: "提取叶节点属性",
    selectable: "是否可选中，提取属性",
    className: "风格Css 对应的类名",
    title: "标题",
    icon: "图标"
}

最终数据结构两层，用于很多地方的树处理，在构造树的过程中每个节点都会包含这些基础属性，而原始记录存在于data节点。

「标准」Ux.toTreeConfig

针对树形配置执行规范化处理，处理过后的数据结构如：

{
    key: "树上的每个节点的主键字段",
    parent: "树上构造整个树的节点时的父节点字段",
    value: "树节点每个节点的值",
    text: "树节点每个节点显示文字",
    title: "树节点每个节点标题",
    sort: "树节点的排序字段",
    leaf: "当前树节点是否叶节点的检查字段",
    level: "当前节点的level字段，也可以直接计算",
    root: "根节点从哪一级开始，默认从1",
}

「标准」Ux.toUrl

将key=value追加到url路径中，如

// url = /api/params?name=x
Ux.toUrl(url, "pass", "111")
// url = /api/params?name=x&pass=1111

系统会自动计算参数中的 key = value 相关信息

「标准」Ux.toWidth

如果是中文字符返回长度 2，如果是英文字符返回长度 1，可计算像素。

「引擎」Ux.toX

根据列信息自动计算表格宽度，计算值会包含多种不同的列值。