Skip to content

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ClassRandom Project

一、简介

​ 这是一款使用 Java 语言编写,基于 Java.Swing 可视化开发的一款多场景适用的点名软件。

软件运行环境要求:Java 8

二、已经完成的功能

  • 基础点名
  • 名单管理
  • 设置不重复点同一个人
  • 只点男/女性
  • 可设置窗口置顶
  • 统计

三、技术文档及操作说明

三.1 、基础点名

​ 启动软件后,点击「抽」,屏幕将会显示滚动的姓名,表示正在抽取,再次点击「抽」,屏幕将会显示最终抽取的人。如需抽取其他人,只需要重复该操作即可。

三.2、名单管理

三.2.1、名单的初始化

​ 第一次进入软件时,名单将被默认初始化为一份高中班级的同学名单。

三.2.2、名单内单个成员的增加和删除

​ 点击软件主界面的「设置」按钮,进入软件设置界面,点击「查看名单」按钮,进入管理名单界面。管理名单界面将名单以表格形式进行展示,表头为「编号」「姓名」「性别」,这意味着在增添成员时,也需要对这三项进行设置。在名单表格的下方有两个输入框,分别对应输入「编号」「姓名」,以及一个选择框,需要选择「性别」,三项确认无误后点击该界面内的「增加」按钮,即可向当前名单内添加单个成员。删除成员时,需通过鼠标,在表格内选择需要删除的成员所在行,可按住Ctrl进行多选,选择完成后点击当前界面内的「删除」,即可删除所选成员。

注意:「编号」和「姓名」的输入均需符合名单输入规范(详见 三.2.6)。

三.2.3、批量导入成员

​ 除了单次添加一名成员,该软件还提供了单次批量添加成员。批量添加成员时,需要预先准备好等待添加的名单,等待添加的名单需为.txt格式,并且文件内每行为一名成员,成员的「编号」「姓名」「性别」依次用空格隔开。准备好名单后,点击软件管理名单界面的「导入」按钮,软件弹出文件选择框,在该框内选择准备好的名单文件,点击「打开」按钮,即可批量导入名单。

注意:「编号」和「姓名」的输入均需符合名单输入规范(详见 三.2.6)。

三.2.4、导出当前成员名单

​ 在软件的名单管理界面,点击「导出」按钮,软件弹出文件选择框,在该框内选择将要保存的路径,选择完成后,点击「打开」按钮,即可导出名单。导出的名单为.txt格式的,和导入名单规范一致的名单,在不同设备使用时,可在该设备导出当前名单,在另一设备直接导入该设备导出的名单即可。

三.2.5、名单的锁定与解锁

​ 在该软件实际使用过程中,我们发现经常有同学自行在一体机上修改名单,故添加了该功能。点击软件名单管理界面的「锁定/解锁」按钮,在未锁定时,软件弹窗显示「锁定成功」,此时软件的「增加」「删除」「导入」功能都将被限制使用;锁定时点击,软件弹出密码输入框,要求验证管理员密码,输入密码后点击「确认」按钮,密码正确即可解锁。管理员密码的修改需在源代码层面实现,具体实现方法为:将新密码使用sha1加密算法进行加密,并在PwdPanel.java19行,将变量名为passwordString变量修改为sha1加密后的新密码。修改密码后重新编译,即可得到被设置为新的管理员密码的软件。

三.2.6、名单输入规范

​ 名单输入时,「编号」需保证唯一性和合法性,即现有名单内不可存在重复的编号且编号需为数字(满足正则表达式:[0-9]+)。「姓名」不限长度,但过长的姓名会导致在抽取时超出界面边界而显示异常。「性别」只可为男或女。在单个录入成员时,软件会对输入内容进行自动校验,但在批量导入成员时,软件不会对输入内容进行规范性校验,所以用户使用批量导入前必须保证导入名单的规范性,否则可能造成未知的运行错误。批量导入的名单每行的末尾不可有空格,中间不可有空行,文件末尾也不可有空行。「编号」「姓名」「性别」之间的空格只可有一个。具体导入名单的示例可在首次运行软件时导出名单查看。

三.3、设置不重复点同一个人

​ 进入软件设置页面后,勾选「不重复点同一个人」即可实现不重复点同一个人,欲清除已经被点过的人的名单,可以点击软件设置页面的「重置已经被抽取的人」按钮或重启软件。

三.4、只点男/女性

​ 进入软件设置页面后,勾选「只点男性」或「只点女性」,可实现只点男/女性成员,男/女性成员的判断依据为输入的名单包含的性别。两个复选框只可勾选其一,取消勾选任一,可恢复点所有成员。

三.5、设置窗口置顶

​ 进入软件设置页面后,勾选「使窗口一直处于顶层」,即可使程序主窗口一直处于顶层。取消勾选后恢复正常。

三.6、统计

​ 点击软件「统计」按钮,程序会显示当前统计内容,显示自统计日起,被点名次数最多的姓名。

四、保留权利及声明

​ 该项目遵守 GPL-3.0 协议开源。

​ 软件当前版本:v2.0.0.20210403

​ 作者:鲍一方(Zt)

​ 作者个人网站:https://www.zhen-t.com/

​ 项目开源地址:https://github.com/git-zt/ClassRandom

About

ClassRandom Project

Resources

Stars

4 stars

Watchers

1 watching

Forks

Contributors

Languages