cute http Download - cute http Quellcode-Download

cute http

Andere Kategorien

1.0.0

Herunterladen

süß-http

cute-http, eine niedliche http-Anforderungsbibliothek, einfach zu verwenden und einfach

Sie können die Anzahl der Wiederholungsversuche nach dem Anforderungszeitlimit festlegen
Für Get-Anfragen kann eine Cache-Richtlinie festgelegt werden
Cute hat den Cache optimiert, wenn die Abfrageparameter unverändert bleiben. Wenn es nicht abgerufen werden kann, wird es an das Backend gesendet, um es anzufordern Bei einer Änderung wird das vorherige zwischengespeicherte Ergebnis gelöscht und das nächste abgerufen. Der Client fordert neue Ergebnisse an, um zu verhindern, dass zu viele nutzlose Daten zwischengespeichert werden.
Sie können mehrere Get-Anfragen, mehrere Post-Anfragen, mehrere JSONP-Anfragen oder mehrere verschiedene Arten von Anfragen initiieren
Für parallele Anfragen verfügt Cute über zwei Strategien zur Ergebnisverarbeitung.
Standardmäßig wird das Ergebnis erst zurückgegeben, nachdem die Anforderung ausgeführt wurde. Selbst wenn bei einer der Anforderungen ein Fehler auftritt, hat dies keine Auswirkungen auf andere Anforderungen. Natürlich muss der Benutzer zu diesem Zeitpunkt die zurückgegebenen Ergebnisdaten durchlaufen davon kann ein Fehler sein. Benutzer können es auch so einstellen, dass bei der Initiierung mehrerer Anfragen alle fehlschlagen, solange in einer Anfrage ein Fehler auftritt.

Wie zu verwenden

Installieren Sie niedlich-http

 npm i cute-http --save

einführen

 import * as cute from 'cute-http';

API

Konstante

 const {ONE_ERROR_ABORT_ALL, KEEP_ALL_BEEN_EXECUTED, LOCAL_STORAGE, MEMORY} = cute.const;

ONE_ERROR_ABORT_ALL ein Fehler, alle Anfragen unterbrechen
KEEP_ALL_BEEN_EXECUTED Ein Fehler hat keine Auswirkungen auf andere Anfragen. Der Aufrufer muss den zurückgegebenen Fehler selbst behandeln.
LOCAL_STORAGE-Caches erhalten Rückgabeergebnisse in localStorage
MEMORY speichert das von get zurückgegebene Ergebnis im memory

setConfig

API der obersten Ebene, Parameter für niedlich konfigurieren

 cute setConfig({
  retryCount: number,//重试次数
  timeout: 1900,//超时时间（毫秒）
  debug:true,//打开debug模式
  // cacheType: MEMORY, // 默认无，如果开启了缓存，cute只针对get请求做缓存，如需穿透缓存，可以对query参数加随机值，或者调用cute.get时，配置第二个参数{cacheType:null}，表示针对这一次调用不读取缓存值
  // failStrategy: ONE_ERROR_ABORT_ALL, //不设置的话，cute默认采用KEEP_ALL_BEEN_EXECUTED
})

multi

 /**
 * 发起多个post请求
 * @param {Array<{type:'post', url:string, data:object} | {type:'get', url:string} | {type:'jsonp', url:string} >} items
 * @param {{failStrategy?:number, retryCount?:number, callbackParamName?:string, [otherAxiosConfigKey]:any}} extendedAxiosConfig
 * otherAxiosConfigKey @see https://github.com/axios/axios
 */
cute.multi(urls, extendedAxiosConfig)

erhalten

 // data 会被自动stringify拼接到url末尾
cute.get(url:string, data:string|object, extendedAxiosConfig:ExtendedAxiosConfig)

multiGet

 cute.multiGet(urls:string[] | {url:string, data:string|object}[], extendedAxiosConfig:ExtendedAxiosConfig)

Post

 cute.post(url:string, data:object, extendedAxiosConfig:ExtendedAxiosConfig)

multiPost

 cute.multiPost({url:string, data:object}[], extendedAxiosConfig:ExtendedAxiosConfig)

jsonp

 // data 会被自动stringify拼接到url末尾
cute.jsonp(url:string, data:string|object, extendedAxiosConfig:ExtendedAxiosConfig)

multiJsonp

 cute.multiJsonp(urls:string[] | {url:string, data:string|object}[], extendedAxiosConfig:ExtendedAxiosConfig)

Der folgende Code befindet sich in test/test-api.js. Benutzer können den Knoten ${your_test_dir}/test-api.js ausführen, um den Effekt zu sehen.

Natürlich können Sie bestimmte Codes auch auskommentieren und nur die Wirkung eines davon sehen

 const cute = require('../index');
const {ONE_ERROR_ABORT_ALL, KEEP_ALL_BEEN_EXECUTED, MEMORY} = cute.const;
const axios = cute.axios;//这个是axios模块的引用

cute.setConfig({
  retryCount: 3,//设置重试次数
  timeout: 1900,//设置超时时间
  debug: true,
  dataVerifyRule: {//设置通用的响应数据校验规则，只支持校验json对象的第一层key的值和类型的校验
    data: 'object',
    code: 'number',
    message: 'string',
  },
  pathDataVerifyRule:{//对某些请求设置独立的数据校验规则
    '/staff/foo':{
      reply:'object',
      msg:'string',
    }
  }
  cacheType: MEMORY, // 值为 'memory' | 'localStorage' 默认无
  failStrategy: KEEP_ALL_BEEN_EXECUTED, //不设置的话，cute默认采用ONE_ERROR_ABORT_ALL
})

const updateBook = 'http://localhost:8888/update-book';
const getBooksByUid = uid => `http://localhost:8888/get-books?uid=${uid}`;

async function main(){
  const result1 = await cute.get(getBooksByUid(1));
  const books = result.result1;

  const result2 = await cute.multiGet([getBooksByUid(1), getBooksByUid(2)]);
  const [reply1, reply2] = result2;

  const result3 = await cute.post(updateBook, {id:1, name:'zk'});
  const updateReply = result.result3;

  const result4 = await cute.multiPost([{url:updateBook, body:{id:1, name:'zk'}}, {url:updateBook, body:{id:2, name:'wow'}}]);
  const [updateReply1, updateReply2] = result4;

}