NG-RESTFUL-ARS

A restful http request lib based on decorator of typescript in Angular.

github page

Installation

npm i ng-restful-ars -S

Getting Started

The typescript version needs to support double question marks and optional chain proposals.

• The recommended version of typescript is over 3.7.5.

Usage

Please refer to the demo page.

1. First create a helper class(free class name e.g. RestfulHelper) to extend the RestfulClien, and then implement IRestfulClient interface.

import { RestfulClient } from 'ng-restful-ars';
import { Inject, Injector } from '@angular/core';
import { IRestfulClient } from 'ng-restful-ars';

export class RestfulHelper extends RestfulClient implements IRestfulClient {
  // Your helper should inject an Injector in constructor.
  constructor(@Inject(Injector) public injector: Injector) {
    super(injector);
  }
  // rootUrl is required
  rootUrl = "https://www.api.com";
  httpTimeout = 5000;
  header = {
    'Accept-Language': 'en-US',
  };
  
  // the callback function is required
  onHttpTimeout(error: any): void {}
  onHttpError(error: any, method: string, path: string, options: any): void {}
  onHttpRespond(res: any) {}
  onDefaultSuccessNotice(res: any) {}
}

After the above helper is created, the global configuration of the network request is basically completed.

2. Use the helper in your service. Extend the RestfulHelper and import the HTTP METHOD(POST PUT GET DELETE). And add them as a decorator of the request function.

import { Injectable, Injector } from '@angular/core';
import { RestfulHelper } from './restful-helper';
import { Resources, POST, CUSTOMED_RESOURCE, GET, DELETE, PUT } from 'ng-restful-ars';
import { ZorroRestfulHelper } from 'ng-restful-ars';

// @Resources('business')
@Resources(CUSTOMED_RESOURCE)
@Injectable({
  providedIn: 'root',
})
export class DemoService extends RestfulHelper {
  constructor(
    public injector: Injector
  ) {
    super(injector);
  }

  @POST('connect/token', {
    contentType: 'application/x-www-form-urlencoded;charset=UTF-8',
  })
  login_token(body: any): any {}

  @POST('api/app/user/agree')
  agreement(): any {}

  @POST('api/app/user/setAdmin')
  set_admin(body: any): any {}

  @GET('api/app/user/info')
  get_user_info(params: any): any {}

  @DELETE('/{id}')
  delete_business(requestParams: any): any {}

  @PUT('/user')
  edit_business_user(params: any, body: any): any {}
}

the functions with ng-restful-ars decorator must Declare a return of any.

3. Use the service.

this.demoService.agreement().subscribe(res => {
   // TODO 
});

Supported http request form

• post()
• post(body)
• post(param)
• get()
• get(param)
• get(singleCase)
• put(param)
• put(param, body)
• put(singleCase, body)
• put(body)
• delete(param)
• delete(singleCase)

Notice: The singleCase means that the singleton parameter is placed in the URL in the requested address. E.g.

@GET('api/app/user/{id}') 
get_user_info(singleCase: string): any {}

The param of get_user_info() singleCase will be filled in the {id};

Decorators

| NAME | PARAMS | DESC | | :------------- | :--------------------------------------- | ----------------------------------------------- | | @ Resources | businness: string | RestfulClientState | restful resource name or CUSTOMED_RESOURCE | | @ CacheRequest | requestList: Array | the request method name list you want to cache. | | @POST | router: string, options: ResftulOptions | the post method | | @GET | router: string, options: ResftulOptions | the get method | | @PUT | router: string, options: ResftulOptions | the put method | | @DELETE | router: string, options: ResftulOptions | the delete method |

ResftulOptions

The RestfulOptions is the second param of http method decorators.

| NAME | TYPE | DESC | | ------------------------ | --------------------- | ------------------------------------------------------------ | | contentType | string | ContentType | the content-type attr in request header | | headers | Object | request header | | showDefaultSuccessNotice | boolean | whether to notify by default when the interface call is successful |

Callbacks

the interface IRestfulClient ss to constrain the helper created by the user. The principle is to use the reflection mechanism in the parent class to call the function of the subclass as a callback function.

| ATTR | METHOD | DESC | | ------------------------------------------------------------ | ------------------------------------------------------------ | | rootUrl: string; | the api url | | onHttpTimeout(error: any): void; | Called when the request times out. | | onHttpError(error: any, method: string, path: string, options: any): void; | Called when the server returns an error. | | onHttpRespond(res); | Called when the server response. | | onDefaultSuccessNotice(res); | When showDefaultSuccessNotice is set to true, the processing in the callback is executed. |