jlu-drcom-java
吉林大学校园网登录客户端 Java 版(第三方)
下载
项目来源
周一(2017-01-9)回到学校发现原来的旧版客户端已经不能使用了,但是新版客户端总是会检测我是否共享了 WiFi 导致根本无法使用网络(共享给自己的Windows10/Android/iOS 手机使用,一个账户登录不了这么多),
然后想到了 GayHub 上有 Python 版,C 语言版的客户端,(早就下载过的,因为在 Linux 下很方便),但是发现一个问题,Python 版在 Windows 下我不知道咋让他在后台运行2333. 得一直保持DOS 窗口打开,而 C 语言版由于引用的头文件在 Windows 下不兼容编译不了(虽然可以改成引用 Win32 库,但是嫌麻烦)
于是一气之下打算自己用Java 写一个 GUI 版本的客户端,因此就有了项目。
使用前提
如果您没有 Java 环境
请您到 http://java.com 下载最新版 Java. (Java8 )
相信我,这花不了几分钟.
如果您已有 Java 环境
通常安装 Java 后即可直接双击 .jar 文件打开软件,
如果没有反应, 请尝试在命令行中运行
javaw -jar jlu-drcom-java.jar
或 java -jar jlu-drcom-java.jar .
若您并不想安装 Java 那么本软件不适合您,
请您立即关闭本页面以免浪费您宝贵的时间。
如果您因为没有 Java 环境而运行不了本软件,请您不要急着骂作者,毕竟他原来只是打算写给自己使用的。虽然作者很乐意看到更多的同学使用这个小软件,但如何应对 连 Java 都不会安装的用户作者的确不想多费口舌,感谢您的理解。(实际上作者想过自带 Java 环境一起发布,但是 JRE 太大了;也想过手动精简 JRE 但是略麻烦,因此只发布了 jar 可执行包)
基本使用
主界面
主界面Ready
账号输入您的吉大邮箱账号(略去 @ 符号及之后的部分),密码是您吉大邮箱的密码;通常程序会自动检测到您的 MAC 地址,因此 MAC 可以保持默认;至于记住密码和自动登录选项可以根据需要勾选.
当勾选了“记住密码”时,将会在用户主目录保存您的信息,具体目录是 ${user.home}/.drcom/conf/drcom.java.conf .
当勾选了“自动登录”时,将会自动勾选“记住密码”.
登录成功通知
登录成功LoginNotice
当登录成功后,主界面将会自动隐藏到托盘, 然后将会弹出校园网通知.
当您账户余额不足时,将会出现上图所示画面,
请及时缴费以免断网. (通常,最多可以欠费 40 RMB)
登录成功
LoggedIn
当然,您可以随时通过点击托盘图标打开主界面, 这没什么好说的.
注销
点击注销按钮将会注销此次登录并弹出提示.
当程序出现异常时,比如登录时发现您的密码不正确,也会弹出提示框.
托盘
托盘Tray
(JavaFx 目前没有很好的方法支持托盘,因此使用的是 Java Swing 技术,导致右键菜单风格略微不一致)
高级
配置
如果您选择了记住密码,配置文件将保存在用户主目录下的 .drcom/conf 目录下。实际上您可以手动修改配置文件中的 MAC 地址(例如,极少同学可能使用的是路由器的 MAC 地址[并不提倡有违校方意愿的做法])那么可以在配置文件中修改,程序启动将会读取配置。
日志
日志目录:.drcom/logs/.
默认地,程序将不会记录很多日志,如果您发现程序出现异常,请您通过 javaw -Dlog.level=trace -jar jlu-drcom-java.jar 启动程序,若您觉得有必要,还可以将出现的问题及日志文件发给作者帮助改进本项目。
快捷键
屏幕上都写了,按钮是使用 ALT+KEY 的方式. 还有没写的 CTRL+W 您可以试试.
协议
通过 Wireshark 抓包我们可以了解到 drcom 协议的更多细节,同时我还发现了现有脚本的若干小问题,您可以在 jlu-drcom-protocol.md 中阅读更多。
鸣谢
感谢吉林大学 IBM 俱乐部副主席在本项目期间提供的各种帮助。
CopyLeft
jar 可执行软件采用 署名 – 非商业性使用 – 相同方式共享 4.0 国际 (CC BY-NC-SA 4.0)
进行授权。
您可以自由地使用、修改、复制、传播本作品,
但是需要注明来源(链接到本页面即可)
并且不能用于任何商业用途;您通过本作品演绎的作品也需要遵守本协议或兼容的协议。
此软件仅用于学习交流使用,请勿用于商业用途,
引用本项目的任何代码请注明出处并链接到本页面,
感谢您的理解与配合。
请您在不违反 校规和/或任何有效约束 的前提下使用本软件。
LICENSE
此项目源代码遵循 AGPL 协议。
TODO
添加“查看校园网通知”菜单项
浏览器添加 ALT+Left/Right 前进后退
解决“查看详细信息”面板在 Linux 下界面错乱问题
改进密码存储策略:当前位明文存储
软件运行时 lock 文件在 Linux 下可被删除
声明
本作品采用署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可。除非特别注明,
霖博客文章均为原创。
转载请保留本文(《吉大校园网客户端 Java 版》)链接地址:
https://youthlin.com/?p=1391