在AWTK串口屏中，內(nèi)置用戶(hù)管理和權(quán)限控制的模型，無(wú)需編碼即可實(shí)現(xiàn)登錄、登出、修改密碼、權(quán)限控制、創(chuàng)建用戶(hù)、刪除用戶(hù)等功能，本文介紹一下用戶(hù)管理和權(quán)限控制的基本用法。

用戶(hù)管理和權(quán)限控制是一個(gè)常用的功能。在工業(yè)軟件中，通常將用戶(hù)分為幾種不同的角色，每種角色有不同的權(quán)限，比如管理員、操作員和維護(hù)員等等。在 AWTK 串口屏中，內(nèi)置基本的用戶(hù)管理和權(quán)限控制功能，可以滿(mǎn)足常見(jiàn)的需求。開(kāi)發(fā)者不需要編寫(xiě)代碼，設(shè)計(jì)好用戶(hù)界面，通過(guò)數(shù)據(jù)和命令綁定規(guī)則，即可實(shí)現(xiàn)用戶(hù)和權(quán)限管理功能，比如登錄、登出、修改密碼、權(quán)限控制、創(chuàng)建用戶(hù)、刪除用戶(hù)等功能。
本文介紹一下 AWTK 串口屏中的用戶(hù)管理和權(quán)限控制功能。

1. 出廠(chǎng)默認(rèn)用戶(hù)

在下面的數(shù)據(jù)文件中，可以修改出廠(chǎng)默認(rèn)的用戶(hù)和密碼。密碼使用 sha256 加密，可以使用在線(xiàn)工具生成。https://emn178.github.io/online-tools/sha256.html

design/default/data/user_manager.csv

比如 demo 中的默認(rèn)用戶(hù)是：

admin|0|8c6976e5b5410415bde908bd4dee15dfb167a9c873fc4bb8a81f6f2ab448a918|管理員（默認(rèn)密碼：admin)

2. 數(shù)據(jù)文件格式

用 CSV 格式的文件存儲(chǔ)用戶(hù)名和密碼，每行一個(gè)用戶(hù)，每行的格式如下：

• 用戶(hù)名?？梢允褂弥形?。
• 角色。用來(lái)做實(shí)際的權(quán)限控制，怎么定義就怎么用。比如：0表示管理員，1 表操作員，2 表示維護(hù)員。
• 密碼。使用 sha256 加密。
• 備注?？梢允褂弥形?。

在后面的數(shù)據(jù)綁定中，name 表示用戶(hù)名，role 表示角色，password 表示密碼，memo 表示備注。

3. 用戶(hù)登錄

3.1 用戶(hù)登錄命令

當(dāng)啟用用戶(hù)管理時(shí)，默認(rèn)模型 (default) 會(huì)提供一個(gè) login 的命令。

login 命令依賴(lài)兩個(gè)屬性：

login_username 登錄的用戶(hù)名。

• login_password 登錄的密碼。

login 命令需要一個(gè)參數(shù)，用來(lái)指定登錄成功后跳轉(zhuǎn)的目標(biāo)頁(yè)面。

3.2 數(shù)據(jù)綁定

Mode=OneWayToModel 表示單向綁定，只能從控件到模型，主要是因?yàn)槟Ｐ屠锏拿艽a是加密后的哈希值，不能反向綁定到控件。

表示將控件輸入的數(shù)據(jù)使用 sha256 加密后，再賦值給模型。

3.3 命令綁定

3.4 demo 參考界面

4. 用戶(hù)登錄狀態(tài)

4.1 用戶(hù)登錄狀態(tài)

用戶(hù)登錄成功后，會(huì)在默認(rèn)模型 (default) 中提供兩個(gè)變量：

username 登錄的用戶(hù)名。

userrole 登錄的用戶(hù)角色。

userrole 是一個(gè)整數(shù)，可以通過(guò) userrole 來(lái)控制權(quán)限。

4.2 數(shù)據(jù)綁定

4.3 命令綁定

比如，只用管理員才能訪(fǎng)問(wèn)的頁(yè)面，可以通過(guò)下面的命令綁定來(lái)實(shí)現(xiàn)：

比如，只用管理員執(zhí)行某些命令，可以通過(guò)下面的命令綁定來(lái)實(shí)現(xiàn)：

4.4 demo 參考界面

管理員界面，全部功能可用。

工程師界面，部分功能可用。

5. 修改密碼

5.1 修改密碼命令

當(dāng)啟用用戶(hù)管理時(shí)，默認(rèn)模型 (default) 會(huì)提供一個(gè) change_password 的命令。change_password 命令依賴(lài)兩個(gè)屬性：

• change_password 修改的密碼。
• change_confirm_password 確認(rèn)修改的密碼。

change_password 命令不需要參數(shù)。

5.2 數(shù)據(jù)綁定

5.3 命令綁定

5.4 demo 參考界面

6. 用戶(hù)管理

前面的模型都是默認(rèn)模型 (default)，用戶(hù)管理模型是 user_manager。

6.1 用戶(hù)管理命令

當(dāng)啟用用戶(hù)管理時(shí)，用戶(hù)管理模型 (user_manager) 會(huì)提供一些命令。

add 添加用戶(hù)。

remove 刪除用戶(hù)。

edit 編輯用戶(hù)。

save 保存用戶(hù)。

reload 重新加載用戶(hù)。

set_selected 設(shè)置選中的用戶(hù)。

6.2 數(shù)據(jù)綁定

6.3 命令綁定

為了不讓用戶(hù)刪除管理員用戶(hù)，可以設(shè)置刪除按鈕的 enable 屬性。綁定規(guī)則如下：

6.4 demo 參考界面

7. 創(chuàng)建用戶(hù)

user_manager 模型提供了一個(gè) add 命令，用來(lái)創(chuàng)建用戶(hù)。如果支持創(chuàng)建用戶(hù)，需要提供一個(gè)創(chuàng)建用戶(hù)的界面，窗口的名字必須是 user_manager_add。

通過(guò) new 參數(shù)可以設(shè)置默認(rèn)數(shù)據(jù)。比如：

user_manager(new=' |1| | |');

7.1 模型

創(chuàng)建用戶(hù)的界面有自己的模型，代表當(dāng)前創(chuàng)建的用戶(hù)。

它具有下面的屬性：

name 表示 username 用戶(hù)名。

role 表示 role 角色。

password 表示 password 密碼。

memo 表示 memo 備注。

它還提供了一個(gè)確認(rèn)增加的命令。

add 命令。

7.2 數(shù)據(jù)綁定

7.3 命令綁定

7.4 demo 參考界面

8. 編輯用戶(hù)

user_manager 模型提供了一個(gè) edit 命令，用來(lái)編輯用戶(hù)。如果支持編輯用戶(hù)，需要提供一個(gè)編輯用戶(hù)的界面，窗口的名字必須是 user_manager_edit。

8.1 模型

編輯用戶(hù)的界面有自己的模型，代表當(dāng)前編輯的用戶(hù)。它具有下面的屬性：

• name 表示 username 用戶(hù)名。
• role 表示 role 角色。
• memo 表示 memo 備注。

不需要額外的命令。

8.2 數(shù)據(jù)綁定

8.3 命令綁定

UpdateModel=true 表示更新模型，CloseWindow=true 表示關(guān)閉窗口。

8.4 demo 參考界面

9. 注意

本項(xiàng)目并沒(méi)有編寫(xiě)界面相關(guān)的代碼，AWStudio 在 src/pages 目錄下生成了一些代碼框架，這些代碼并沒(méi)有用到，可以刪除也可以不用管它，但是不能加入編譯。

實(shí)際開(kāi)發(fā)時(shí)，可以參考 demo_user_manager 演示項(xiàng)目，在的它 UI 文件上修改。