ManyCourse 教务系统后端接入：南航金城学院 API 逆向与 Kotlin 实现

1
import okhttp3.Cookie
2
import okhttp3.CookieJar
3
import okhttp3.HttpUrl
4
import okhttp3.HttpUrl.Companion.toHttpUrlOrNull
5

6
class MemoryCookieJar : CookieJar {
7
    private val store = LinkedHashMap<String, MutableList<Cookie>>()
8

9
    @Synchronized
10
    override fun saveFromResponse(url: HttpUrl, cookies: List<Cookie>) {
11
        val list = store.getOrPut(url.host) { mutableListOf() }
12
        cookies.forEach { c ->
13
            list.removeAll { it.name == c.name && it.path == c.path }
14
            list.add(c)
15
        }
16
    }
17

18
    @Synchronized
19
    override fun loadForRequest(url: HttpUrl): List<Cookie> {
20
        val list = store[url.host] ?: return emptyList()
21
        val now = System.currentTimeMillis()
22
        list.removeAll { it.expiresAt < now }
23
        return list.filter { it.matches(url) }
24
    }
25

26
    @Synchronized
27
    fun valueOf(url: String, name: String): String? {
28
        val u = url.toHttpUrlOrNull() ?: return null
29
        return loadForRequest(u).firstOrNull { it.name == name }?.value
30
    }
31
}

1
data class CourseItem(
2
    val id: Int,
3
    val kkh: String,        // 课序号
4
    val kch: String,        // 课程号
5
    val xn: String,         // 学年
6
    val xq: Int,            // 学期
7
    val weekDay: Int,       // 星期几 1=周一 ... 7=周日
8
    val startUnit: Int,     // 起始节次
9
    val unitCount: Int,     // 连排节数
10
    val room: String,       // 教室
11
    val courseName: String, // 课程名
12
    val teacher: String,    // 教师
13
    val classNos: String,   // 上课班级
14
    val campus: String,     // 校区
15
    val weeks: String,      // 周次串 "3-5,8-20"
16
    val students: Int       // 选课人数
17
)

1
import okhttp3.*
2
import okhttp3.MediaType.Companion.toMediaType
3
import okhttp3.RequestBody.Companion.toRequestBody
4
import org.jsoup.Jsoup
5
import java.io.IOException
6
import java.util.concurrent.TimeUnit
7

8
class JwxtClient(private val baseUrl: String = "https://jcjx.nhjcxy.edu.cn") {
9

10
    private companion object {
11
        const val UA =
12
            "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 " +
13
            "(KHTML, like Gecko) Chrome/152.0.0.0 Safari/537.36 Edg/152.0.0.0"
14
        const val LOGIN_PAGE = "/Mvc/Base/Login/"
15
        const val LOGIN_API  = "/Mvc/Base/Login"
16
        const val SCHEDULE   = "/Mvc/Manager/Module/NetEa/Schedule/Query/Default.aspx"
17
    }
18

19
    private val cookies = MemoryCookieJar()
20
    private val client = OkHttpClient.Builder()
21
        .cookieJar(cookies)
22
        .connectTimeout(15, TimeUnit.SECONDS)
23
        .readTimeout(30, TimeUnit.SECONDS)
24
        .followRedirects(true)
25
        .build()
26

27
    // ---------------- 登录 ----------------
28

29
    /**
30
     * @param account  加密后的账号（对应 U_Account）
31
     * @param password 加密后的密码（对应 U_Password）
32
     * @param validCode 验证码，可为空
33
     * @return true 表示拿到了 .Yyw.Base 会话 cookie
34
     */
35
    fun login(account: String, password: String, validCode: String = ""): Boolean {
36
        // 1) GET 登录页，取 SessionId / __RequestVerificationToken
37
        client.newCall(
38
            Request.Builder()
39
                .url(baseUrl + LOGIN_PAGE)
40
                .header("User-Agent", UA)
41
                .header("Accept", "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8")
42
                .build()
43
        ).execute().use { resp ->
44
            if (!resp.isSuccessful) throw IOException("打开登录页失败: ${resp.code}")
45
            resp.body?.string()   // 触发 cookie 落盘
46
        }
47

48
        // 2) POST 登录
49
        val form = FormBody.Builder()
50
            .add("U_Account", account)
51
            .add("U_Password", password)
52
            .add("U_WeChat", "")
53
            .add("U_LoginType", "")
54
            .add("TqPlatform", "")
55
            .add("U_Remark", "false")
56
            .add("U_Licence", "")
57
            .add("U_MobileNo", "")
58
            .add("U_Sex", "Man")
59
            .add("ValidCode", validCode)
60
            .build()
61

62
        val req = Request.Builder()
63
            .url(baseUrl + LOGIN_API)
64
            .header("User-Agent", UA)
65
            .header("Accept", "*/*")
66
            .header("X-Requested-With", "XMLHttpRequest")
67
            .header("Origin", baseUrl)
68
            .header("Referer", baseUrl + LOGIN_PAGE)
69
            .post(form)
70
            .build()
71

72
        client.newCall(req).execute().use { resp ->
73
            if (!resp.isSuccessful) return false
74
            resp.body?.string()
75
        }
76

77
        // 3) 判定成功：出现 .Yyw.Base
78
        return cookies.valueOf(baseUrl, ".Yyw.Base") != null
79
    }
80

81
    // ---------------- 课表查询 ----------------
82

83
    /**
84
     * @param xnXq    学年学期，例如 "2026-2027,1"
85
     * @param type    "班级" / "教师" / "教室" / "课程"
86
     * @param keyword 对应关键字，例如班号 "02680403"
87
     * @param date    日期 "yyyy-M-d"，如 "2026-9-16"
88
     * @param week    周次，可空
89
     */
90
    fun queryScheduleHtml(
91
        xnXq: String,
92
        type: String,
93
        keyword: String,
94
        date: String = "",
95
        week: String = ""
96
    ): String {
97
        // 1) GET 页面拿 __VIEWSTATE
98
        val pageReq = Request.Builder()
99
            .url(baseUrl + SCHEDULE)
100
            .header("User-Agent", UA)
101
            .header("Accept", "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8")
102
            .build()
103

104
        val pageHtml = client.newCall(pageReq).execute().use { resp ->
105
            if (!resp.isSuccessful) throw IOException("打开课表页失败: ${resp.code}")
106
            resp.body!!.string()
107
        }
108

109
        val doc = Jsoup.parse(pageHtml)
110
        val viewState = doc.selectFirst("input[name=__VIEWSTATE]")?.attr("value").orEmpty()
111
        val viewStateGen = doc.selectFirst("input[name=__VIEWSTATEGENERATOR]")
112
            ?.attr("value").orEmpty().ifEmpty { "39FBE882" }
113

114
        // 2) 构造 multipart/form-data
115
        val multipart = MultipartBody.Builder()
116
            .setType(MultipartBody.FORM)
117
            .addFormDataPart("__EVENTTARGET", "")
118
            .addFormDataPart("__EVENTARGUMENT", "")
119
            .addFormDataPart("__LASTFOCUS", "")
120
            .addFormDataPart("__VIEWSTATE", viewState)
121
            .addFormDataPart("__VIEWSTATEGENERATOR", viewStateGen)
122
            .addFormDataPart("__VIEWSTATEENCRYPTED", "")
123
            .addFormDataPart("ctl00\$PageBody\$XnXq\$DropDownListXnXq", xnXq)
124
            .addFormDataPart("ctl00\$PageBody\$RbtlType", type)
125
            .addFormDataPart("ctl00\$PageBody\$TxbInput", keyword)
126
            .addFormDataPart("ctl00\$PageBody\$BtnShowTable", "查看课表")
127
            .addFormDataPart("ctl00\$PageBody\$TxbDate", date)
128
            .addFormDataPart("ctl00\$PageBody\$DrpZc", week)
129
            .addFormDataPart("ctl00\$PageBody\$RbtlCourseType", "")
130
            .addFormDataPart("ctl00\$DoPostBack_LiuManRang", "")
131
            .build()
132

133
        val req = Request.Builder()
134
            .url(baseUrl + SCHEDULE)
135
            .header("User-Agent", UA)
136
            .header(
137
                "Accept",
138
                "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8"
139
            )
140
            .header("Origin", baseUrl)
141
            .header("Referer", baseUrl + SCHEDULE)
142
            .post(multipart)
143
            .build()
144

145
        return client.newCall(req).execute().use { resp ->
146
            if (!resp.isSuccessful) throw IOException("查询课表失败: ${resp.code}")
147
            resp.body!!.string()
148
        }
149
    }
150
}

1
object ScheduleParser {
2

3
    private fun String.clean(): String = replace('\u00a0', ' ').trim()
4

5
    /** 解析 "3-5,8-20" 这类周次串 */
6
    fun parseWeeks(spec: String): Set<Int> {
7
        val result = mutableSetOf<Int>()
8
        spec.split(',', '，')
9
            .map { it.trim() }
10
            .filter { it.isNotEmpty() }
11
            .forEach { seg ->
12
                if ('-' in seg) {
13
                    val parts = seg.split('-')
14
                    val a = parts.getOrNull(0)?.trim()?.toIntOrNull()
15
                    val b = parts.getOrNull(1)?.trim()?.toIntOrNull()
16
                    if (a != null && b != null && a <= b) for (w in a..b) result += w
17
                } else {
18
                    seg.toIntOrNull()?.let { result += it }
19
                }
20
            }
21
        return result
22
    }
23

24
    /** 从课表 HTML 中抽出所有课程 */
25
    fun parseCourses(html: String): List<CourseItem> {
26
        val doc = Jsoup.parse(html)
27
        val table = doc.getElementById("GrwCourseTablePrint") ?: return emptyList()
28
        val rows = table.select("tr")
29
        if (rows.size <= 1) return emptyList()   // 第一行是表头
30

31
        return rows.drop(1).mapNotNull { tr ->
32
            val tds = tr.select("td")
33
            if (tds.size < 22) return@mapNotNull null
34

35
            fun cell(i: Int): String = tds[i].text().clean()
36

37
            val id = cell(0).toIntOrNull() ?: return@mapNotNull null
38

39
            CourseItem(
40
                id         = id,
41
                kkh        = cell(1),
42
                kch        = cell(3),
43
                xn         = cell(4),
44
                xq         = cell(5).toIntOrNull() ?: 0,
45
                weekDay    = cell(6).toIntOrNull() ?: 0,
46
                startUnit  = cell(7).toIntOrNull() ?: 0,
47
                unitCount  = cell(8).toIntOrNull() ?: 1,
48
                room       = cell(9),
49
                weeks      = cell(10),
50
                courseName = cell(11),
51
                teacher    = cell(14),
52
                classNos   = cell(15),
53
                students   = cell(17).toIntOrNull() ?: 0,
54
                campus     = cell(19)
55
            )
56
        }
57
    }
58

59
    /** 按星期几分组，方便渲染课表 */
60
    fun groupByWeekDay(courses: List<CourseItem>): Map<Int, List<CourseItem>> =
61
        courses.groupBy { it.weekDay }
62

63
    /** 提取某周实际要上的课 */
64
    fun filterByWeek(courses: List<CourseItem>, week: Int): List<CourseItem> =
65
        courses.filter { week in parseWeeks(it.weeks) }
66
}

1
fun main() {
2
    val client = JwxtClient()
3

4
    // 1) 登录（账号密码需为前端加密后的值）
5
    val ok = client.login(
6
        account  = "0443a0720688480932304db3dfa5202b...",
7
        password = "044a92bf9c8e7d193cb1f7b8624ce64b..."
8
    )
9
    println("login = $ok")
10
    if (!ok) return
11

12
    // 2) 查询课表 HTML
13
    val html = client.queryScheduleHtml(
14
        xnXq    = "2026-2027,1",
15
        type    = "班级",
16
        keyword = "02680403",
17
        date    = "2026-9-16"
18
    )
19

20
    // 3) 解析
21
    val courses = ScheduleParser.parseCourses(html)
22
    courses.forEach { println(it) }
23

24
    // 4) 按星期几分组输出
25
    ScheduleParser.groupByWeekDay(courses).toSortedMap().forEach { (day, list) ->
26
        println("星期$day:")
27
        list.sortedBy { it.startUnit }.forEach {
28
            println("  ${it.startUnit}-${it.startUnit + it.unitCount - 1}节 " +
29
                    "${it.courseName} @${it.room} ${it.teacher} [${it.weeks}周]")
30
        }
31
    }
32

33
    // 5) 只看第 10 周
34
    println("== 第10周 ==")
35
    ScheduleParser.filterByWeek(courses, 10).forEach { println(it) }
36
}