java实现-强智教务系统API文档-全部java封装

本文详细介绍了强智API接口的功能与实现方法,包括登录验证、获取课程表、成绩、考试信息等,通过具体代码示例展示了如何使用Java进行接口调用。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

项目的目录结构

 

AIP 接口类

package dao;

import net.sf.json.JSONObject;

/**
 * 实现强智API  https://qzapi.github.tlingc.com/api/getKbcxAzc/
 */

public interface Qzapi {
    /**
     * 相当于登录
     * @param xh  学号
     * @param pwd  密码
     * @return
     */
    JSONObject authUser(String xh,String pwd);

    /**
     *获取所提交的日期的时间、周次、学年等信息
     * @param currDate //格式为"YYYY-MM-DD",必填,留空调用成功,但返回值均为null
     * @return
     */
    JSONObject getCurrentTime(String currDate);

    /**
     * 获取一周的课程信息
     * @param xh 必填,使用与获取token时不同的学号,则可以获取到新输入的学号的课表
     * @param xnxqid 格式为"YYYY-YYYY-X",非必填,不包含时返回当前日期所在学期课表
     * @param zc //必填
     * @return
     */
    JSONObject getKbcxAzc(String xh,String xnxqid,String zc);

    /**
     *获取成绩信息
     * @param xh //必填,可以添加非本token学号查询他人成绩
     * @param xnxqid //非必填,不填输出全部成绩
     * @return
     */
    JSONObject getCjcx(String xh,String xnxqid);

    /**
     * 获取考试信息
     * @param xh
     * @return
     */
    JSONObject getKscx(String xh);

    /**
     * 获取某个校区教学楼信息
     * @param xqid //校区ID
     * @return
     */
    JSONObject getJxlcx(String xqid);

    /**
     * 获取空教室信息
     * @param time  //格式"YYYY-MM-DD",非必填,默认返回当前日期空闲教室
     * @param idleTime //有allday,am,pm,night四种取值,非必填,默认值疑似allday
     * @param xqid  //校区ID,非必填
     * @param jxlid //教学楼ID,非必填
     * @param classroomNumber  //可选项 30,30-40,40-50,60(分别意为30人以下,30-40人,···,60人以上)
     * @return
     */
    JSONObject getKxJscx(String time,String idleTime,String xqid,String jxlid,String classroomNumber);

    /**
     *  获取当前token的用户信息 注意:此API测试与参考文档不同,待修改/补充
     * @param xh 疑似非必填,添加或不添加本参数返回相同值
     * @return
     */
    JSONObject getStudentIdInfo(String xh);

    /**
     *
     * @param xh 学号
     * @return
     */
    JSONObject getUserInfo(String xh);

    /**
     * 获取学年学期信息
     * @param xh 2017xxxxxx'  //非必填
     * @return
     */
    JSONObject getXnxq(String xh);

    /**
     * 获取校区信息
     * @return
     */
    JSONObject getXqcx();

}

实现接口

package dao;

import net.sf.json.JSONObject;
import org.apache.http.message.BasicNameValuePair;
import utils.Util;

import java.io.IOException;
import java.net.URISyntaxException;
import java.util.ArrayList;
import java.util.List;

public class QzapiImpl implements Qzapi {
    private String xh = "20158553";
    private String pwd = "55557575";
    private List<BasicNameValuePair> list;

    private String token;
    private Util util = null;

    public QzapiImpl() {
        list = new ArrayList<BasicNameValuePair>();
        util = new Util();
        try {
            token = util.getToken(xh, pwd);
        } catch (URISyntaxException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }


    public JSONObject authUser(String xh, String pwd) {
        list.clear();  //从列表中删除所有元素。
        list.add(new BasicNameValuePair("method","authUser"));
        list.add(new BasicNameValuePair("xh",xh));
        list.add(new BasicNameValuePair("pwd",pwd));
        return util.execute(list,token);
    }

    public JSONObject getCurrentTime(String currDate) {
        list.clear();  //从列表中删除所有元素。
        list.add(new BasicNameValuePair("method","authUser"));
        list.add(new BasicNameValuePair("currDate",currDate));
        return util.execute(list,token);
    }

    public JSONObject getKbcxAzc(String xh, String xnxqid, String zc) {
        list.clear();  //从列表中删除所有元素。
        list.add(new BasicNameValuePair("method","getKbcxAzc"));
        list.add(new BasicNameValuePair("xh",xh));
        list.add(new BasicNameValuePair("xnxqid",xnxqid));
        list.add(new BasicNameValuePair("zc",zc));
        return util.execute(list,token);
    }

    public JSONObject getCjcx(String xh, String xnxqid) {
        list.clear();  //从列表中删除所有元素。
        list.add(new BasicNameValuePair("method","getCjcx"));
        list.add(new BasicNameValuePair("xh",xh));
        list.add(new BasicNameValuePair("xnxqid",xnxqid));
        return util.execute(list,token);
    }

    public JSONObject getKscx(String xh) {
        list.clear();  //从列表中删除所有元素。
        list.add(new BasicNameValuePair("method","getKscx"));
        list.add(new BasicNameValuePair("xh",xh));
        return util.execute(list,token);
    }

    public JSONObject getJxlcx(String xqid) {
        list.clear();  //从列表中删除所有元素。
        list.add(new BasicNameValuePair("method","getJxlcx"));
        list.add(new BasicNameValuePair("xqid",xqid));
        return util.execute(list,token);
    }

    public JSONObject getKxJscx(String time, String idleTime, String xqid, String jxlid, String classroomNumber) {
        list.clear();  //从列表中删除所有元素。
        list.add(new BasicNameValuePair("method","getKxJscx"));
        list.add(new BasicNameValuePair("time",time));
        list.add(new BasicNameValuePair("idleTime",idleTime));
        list.add(new BasicNameValuePair("xqid",xqid));
        list.add(new BasicNameValuePair("jxlid",jxlid));
        list.add(new BasicNameValuePair("classroomNumber",classroomNumber));
        return util.execute(list,token);
    }

    public JSONObject getStudentIdInfo(String xh) {
        list.clear();  //从列表中删除所有元素。
        list.add(new BasicNameValuePair("method","getStudentIdInfo"));
        list.add(new BasicNameValuePair("xh",xh));
        return util.execute(list,token);
    }

    public JSONObject getUserInfo(String xh) {
        list.clear();  //从列表中删除所有元素。
        list.add(new BasicNameValuePair("method","getUserInfo"));
        list.add(new BasicNameValuePair("xh",xh));
        return util.execute(list,token);
    }

    public JSONObject getXnxq(String xh) {
        list.clear();  //从列表中删除所有元素。
        list.add(new BasicNameValuePair("method","getXnxq"));
        list.add(new BasicNameValuePair("xh",xh));
        return util.execute(list,token);
    }

    public JSONObject getXqcx() {
        list.clear();  //从列表中删除所有元素。
        list.add(new BasicNameValuePair("method","getXqcx"));
        return  util.execute(list,token);
    }
}

 

调用的工具类

 

package utils;
import net.sf.json.JSONObject;
import org.apache.http.HttpEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.utils.URIBuilder;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.util.EntityUtils;

import java.io.IOException;
import java.net.URISyntaxException;
import java.util.List;

public class Util {

    public String getToken(String xh, String pwd) throws URISyntaxException, IOException {
        CloseableHttpClient httpClient = HttpClients.createDefault();
        URIBuilder uriBuilder = new URIBuilder("http://zswxyjw.minghuaetc.com/znlykjdxswxy/app.do");
        uriBuilder.setParameter("method", "authUser").setParameter("xh", xh).setParameter("pwd", pwd);
        HttpGet httpGet = new HttpGet(uriBuilder.build());
        CloseableHttpResponse response = httpClient.execute(httpGet);
        String s = null;
        if (response.getStatusLine().getStatusCode() == 200) {
            HttpEntity entity = response.getEntity();
            s = EntityUtils.toString(entity, "utf-8");
        }
        JSONObject obj = new JSONObject();
        obj = obj.fromObject(s);
        Object token = obj.get("token");
        return token.toString();
    }

    public JSONObject execute(List<BasicNameValuePair> list,String token)    {
        CloseableHttpClient httpClient = HttpClients.createDefault();
        URIBuilder uriBuilder = null;
        try {
            uriBuilder = new URIBuilder("http:*****app.do");
        } catch (URISyntaxException e) {
            e.printStackTrace();
            System.out.println("URL错误!");
        }
        //添加参数
        for (BasicNameValuePair i:list) {
            uriBuilder.setParameter(i.getName(),i.getValue());
        }

        HttpGet httpGet = null;
        try {
            //创建get请求
            httpGet = new HttpGet(uriBuilder.build());
        } catch (URISyntaxException e) {
            e.printStackTrace();
            System.out.println("util中httpget错误");
        }
        httpGet.setHeader("token",token);
        CloseableHttpResponse response = null;
        try {
            response = httpClient.execute(httpGet);
        } catch (IOException e) {
            e.printStackTrace();
            System.out.println("util中execute错误");
        }

        HttpEntity entity = response.getEntity();
        String s = null;
        try {
            s = EntityUtils.toString(entity, "utf-8");
        } catch (IOException e) {
            e.printStackTrace();
            System.out.println("字符串转换失败!");
        }

        JSONObject obj = new JSONObject();

        try {
            return obj.fromObject(s);
        }catch (Exception e) {
            s = "{\"result\":"+s+"}";
            return obj.fromObject(s);
        }
    }

}

 

测试类

 

大家都知道, Windows API是Windows操作系统的一系列的底层函数,是操作系统提供给用户进入操作系统核心进行高级编程的途径, 虽然微软在 Microsoft Visual Studio 6.0 及以下版本中提供了一个用于API浏览的API Text Viewer, 不过功能十分简陋, 部分声明有错误, 而且提供不够充足;而在 Microsoft Visual Studio 7.0 (.net) 及以上版本中为了达到跨平台、安全等一系列新特性,微软已经写好了一个内容丰富的受管制的代码类集合(.net基类库), 来完成以前要通过Windows API来完成的绝大多数任务, 虽然如此但还是有相当一部分功能必需调用Windows API来完成(如果你是VB.net或C#使用者, 强烈建议你尽可能使用.net基类库来完成你的工作); MSDN 中只有部分API的使用帮助, 而且并没有可立即复制到IDE中的API声明, 要使用某个函数不但要很好的了解这个函数的调用方法, 而且需要手动把声明转换成相应语言的API声明方式。于是我就将自己以前写的API浏览软件进行了适当的改动,让它提供上面的需求。它与 Microsoft Visual Studio 6.0 自带的浏览器相比有如下增强: 1、函数、类型、常数可自由删除、添加、编辑。 2、自动代码整理功能可免去你把声明复制到IDE后还需手工整理的麻烦。 3、雷达功能,可查看任意窗口句柄与类名,可作编程时的辅助工具。 4、在函数中能实现类型自动探测、搜索、添加。 5、在查询中支持使用通配符"?"、"*"、"[]"、"[^]"来进行代替一个或多个字符,包含不包含指定字符来查询。 6、可直接将函数、类型、常数转换成VB.net/C#/易语言声明方式。 7、添加函数时可智能自动添加与函数相关的类型、注释, 添加类型时自动添加类型中的类型, 类型中的常数, 常数中的常数功能, 大大加快了函数与相关类型、常数的复制添加速度。 8、可以根据功能分组浏览声明。   9、收藏夹功能,可将一组(功能相关)API声明添加到收藏夹。 10、颜色采集功能,可以采集当前屏幕上指定点的颜色。 11、可查看同api功能的.net类库。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值