【油猴脚本】课程表生成ics文件#

一、原理#

通过截取课表xhr的json文件，提取内容生成ics#

二、用法#

登录进西大的远程一站式网上办事大厅

然后点进办事大厅

接着就是正常的查询课表流程，进入教务系统，查询学生课表

三、设计思路#

1.拦截xhr#

使用了油猴脚本开发指南 XHR劫持代码原理解释-油猴中文网的代码

1
function addXMLRequestCallback(callback){
2
    //是一个劫持的函数
3
    var oldSend, i;
4
    if( XMLHttpRequest.callbacks ) {
5
      //判断XMLHttpRequest对象下是否存在回调列表，存在就push一个回调的函数
6
        XMLHttpRequest.callbacks.push( callback );
7
    } else {
8
        XMLHttpRequest.callbacks = [callback];
9
        //如果不存在则在xmlhttprequest函数下创建一个回调列表
10
        oldSend = XMLHttpRequest.prototype.send;
11
        //获取旧xml的send函数，并对其进行劫持
12
        XMLHttpRequest.prototype.send = function(){
13
            for( i = 0; i < XMLHttpRequest.callbacks.length; i++ ) {
14
                XMLHttpRequest.callbacks[i]( this );
15
            }
16
            //循环回调xml内的回调函数
17
            // call the native send()
18
            oldSend.apply(this, arguments);
19
           //由于我们获取了send函数的引用，并且复写了send函数，这样我们在调用原send的函数的时候，需要对其传入引用，而arguments是传入的参数
20
        }
21
    }
22
}
23

24
// e.g.
25
addXMLRequestCallback( function( xhr ) {
26
        //调用劫持函数，填入一个function的回调函数
27
        //回调函数监听了对xhr调用了监听load状态，并且在触发的时候再次调用一个function，进行一些数据的劫持以及修改
28
        xhr.addEventListener("load", function(){
29
        if ( xhr.readyState == 4 && xhr.status == 200 ) {
30
            console.log( xhr.responseURL );
31
        }
32
    });
33

34
});

2.分析课表内容#

由于课表是一个json文件，通过拦截读取时不是json，而是字符串，需要使用**JSON.parse()**函数转化为json对象

得到对象之后，分析结构

1
{
2
    "qsxqj":"", // 不清楚，大概是学期数
3
    "xsxx":{ }, // 学生信息，不管
4
    "sjkList": [], // 不知道是啥
5
    "xqjmcMap":{}, // 星期对象，方便显示星期，压缩代码中的字符串
6
    "xskbsfxstkzt":"", // 不清楚
7
    "rqazcList": [], // 不清楚
8
    "kbList":[ // 课表本体（分析对象）
9

10
        ],
11
    "xsbjList":[], // 里面放的是课程类型
12
    "zckbsfxssj": "", // 不清楚
13
    "djdzList": [], // 不清楚
14
    "kblx":"", // 不清楚，课表类型？
15
    "sfxsd":"", // 不清楚
16
    "xqbzxxszList": [], // 不清楚
17
    "xkkg": "", // 不清楚
18
    "jxhjkcList": [], // 不清楚
19
    "xnxqsfkz": "" // 不清楚
20
}

单独分析”kbList”

1
// 每个{}代表一个课程
2
[
3
    {
4
      "cd_id": "", // 什么id,值是上课地点
5
      "cdmc": "", // 上课地点
6
      "cxbj": "", // 不清楚
7
      "cxbjmc": "", // 不清楚
8
      "date": "", // 查询当天的日期（不是很理解）
9
      "dateDigit": "", // 查询当天的日期（不是很理解）
10
      "dateDigitSeparator": "", // 查询当天的日期（不是很理解）
11
      "day": "", // 查询当天的日期
12
      "jc": "",  // 课程节数
13
      "jcor": "", // 课程节数
14
      "jcs": "", // 课程节数
15
      "jgh_id": "", // 课程开课时间？？不清楚
16
      "jgpxzd": "", // 不清楚
17
      "jxb_id": "", // 课程id吧，应该
18
      "jxbmc": "", // 课程名称
19
      "jxbsftkbj": "", // 不清楚
20
      "jxbzc": "", // 年份？
21
      "kcbj": "", // 课程类型（主修）
22
      "kch": "", // 课程号吧
23
      "kch_id": "", // 课程号id？
24
      "kclb": "", // 课程类型（通识教育课程）
25
      "kcmc": "", // 课程名称
26
      "kcxszc": "", // 课程学习分布（讲课：xx，实验：xx）
27
      "kcxz": "", // 课程类型简写（通必）
28
      "khfsmc": "", // 不清楚
29
      "kkzt": "", // 不清楚
30
      "listnav": "", // 不清楚
31
      "localeKey": "", // 本地语言
32
      "month": "", // 查询当天的月份
33
      "oldjc": "", // 不清楚
34
      "oldzc": "", // 不清楚
35
      "pageTotal": "", // 翻译是页面总数，不清楚
36
      "pageable": "", // 是否可翻页，不清楚
37
      "pkbj": "", // 不清楚
38
      "queryModel": { // 查询的参数
39
        "currentPage":"",
40
        "currentResult": "",
41
        "entityOrField": "",
42
        "limit": "",
43
        "offset": "",
44
        "pageNo": "",
45
        "pageSize": "",
46
        "showCount": "",
47
        "sorts": [],
48
        "totalCount": "",
49
        "totalPage": "",
50
        "totalResult": ""
51
      },
52
      "rangeable": "", // 不清楚
53
      "rk": "", // 不清楚
54
      "rsdzjs": "", // 不清楚
55
      "skfsmc": "", // 授课方式
56
      "sxbj": "", // 不清楚
57
      "totalResult": "",
58
      "userModel": { // 不清楚
59
        "monitor": "",
60
        "roleCount": "",
61
        "roleKeys": "",
62
        "roleValues": "",
63
        "status": "",
64
        "usable": ""
65
      },
66
      "xf": "", // 学分
67
      "xkbz": "", // 不清楚
68
      "xm": "", // 教师名字
69
      "xnm": "", // 学年
70
      "xqdm": "", // 不清楚
71
      "xqh1": ",", // 不清楚
72
      "xqh_id": "", // 不清楚
73
      "xqj": "", // 上课星期
74
      "xqjmc": "", // 上课星期
75
      "xqm": "", // 不清楚
76
      "xqmc": "", // 上课地点区域
77
      "xsdm": "", // 不清楚
78
      "xslxbj": "", // 课程类型
79
      "year": "", // 学年吧
80
      "zcd": "", // 上课周期
81
      "zcmc": "", // 教师类型
82
      "zfjmc": "", // 不清楚
83
      "zhxs": "", // 不清楚
84
      "zxs": "", // 不清楚
85
      "zxxx": "", // 不清楚
86
      "zyfxmc": "", // 不清楚
87
      "zzrl": "" // 不清楚
88
    }
89
]

3.提取重要信息#

在我的脚本里面，我用了一个全局变量来装提取之后的信息

结构是这样的

1
{
2
  "termStart":"", // 学期第一天星期一
3
  "termEnd":"", // 学期最后一天
4
  "kbList":[
5
    {
6
      "SUMMARY":"", // 课程名
7
      "FREQ":"", // 若为x，则为不循环课程
8
      "UNTIL":"",
9
      "INTERVAL":"",
10
      "DTSTART":"Asia/Shanghai:",
11
      "DTEND":"Asia/Shanghai:",
12
      "UID":"",// 随机生成,
13
      "DESCRIPTION1":"", // 第x-x节\nx区 教室\n教师
14
      "DESCRIPTION2":"", // 课程名@x区 教室\n
15
      "LOCATION":"" // x区 教室 教师
16
    }
17
  ]
18
}

中间那些关键词是ICS格式的标准参数

具体看iCalendar Specification Excerpts

4.合成并下载ICS文件#

ics文件的格式可以下载一个课表文件作为参考，就用字符串串起来就好

别忘了换行（\n)，如果想要在日历内换行，别忘了转义符

下载的原理就是a标签，函数为

1
// 下载函数
2
  function download_file (fileName, content) {
3
    var aTag = document.createElement('a')
4
    var blob = new Blob([content])
5
    aTag.download = fileName
6
    aTag.href = URL.createObjectURL(blob)
7
    aTag.click()
8
    URL.revokeObjectURL(blob)
9
  }

四、使用地址#

greasyfork

欢迎在反馈中提bug，看到了我会修的

西南大学学生课程表生成ics