@36node/redux-api
A higher order component decorator for restful apis using Redux and React
Last updated a year ago by zzswang .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @36node/redux-api 
SYNC missed versions from official npm registry.

redux-api

version downloads

Redux-api is a library which can easily write client to communicate with backends. It generates actions and selectors for making ajax calls to API endpoint. Also, it use saga to change ajax state and save result in redux store with few config.

Use

Config reducer

Redux-api provide two reducers: Api reducer and Entities reducer;

Api reducer store api state: result, loading, request Entities reducer store entities of normalizr

// reducer.js
import { combineReducers } from "redux";

import entities from "./entity";
import { apiReducers } from "@36node/redux-api";

/**
 * apiReducers: {api: apiReducer, entities: entitiesReducer}
 * */
export default combineReducers({
  ...apiReducers,
});

Config saga

// saga.js
import { fork, all } from "redux-saga/effects";
import { watchApis } from "@36node/redux-api";

export default function* root() {
  yield all([fork(watchApis)]);
}

Write an endpoint function of an api

import fetch from "@36node/fetch";

// endpoint function param is request action payload
function listPetsEndpoint(req) {
  const { query, headers } = req;

  // also can user other ajax tools, should return a promise
  return fetch(`${some_url}/pets`, {
    method: "get",
    query,
    headers,
  });
}

Register api in actions

// actions.js
import { createApiAction } from "@36node/redux-api";

export const listPets = createApiActions("LIST_PETS", {
  // schema for normalizr
  schema: [petSchema],
  endpoint: listPetsEndpoint,
});

Dispatch action

import {listPets} from 'actions'

...

fetchPets = () => {
  // dispatch a request action
  this.props.dispatch(listPets.request({query: {limit: 10, offset: 0}}));
}

refreshPets = () => {
  // refresh action means repeat last request action
  this.props.dispatch(listPets.refresh());
}

clearPets = () => {
  // clear action means clear api state in store
  this.props.dispatch(listPets.clear());
}
...

Select api state

import React from "react";
import { connect } from "redux-react";
import { apiSelector } from "@36node/redux-api";

@connect(state => {
  const listPetsState = apiSelector("LIST_PETS")(state);

  return {
    loading: listPetsState.loading,
    pets: listPetsState.result || [],
  };
})
class SomeContainer extends React.Component {}

Current Tags

  • 0.3.17                                ...           latest (a year ago)

33 Versions

  • 0.3.17                                ...           a year ago
  • 0.3.16                                ...           a year ago
  • 0.3.15                                ...           a year ago
  • 0.3.14                                ...           a year ago
  • 0.3.13                                ...           a year ago
  • 0.3.12                                ...           a year ago
  • 0.3.11                                ...           a year ago
  • 0.3.10                                ...           a year ago
  • 0.3.9                                ...           a year ago
  • 0.3.8                                ...           a year ago
  • 0.3.7                                ...           a year ago
  • 0.3.6                                ...           a year ago
  • 0.3.5                                ...           a year ago
  • 0.3.4                                ...           a year ago
  • 0.3.3                                ...           a year ago
  • 0.3.2                                ...           a year ago
  • 0.3.1                                ...           a year ago
  • 0.3.0                                ...           a year ago
  • 0.2.4                                ...           a year ago
  • 0.2.3                                ...           a year ago
  • 0.2.2                                ...           a year ago
  • 0.2.1                                ...           a year ago
  • 0.2.0                                ...           a year ago
  • 0.1.13                                ...           a year ago
  • 0.1.10                                ...           a year ago
  • 0.1.9                                ...           a year ago
  • 0.1.7                                ...           a year ago
  • 0.1.6                                ...           a year ago
  • 0.1.4                                ...           a year ago
  • 0.1.3                                ...           a year ago
  • 0.1.2                                ...           a year ago
  • 0.1.1                                ...           a year ago
  • 0.1.0                                ...           a year ago
Downloads
Today 0
This Week 33
This Month 33
Last Day 0
Last Week 0
Last Month 98
Dependencies (3)
Dev Dependencies (9)

Copyright 2014 - 2016 © taobao.org |