jquery.http使用说明

快速开始

var http = $.http;
http.get('/server', function() {
    // 请求成功且返回status === true时的回调
});

初始化

默认会在发送请求时自动初始化, 但是也可以使用http.init(options)手动初始化。

初始化时的配置参数说明:

options.style: 初始化样式
options.html: 初始化模板
options.title: 弹框提示的标题内容, 可省
options.buttons: 弹框提示时的按钮文字, 可省(buttons: {submit, cancel})
options.codeKey: 返回内容的code部分的键名(默认为code)
options.statusKey: 返回内容的status部分的键名(默认为status)
options.codeMaps: Object, 对应code的错误提示内容
options.messages: Object, 对应400/500系列状态码的错误提示内容

当服务端返回的状态码为400/500等时, 弹框提示内容为options.messages中的定义; 当服务端返回的状态码为200系列时, 弹框提示内容为options.codeMaps中的定义, 如果未定义, 则显示res.message, 如果还没有, 则提示默认错误内容

发送ajax请求

除了$.ajax本身的配置项之外, 其余增加的配置如下:

options.uuid: 请求的唯一标记, 添加该标记则在该次请求结束之前无法重复提交该请求
options.loading: 是否显示全屏loading, 默认为true
options.title: 弹框提示的标题内容, 可省
options.buttons: 弹框提示时的按钮文字, 可省(buttons: {submit, cancel})
options.alert: 是否弹框, 默认为true, 如果为'both', 则成功时也会弹框
options.ignore: 是否在status为false时执行成功的回调, 默认为true不执行
options.confirm: 在操作前弹出确认框(confirm: {title, message})

方法名称

http.init(options)

全局初始化配置。

http.ajax(options)

发送ajax请求。

http.get(url, [fn,] options)

发送get请求。 当第二个参数为函数时, 则为请求成功时的回调, 也可以省略第二个参数, 此时第二个参数即为请求配置项参数。

http.post(url, data, [fn,] options)

发送post请求。参数说明同get。

http.put(url, data, [fn,] options)

发送put请求。参数说明同get。

http.delete(url, [fn,] options)

发送delete请求。参数说明同get。

辅助方法

http.info(message, title)

提示信息，标题title可省略。

http.warn(message, title)

提示信息，标题title可省略。

http.error(message, title)

提示信息，标题title可省略。

http.success(message, title)

提示信息，标题title可省略。

http.confirm(message, title, callback, fallback, buttons)

确认信息，其中以下字段可省略: title, fallback, buttons。

上下文context

在beforeSend，complete，success和error回调函数中，如果没有在options中指定上下文，则this默认指向$.http对象。

$('#sendPost').on('click', function () {
    $.http.post('/success?status=1', {
        a: 100
    }, {
        success: function(res){
            this.info('操作成功');
        }
    })
});