1 Star 1 Fork 0

Rong姐姐好可爱 / egg-axios-plus

Create your Gitee Account
Explore and code with more than 5 million developers,Free private repositories !:)
Sign up
Clone or download
Cancel
Notice: Creating folder will generate an empty file .keep, because not support in Git
Loading...
README.md

egg-axios-plus

NPM version npm download

egg-axios-plus is based on the axios plug-in, it is applicable to the basic HTTP request of the egg framework, and satisfies the async / await operation. Welcome to use the plug-in to learn more properties and functions

Features

  • Make XMLHttpRequests from the browser
  • Make http requests from node.js
  • Supports the Promise API
  • Intercept request and response
  • Transform request and response data
  • Cancel requests
  • Automatic transforms for JSON data
  • Client side support for protecting against XSRF

Install

$ npm install egg-axios-plus --save
## If the axios module is indeed in operation, download the latest version of axios dependency
$ npm install axios@latest --save

Usage

// {app_root}/config/plugin.js
exports.axiosPlus = {
  enable: true,
  package: 'egg-axios-plus',
};

Configuration

// {app_root}/config/config.default.js
exports.axiosPlus = {
    // can set more config in headers,like token,references and so on
    headers: {
    common: {
        'Content-Type': 'application/json; charset=UTF-8',
        // 添加认证【例如】,也可以在请求拦截器中修改具体的request config
        // 'Authorization':'19980115_520' // 不要问我19980115是什么,当然是女朋友生日呀!!!
    },
    // 可以设置请求头等属性
    },
    // 定义请求拦截器处理方法【可选】
    // requestInterceptorsHandler: config => {
    //   // 请求之前的配置信息
    //   // 当该字段【函数】不存在是,默认如下:
    //   app.coreLogger.debug(`[egg-axios-plus] send request, baseURL: ${JSON.stringify(config.baseURL)}, url: ${config.url}, method: ${config.method}, data: ${JSON.stringify(config.data)}, headers: ${JSON.stringify(config.headers)}`);
    //   return config;
    // },
    // requestInterceptorsErrorHandler: error => {
    //   // 请求之后发生的错误信息
    //   // 当该字段【函数】不存在是,默认如下:
    //   app.coreLogger.error(`[egg-axios-plus] send request error, ${error.message}`);
    //   return Promise.reject(error);
    // },
    // // 定义axios响应拦截器处理方法【可选】
    // responseInterceptorsHandler: response => {
    //   // response 响应结果
    //   // 当该字段【函数】不存在是,默认如下:
    //   app.coreLogger.debug(`[egg-axios-plus] receive response, data: ${JSON.stringify(response.data)}, status: ${response.status}, headers: ${JSON.stringify(response.headers)}`);
    //   if (response.config && (response.config.method.toUpperCase() === 'HEAD' || response.config.method.toUpperCase() === 'options')) {
    //     return response;
    //   }
    //   return response.data;
    // },
    // responseInterceptorsErrorHandler: error => {
    //   // 接口响应失败的错误结果
    //   // 当该字段【函数】不存在是,默认如下:
    //   app.coreLogger.error(`[egg-axios-plus] receive response error, ${error.message}`);
    //   return Promise.reject(error);
    // },
    timeout: 5000, // 默认请求超时
    app: true, // 在app.js上启动加载
    agent: false, // 在agent.js上启动加载
};

if you want to use axios in agent or app , you can set config about agent or app ,make them be ture

exports.axiosPlus={
    app:true,
    agent:true
}

see config/config.default.js for more detail default config.

Support Request

Type Support
GET
DELETE
HEAD
OPTIONS
PUT
POST
PATCH

Example

If you want to learn about learning the plug-in of egg-axios-plus, we strongly recommend that you learn the Axios and Eggjs framework. As the name implies, this plug-in needs to be applied in the egg project. Let's start to write the sample code

// you can write request code by egg-axios-plus in controller.js or service.js

// supprt get
this.ctx.axios.get("request url",{parameters object}).then(callbackData=>{
    //gain this data is only remote server response data by callback method
    console.log(callbackData);
    // add code to deal with the data from get request
}).catch(err=>{
    // If there is an error in the request,it will be caught here
    console.log(err)
})

// support post
this.ctx.axios.post("request url",{parameters object}).then(callbackData=>{
    console.log(callbackData);
}).catch(err=>{
    console.log(err)
})
// support put,delete and other common type  request ,just write like uper code; 

If you don't want to use the callback function to get the result of the request in the code process, egg-axios-plus can also support the way to synchronously get the request with async/await . But keep vigilant that the parent method that used axios must be async

try{
    const responseData=await this.ctx.axios.get('request url',{parameters object});
    // add code to operate data with await 
    console.log(responseData);
}catch(err=>{
	console.log(err);
})

API

Requests can be made by passing the relevant config to axios.

axios(config)

// Send a POST request
this.ctx.axios({  
    method: 'post',  
    url: '/user/12345',  
    data: {    
        firstName: 'Fred',    
        lastName: 'Flintstone' 
    }
});
// GET request for remote image
this.ctx.axios({  
    method: 'get',  
    url: 'http://bit.ly/2mTM3nY',  
    responseType: 'stream'
}).then(response=> { 
    console.log(response);
});

Request method aliases

For convenience aliases have been provided for all supported request methods.

  • this.ctx.axios.request(config)

  • this.ctx.axios.get(url[, config])

  • this.ctx.axios.delete(url[, config])

  • this.ctx.axios.head(url[, config])

  • this.ctx.axios.options(url[, config])

  • this.ctx.axios.post(url[, data[, config]])

  • this.ctx.axios.put(url[, data[, config]])

  • this.ctx.axios.patch(url[, data[, config]])

NOTE

When using the alias methods url, method, and data properties don't need to be specified in config.

Config Defaults

You can specify config defaults that will be applied to every request.

Global axios defaults

const axios=this.ctx.axios;
axios.defaults.baseURL = 'https://api.example.com';
axios.defaults.headers.common['Authorization'] = AUTH_TOKEN;
axios.defaults.headers.post['Content-Type'] = 'application/x-www-form-urlencoded';

Custom instance defaults

// Set config defaults when creating the instance
const instance = axios.create({  
    baseURL: 'https://api.example.com'
}); 
// Alter defaults after instance has been created
instance.defaults.headers.common['Authorization'] = AUTH_TOKEN;

Config order of precedence

Config will be merged with an order of precedence. The order is library defaults found in lib/defaults.js, then defaults property of the instance, and finally config argument for the request. The latter will take precedence over the former. Here's an example.

// Create an instance using the config defaults provided by the library
// At this point the timeout config value is `0` as is the default for the library
const instance = axios.create(); 
// Override timeout default for the library
// Now all requests using this instance will wait 2.5 seconds before timing out
instance.defaults.timeout = 2500; 
// Override timeout for this request as it's known to take a long time
instance.get('/longRequest', {  
    timeout: 5000
});

more example please visit https://github.com/axios/axios or contact with Taylor

Questions & Suggestions

Please open an issue here.

Links

egg-axios-plus中文使用手册

Axios中文说明

egg-axios-plus Demo

Author

Taylor

License

MIT

Comments ( 0 )

Sign in for post a comment

About

eggjs框架中单纯的用ctrl来请求http服务难免出现重复的代码,不利于开发效率的提高;axios多用于前端的http请求,egg-axios-plus实在axios插件的封装基础上完美兼容eggjs框架,满足常用的Get、Post、Delete、Put等请求; spread retract
Cancel

Releases

No release

Gitee Metrics

Contributors

All

Activities

load more
can not load any more
JavaScript
1
https://git.oschina.net/mmdapl/egg-axios-plus.git
git@git.oschina.net:mmdapl/egg-axios-plus.git
mmdapl
egg-axios-plus
egg-axios-plus
master

Search