rebirth http

@ng-zorro/rebirth-http

Angular 用の Java JPA のような HTTP クライアント。

?インストール

$ npm install @ng-zorro/rebirth-http --save

?使用法

ステップ 1、 RebirthHttpModuleを登録する

 import { RebirthHttpModule } from '@ng-zorro/rebirth-http' ;

@ NgModule ( {
  imports : [ BrowserModule , RebirthHttpModule ] ,
  declarations : [ AppComponent ] ,
  bootstrap : [ AppComponent ] ,
} )
export class AppModule { }

ステップ 2、REST クライアントの作成

 import {
  Any ,
  RebirthHttpClient ,
  JSONP ,
  GET ,
  POST ,
  PUT ,
  DELETE ,
  PATCH ,
  BaseUrl ,
  Query ,
  Path ,
  Body ,
} from 'rebirth-http' ;
import { Observable } from 'rxjs/Observable' ;
import { HttpClient } from '@angular/common/http' ;

@ Injectable ( )
export class ArticleService extends RebirthHttpClient {
  constructor ( http : HttpClient ) {
    super ( http ) ;
  }

  @ GET ( 'article' )
  getArticles (
    @ Query ( 'pageIndex' ) pageIndex = 1 ,
    @ Query ( 'pageSize' ) pageSize = 10
  ) : Observable < SearchResult < Article > > {
    return Any ; // return Any as a placeholder
  }

  @ GET ( 'article/:id' )
  getArticleByUrl ( @ Path ( 'id' ) articleUrl : string ) : Observable < Article > {
    return Any ;
  }

  @ POST ( 'article' )
  createArticle ( @ Body article : Article ) : Observable {
    return Any ;
  }

  @ PUT ( 'article/:id' )
  updateArticle (
    @ Path ( 'id' ) id : string ,
    @ Body article : Article
  ) : Observable < Article > {
    return Any ;
  }

  @ DELETE ( 'article/:id' )
  deleteArticleById ( @ Path ( 'id' ) id : string ) : Observable < Article > {
    return Any ;
  }

  @ JSONP ( 'article/:id' )
  getArticleByJsonp (
    @ Path ( 'id' ) id : string ,
    @ Query ( 'name' ) name : string
  ) : Observable < Article > {
    return Any ;
  }

  @ POST ( 'file/upload' )
  upload ( @ Body formData : FormData ) : Observable < any > {
    return Any ;
  }
}

ステップ 3、 ArticleServiceを呼び出す

これで、 ArticleServiceのメソッドを呼び出して HTTP リクエストを発行できるようになりました。 :)

インターセプター

任意のRebirthHttpClientにインターセプターを追加できます。

 import { config } from '@/config' ;
import { RebirthHttpProvider } from '@ng-zorro/rebirth-http' ;

@ Component ( {
  selector : 'app-root' ,
} )
export class AppComponent {
  constructor ( rebirthHttpProvider : RebirthHttpProvider ) {
    rebirthHttpProvider . baseUrl ( config . api . host ) . addInterceptor ( {
      request : ( request ) =>
        console . log ( 'Global interceptors(request)' , request ) ,
      response : ( response ) =>
        console . log ( 'Global interceptors(response)' , response ) ,
    } ) ;
  }
} 

API

RebirthHttpClient

HTTP を担当するすべてのサービスはRebirthHttpClient継承する必要があります。

• getBaseUrl(): string : RebirthHttp クライアントのベース URL を返します。
• getDefaultHeaders(): { [name: string]: string } : RebirthHttp のデフォルトのヘッダーをキーと値のペアで返します。

クラスデコレータ

これらのデコレータは、 RebirthHttpClient継承するクラスで使用する必要があります。

• @BaseUrl(url: string) : RebirthHttpClient のベース URL を変更します
• @DefaultHeaders(headers: Object) : RebirthHttpClient のデフォルトのヘッダーを変更します

メソッドデコレータ

HTTP メソッド デコレータ

これらのデコレータはRebirthHttpClientのメソッドが HTTP リクエストを送信できるようにします。

• @GET(url: string)
• @POST(url: string)
• @PUT(url: string)
• @DELETE(url: string)
• @JSONP(url: string)
• @PATCH(url: string)
• @HEAD(url: string)
• @OPTIONS(url: String)

以下のデコレータを使用して HTTP オプションを変更できます。

• @Headers(headers: any)
• @RequestOptions(headers: any)
• @Extra(headers: any)

パラメータデコレータ

以下のデコレータを使用してRebirthHttpClientのメソッドのパラメータを装飾し、パラメータが対応する HTTP オプションになるようにします。

• @Path(key: string)
• @Query(key: string)
• @Header(key: string)
• @Body

クレジット

Paldom/angular2-rest が私たちにインスピレーションを与えてくれたことに感謝します。

☀️ライセンス

マサチューセッツ工科大学