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

最新推荐文章于 2021-02-27 12:28:10 发布

changaspl

最新推荐文章于 2021-02-27 12:28:10 发布

阅读量1.5k

点赞数

CC 4.0 BY-SA版权

分类专栏：强智教务系统API学习

本文链接：https://blog.youkuaiyun.com/qq_40674583/article/details/94409277

强智教务系统API学习专栏收录该内容

7 篇文章

订阅专栏

本文详细介绍了强智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);
        }
    }

}