给HUSTOJ用户提供的源码阅读与修改建议
文章目录
- 0、 准备知识
- 1、 Web部分
- 2、 Core部分
0、 准备知识
a) 最新系统源码可以用svn取得,或在下述地址直接浏览
i. http://code.google.com/p/hustoj/source/browse/ 墙外老版
ii. https://github.com/zhblue/hustoj 无墙新版
b) 系统分为Web和Core两个部分
c) 简化ER图
hustoj-db
d) Web与core的连接方式有两种,实际运行可选其中一种
i. 数据库连接【默认】
Web插入Solution表
core轮询solution表,发现新纪录
core更新solution表result等字段
Web端轮询soltuion显示result等字段。
ii. HTTP方式
Web插入Solution表
core访问Web端admin/problem_judge.php,发现新纪录
core向Web端admin/problem_judge.php提交数据,problem_judge.php更新solution表result等字段
Web端轮询soltuion显示result等字段。
1、 Web部分
a) 阅读配置文件,弄清各设置含义
i. 参考
db_info.inc.php
static $DB_HOST=“localhost”; 数据库的服务器地址
static $DB_NAME=“jol”; 数据库名
static $DB_USER=“root”; 数据库用户名
static $DB_PASS=“root”; 数据库密码
// connect db
static $OJ_NAME=“HUSTOJ”; OJ的名字,将取代页面标题等位置HUSTOJ字样。
static $OJ_HOME="./"; OJ的首页地址
static $OJ_ADMIN=“root@localhost”; 管理员email
static $OJ_DATA="/home/judge/data"; 测试数据所在目录,实际位置。
static $OJ_BBS=“discuss”;//“bbs” 论坛的形式,discuss为自带的简单论坛,bbs为外挂论坛,参考bbs.php代码。
static $OJ_ONLINE=false; 是否使用在线监控,需要消耗一定的内存和计算,因此如果并发大建议关闭
static $OJ_LANG=“en”; 默认的语言,中文为cn
static $OJ_SIM=true; 是否显示相似度检测的结果。
static $OJ_DICT=true; 是否启用在线英字典
static $OJ_LANGMASK=1008; //1mC 2mCPP 4mPascal 8mJava 16mRuby 32mBash 1008 for security reason to mask all other language 用掩码表示的OJ接受的提交语言,可以被比赛设定覆盖。
static $OJ_EDITE_AREA=true;// 是否启用高亮语法显示的提交界面,可以在线编程,无须IDE。
static $OJ_AUTO_SHARE=false;//true: 自动分享代码,启用的话,做出一道题就可以在该题的Status中看其他人的答案。
static $OJ_CSS=“hoj.css”; 默认的css,可以选择dark.css和gcode.css,具有有限的界面制定效果。
static $OJ_SAE=false; //是否是在新浪的云平台运行web部分
static $OJ_VCODE=true; 是否启用图形登录、注册验证码。
static OJAPPENDCODE=false;是否启用自动添加代码,启用的话,提交时会参考OJ_APPENDCODE=false; 是否启用自动添加代码,启用的话,提交时会参考OJAPPENDCODE=false;是否启用自动添加代码,启用的话,提交时会参考OJ_DATA对应目录里是否有append.c一类的文件,有的话会把其中代码附加到对应语言的答案之后,巧妙使用可以指定main函数而要求学生编写main部分调用的函数。
static $OJ_MEMCACHE=false;是否使用memcache作为页面缓存,如果不启用则用/cache目录
static $OJ_MEMSERVER=“127.0.0.1”; memcached的服务器地址
static $OJ_MEMPORT=11211; memcached的端口
static $OJ_RANK_LOCK_PERCENT=0; //比赛封榜时间的比率,如5小时比赛设为0.2则最后1小时封榜。
static $OJ_SHOW_DIFF=false; //显示WrongAnswer时的对比
b) 制定自己的前台模板(即改变页面效果)
i. 复制template/bs3目录,放置在template目录中,并改为新模板名。
ii. 在db_info.inc.php中修改$OJ_TEMPLATE变量为新模板名
iii. 浏览前台,打开要修改的页面,根据地址栏修改新目录中对应的php、css、images等文件,保存后刷新页面看修改效果。
c) 模板制定成功以后应该有足够的知识开始修改template目录以外的部分了
d) 论坛
i. 建议集成GPL的phpbb,参考。
ii. 集成Discuz
建议购买商业许可。
参考/web/include/login-discuz.php
e) 比赛根据数据通过率排名,而不只看AC数量
i. 数据库solution表pass_rate字段表示改条通过率。
ii. 把contestrank.php中的solved字段变成浮点对待。
iii. 这里,修改积分方式,按照希望的方式积分。可能需要给TM增加字段$p_wa_best_rate记录每题最大通过率。
f) 对有志于重写整个前台的勇士
i. 希望你选择一种魔法师编程语言(node.js/ror/python/go)。
ii. 如果做不到前面那条,请做好长时间开发的心理准备。
iii. 理论上任何现存web编程模型都可以,推荐JSP/SSH(前方高能坑……)。
iv. 建议实现admin/problem_judge.php的仿真,方便直接集成原版core。(get/post/ servlet-mapping)
2、 Core部分
a) 阅读配置文件,弄清各设置含义
i. 参考
judge.conf 不要复制下面的注释进入实际文件,judged和judge_client不能识别#注释。
OJ_HOST_NAME=127.0.0.1 #mysql host ip
OJ_USER_NAME=root #mysql host username
OJ_PASSWORD=root #mysql host password
OJ_DB_NAME=jol #mysql DB name
OJ_PORT_NUMBER=3306 #mysql port
OJ_RUNNING=4 #max concurrent threads number of judge_client
OJ_SLEEP_TIME=5 #judged work interval
OJ_TOTAL=1 #Deprecated: total number of judged (hosts/processes)
OJ_MOD=0 #Deprecated: the number of this judged(host)
OJ_JAVA_TIME_BONUS=2 #java’s extral time
OJ_JAVA_MEMORY_BONUS=512 #java’s extral memory
OJ_SIM_ENABLE=0 #using sim
OJ_HTTP_JUDGE=0 #using http link to database(if enabled,mysql is not used anymore)
OJ_HTTP_BASEURL=http://127.0.0.1/JudgeOnline #http link basedir
OJ_HTTP_USERNAME=admin #account in db that has http_judge privilege
OJ_HTTP_PASSWORD=admin #password of this account
OJ_OI_MODE=0 #using oi (Olympiad in Informatics) mode
OJ_SHM_RUN=0 #using /dev/shm for fast running & low harddisk wear
OJ_USE_MAX_TIME=0 #use the max time of all testcase rather than total time
OJ_LANG_SET=0,1,2,3,4 #selective judge solution of languagesOJ_HOST_NAME=127.0.0.1 如果用mysql连接读取数据库,数据库的主机地址
OJ_USER_NAME=root 数据库帐号
OJ_PASSWORD=root 数据库密码
OJ_DB_NAME=jol 数据库名称
OJ_PORT_NUMBER=3306 数据库端口
OJ_RUNNING=4 judged会启动judge_client判题,这里规定最多同时运行几个judge_client
OJ_SLEEP_TIME=5 judged通过轮询数据库发现新任务,轮询间隔的休息时间,单位秒
OJ_TOTAL=1 老式并发处理中总的judged数量
OJ_MOD=0 老式并发处理中,本judged负责处理solution_id按照TOTAL取模后余数为几的任务。
OJ_JAVA_TIME_BONUS=2 Java等虚拟机语言获得的额外运行时间。
OJ_JAVA_MEMORY_BONUS=512 Java等虚拟机语言获得的额外内存。
OJ_SIM_ENABLE=0 是否使用sim进行代码相似度的检测
OJ_HTTP_JUDGE=0 是否使用HTTP方式连接数据库,如果启用,则前面的HOST_NAME等设置忽略。
OJ_HTTP_BASEURL=http://127.0.0.1/JudgeOnline 使用HTTP方式连接数据库的基础地址,就是OJ的首页地址。
OJ_HTTP_USERNAME=admin 使用HTTP方式所用的用户帐号(HTTP_JUDGE权限),该帐号登录时不能启用VCODE图形验证码,但可以登录成功后启用。
OJ_HTTP_PASSWORD=admin 密码
OJ_OI_MODE=0 是否启用OI模式,即无论是否出错都继续判剩余的数据,在ACM比赛中一旦出错就停止运行。
OJ_SHM_RUN=0 是否使用/dev/shm的共享内存虚拟磁盘来运行答案,如果启用能提高判题速度,但需要较多内存。
OJ_USE_MAX_TIME=1 是否使用所有测试数据中最大的运行时间作为最后运行时间,如果不启用则以所有测试数据的总时间作为超时判断依据。
OJ_LANG_SET=0,1,2,3,4 #判哪些语言的题目
OJ_COMPILE_CHROOT=0 是否在编译时使用chroot环境,避免某些编译期攻击。
OJ_TURBO_MODE=0 是否放弃用户表和问题表的数据一致性,以在大型比赛中添加更多的判题机来提高判题速度。
ii. 源码https://github.com/zhblue/hustoj/blob/master/trunk/core/judge_client/
b) 查阅Linux文档中关于下述关键词的内容
i. Ptrace
ii. Chroot
iii. Setuid
iv. Proc
v. shm
c) 所有API限定在okcalls.h
d) 代码查重工具sim
i. https://github.com/zhblue/hustoj/tree/master/trunk/core/sim
e) 对于计划改造Core来适应你自己的OJ前台的朋友
i. 参考1.c.iv
ii. 在judge_client.cc中搜索关键词wget
f) HUSTOJ的沙箱模型
i. 相对openjudge.net的sandbox libraries而言并不严谨
ii. 对于OJ而言,基本满足需求
iii. 容易理解、容易实现、容易修改
f) 莫名其妙的Runtime Error,请点击RuntimeError打开详细信息,并做英译汉。
对于okcalls23/64.h进行修改,请只修改符合你的操作系统架构(32位/64位)的那个,0只能在首位,末尾必须为0。非0callid请加在中间任意位置。
CSDN网友的源码注释
http://blog.csdn.net/legan/article/details/40746829
http://blog.csdn.net/legan/article/details/40789939
给HUSTOJ用户提供的源码阅读与修改建议相关推荐
- 【面试】足够应付面试的Spring事务源码阅读梳理(建议珍藏)
Starting from a joke 问:把大象放冰箱里,分几步? 答:三步啊,第一.把冰箱门打开,第二.把大象放进去,第三.把冰箱门带上. 问:实现Spring事务,分几步? 答:三步啊,第一. ...
- 事务注解放到类上面 下面私有方法有效吗_【面试】足够应付面试的Spring事务源码阅读梳理(建议珍藏)...
Starting from a joke 问:把大象放冰箱里,分几步? 答:三步啊,第一.把冰箱门打开,第二.把大象放进去,第三.把冰箱门带上. 问:实现Spring事务,分几步? 答:三步啊,第一. ...
- 大神手把手教源码阅读的方法、误区以及三种境界
丁威 中间件兴趣圈 读完需要 1 分钟 速读仅需 1 分钟 在技术职场中普遍存在如下几种现象: 对待工作中所使用的技术不需要阅读源码,只需在开发过程中能够熟练运用就行 看源码太费时间,而且容易忘记,如 ...
- Apollo perception源码阅读 | lidar
#! https://zhuanlan.zhihu.com/p/389572382 Apollo perception源码阅读 | lidar 本文为Apollo感知融合源码阅读笔记,建议参照Apol ...
- Java源码阅读的真实体会
刚才在论坛不经意间,看到有关源码阅读的[url=http://www.iteye.com/topic/854647]帖子[/url].回想自己前几年,阅读源码那种兴奋和成就感([url=http:// ...
- DM 源码阅读系列文章(二)整体架构介绍
2019独角兽企业重金招聘Python工程师标准>>> 作者:张学程 本文为 DM 源码阅读系列文章的第二篇,第一篇文章 简单介绍了 DM 源码阅读的目的和规划,以及 DM 的源码结 ...
- log4j源码阅读(一)之Logger
概述 log4j是一款非常方便而且强大的开源日志项目,在经过简单的配置后,可以达到相当不错的效果. 头脑一热决定对log4j的源码进行一定的阅读,其初衷是希望通过源码的阅读,提高写代码的能力. log ...
- DotText源码阅读(7) --Pingback/TrackBack
DotText源码阅读(7) --Pingback/TrackBack 博客这种服务的区别于论坛和所谓文集网站,很大程度上我认为是由于pingback/trackback的存在,使得博客这种自媒体有可 ...
- mybatis源码阅读(二):mybatis初始化上
转载自 mybatis源码阅读(二):mybatis初始化上 1.初始化入口 //Mybatis 通过SqlSessionFactory获取SqlSession, 然后才能通过SqlSession与 ...
最新文章
- 深度学习“四大名著”发布!Python、TensorFlow、机器学习、深度学习四件套(附免费下载)...
- 织梦dedecsm系统企业简介类单栏目模版如何修改和调用
- No plugin found for prefix ‘scala‘ pom.xml
- jpa映射json_如何使用JPA和Hibernate映射JSON集合
- Redis高频面试笔记:java版本号比较算法
- Java同步数据结构之ConcurrentLinkedQueue
- 诺基亚智能手机知识大全
- 零和收益DEA模型(ZSG-DEA)的求解
- 移动pc多平台运营级家校互动平台系统源码转让
- podman加速器配置Harbor
- java控制语句_java基础之 控制语句
- 传奇人物《周兴和》书连载30 成功背后的陷阱
- 超详细测试项目——Web电商项目测试点整理.....
- 上课签到 php,福建一高校学生上课需刷脸签到 被赞高大上
- 企业微信视频教程(Java标准版)-翟东平-专题视频课程
- 蒲公英分布平台下载更新实现
- 70个JavaScript面试问题
- js递归理解及使用案例
- 在线帮助中心对企业的作用及解决方案
- java计时器StopWatch
热门文章
- 【C#】隐式类型var
- 9.20–9.24 三亚
- hibernate访问效率相关
- android 字符串转字节数组,java – 在Android中将字节数组转换为Charsequence
- python中json如何存放字节数组中_测试面试题集锦(四)| Linux 与 Python 编程篇(附答案)...
- 下载丨8月数据库技术通讯:不合理业务设计导致CPU飙升
- 工具丨超好用的免费AWR分析工具
- 系列 | 高性能存储-MySQL数据库之存储过程揭秘
- 面对行业难题,华为云邀请物联网全行业拿出“亮剑”精神
- 使用MRS CDL实现实时数据同步的极致性能