Angular2のサービスの概要、サービスを使ったサンプル作成

Angular2のサービスの概要、サービス使用時に関係するDI(Dependency Injection)、プロバイダ、インジェクタについてまとめ、サービスを使ったサンプルコードを作成しました。
※Angular2の2.0.0版、TypeScriptを使って確認したものです。

(1)サービス、DI、プロバイダ、インジェクタの関係


 
1)DI(Dependency Injection)
 
・DIは、サービスなど依存する対象を指定して、クラスの新しいインスタンスを提供する方法。依存する対象の大半はサービス。
 
2)プロバイダをインジェクタに登録
 
・利用するサービスは、事前にサービスのプロバイダをインジェクタに登録しなければならない。
 
・インジェクタは、プロバイダを使って新しいサービスインスタンスを生成することができる。
 
プロバイダは、サービスを生成またはリターンできる。サービスを生成するレシピ。サービスのクラスそれ自身の場合もある。
 
①プロバイダをrootに登録する方法
 
・アプリケーション開始時にプロバイダをインジェクタに登録すると、そのサービスの同一のインスタンスをアプリ全体から利用する事ができる。
 
・@NgModuleのproviders属性で指定する。
例)

@NgModule({
  imports: [
    BrowserModule
  ],
  declarations: [
    AppComponent
  ],
  providers: [ BackendService, HeroService, Logger ],
  bootstrap: [ AppComponent ]
})
export class AppModule { }

②コンポーネントレベルで登録する方法
 
・そのコンポーネントの新しいインスタンス毎にサービスの新しいインスタンスが取得される。
 
・@Componentデコレーターの”providers”属性で配列で指定する。
 
例)
@Component({
 providers: [HeroService]
})
export class HeroesComponent { … }
 

(2)コンポーネントからサービスを利用


 
コンポーネントがどのサービスを必要とするかをコンストラクタパラメータとしてサービスを指定する事によって行うことができる。
 
例)
constructor(private _service: HeroService){ }
 
●コンポーネントからサービスを利用する方法の例
 
例)ファイル名”hero.service.ts”の以下のサービスを使用する場合
export class HeroService {
・・・
 getHeroes() {
  return this.heroes;
 }
}
①サービスファイルをインポート
import {HeroService} from ‘./hero.service.ts’;
 
②DIでサービスを指定
@NgModule({
 :
 providers: [HeroService]
})
又は
@Component({
 providers: [HeroService]
})
 
③コンストラクタでサービスからデータを取得
constructor(heroService: HeroService) {
 this.heroes = heroService.getHeroes();
}
 

(3)サービス内で他の別のサービスを利用


 
・@Injectable()を記述する。
 
TypeScriptは、デコレーターを持つクラスのみメタデータを生成するので@Injectable()のデコレーターを記述する。
 
TypeScriptのコンパイラがこのクラスを評価するとき、デコレーターがあるとクラスメタデータを生成するJavaScriptコードに追加する。
 
・コンポーネントから依存するサービスを使用する場合は@Injectable()を記述していないが、これはすでに@Componentのデコレーターを記述しているので必要ない。
 
※オンラインガイドを見ると、記述漏れや一貫性のため、他のサービスを使用するしないに関わらず、@Injectable()を記述されている模様。
 
例)上記例の”HeroService”からlogger.tsファイルのLoggerサービスを利用する場合

export class Logger {
  log(msg) {
    console.log(msg);
  }
}

 

import {Injectable} from '@angular/core';
import {Logger} from './logger.ts';

@Injectable()
export class HeroService {
  constructor(private _logger: Logger) {
・・・・
  }
  getHeroes() {
    this._logger.log('Getting heroes ...')
・・・・
  }
}

 

(4)デモ


 
以下の記事のサンプルコードをサービスを使う形に修正したものです。
Angular2でinputs、@Inputを使ってディレクティブ間で値を受け渡し
 
上記サンプルでは複数のコンポーネント間でログ記録をやり取りしていたので、二つのタブのコンポーネント間でログが共有されず、各コンポーネント毎にログを記録していました。
 
サービスを使ってログ記録する事によって二つのコンポーネントでログ記録を共有するようにしています。
 
Angular : 2.0.0
Bootstrap : 3.2.0

Loading…

<html>
  <head>
    <title>Angular 2 Demo</title>
    <script src="https://npmcdn.com/core-js/client/shim.min.js"></script>
    <script src="https://npmcdn.com/zone.js@0.6.23?main=browser"></script>
    <script src="https://npmcdn.com/reflect-metadata@0.1.3"></script>
    <script src="https://npmcdn.com/systemjs@0.19.27/dist/system.src.js"></script>
    <script src="./js/systemjs.config.js"></script>
    <script>
      System.import('./ts/app.ts').catch(function(err){ console.error(err);  });    </script>
    <link rel="stylesheet" href="./css/bootstrap.min.css">
    <link rel="stylesheet" href="./css/styles.css">
  </head>
  <body>
    <div class="container">
      <my-app>Loading...</my-app>
    </div>
  </body>
</html>

(systemjs.config.js)
(function(global) {

  var ngVer = '@2.0.0';
  var routerVer = '@3.0.0';
  var formsVer = '@2.0.0';
  var routerDeprecatedVer = '@2.0.0-rc.2';
  var map = {
    'app':                        'app',
    '@angular':                   'https://npmcdn.com/@angular',
    '@angular/router':            'https://npmcdn.com/@angular/router' + routerVer,
    '@angular/forms':             'https://npmcdn.com/@angular/forms' + formsVer,
    '@angular/router-deprecated': 'https://npmcdn.com/@angular/router-deprecated' + routerDeprecatedVer,
    'angular2-in-memory-web-api': 'https://npmcdn.com/angular2-in-memory-web-api',
    'rxjs':                       'https://npmcdn.com/rxjs@5.0.0-beta.12',
    'ts':                         'https://npmcdn.com/plugin-typescript@4.0.10/lib/plugin.js',
    'typescript':                 'https://npmcdn.com/typescript@1.9.0-dev.20160409/lib/typescript.js',
 };
  var packages = {
    'app':                        { main: 'main.ts',  defaultExtension: 'ts' },
    'rxjs':                       { defaultExtension: 'js' },
    'angular2-in-memory-web-api': { main: 'index.js', defaultExtension: 'js' },
  };

  var ngPackageNames = [
    'common',
    'compiler',
    'core',
    'http',
    'platform-browser',
    'platform-browser-dynamic',
    'upgrade',
  ];
  ngPackageNames.forEach(function(pkgName) {
    map['@angular/'+pkgName] = 'https://npmcdn.com/@angular/' + pkgName + ngVer;
  });
  ngPackageNames.concat(['forms', 'router', 'router-deprecated']).forEach(function(pkgName) {
    packages['@angular/'+pkgName] = { main: '/bundles/' + pkgName + '.umd.js', defaultExtension: 'js' };
  });

  var config = {
    transpiler: 'ts',
    meta: {
      'typescript': {
        "exports": "ts"
      }
    },
    map: map,
    packages: packages
  };

  System.config(config);

})(this);

(メインコンポーネント)
  import { platformBrowserDynamic } from '@angular/platform-browser-dynamic'; import { NgModule } from '@angular/core'; import { BrowserModule } from '@angular/platform-browser'; import { Component,Input } from '@angular/core'; import { LogService } from './log.service.ts'; @Component({ selector: 'my-sub', template: ` <h4>{{sub_name}}</h4> <ul> <li *ngFor="let item of logs"> {{item.id}}=>{{item.msg}} </li> </ul> <button (click)="addlog(sub_name + 'のテストログ')">ログ記録</button> `, inputs: ['sub_name'], }) class MySub { public sub_name: string; public log: {id: number; msg: string;}; public logs: log[] = []; constructor(private _logService: LogService) { this.logs = _logService.listlogs(); }; addlog(msg: string) { this._logService.addlog(msg); }; } @Component({ selector: 'my-app', template: ` <button (click)="open('Sub-A')">Sub-A</button> <button (click)="open('Sub-B')">Sub-B</button> <div [ngSwitch]="tab"> <div *ngSwitchCase="'Sub-A'"> <my-sub [sub_name]="'Sub-A'"></my-sub> </div> <div *ngSwitchCase="'Sub-B'"> <my-sub [sub_name]="'Sub-B'"></my-sub> </div> </div> `, directives: [MySub] }) export class AppComponent { public tab = 'Sub-A'; open(tab: string) { this.tab = tab; } } @NgModule({ imports: [ BrowserModule ], declarations: [ AppComponent, MySub ], providers: [ LogService ], bootstrap: [ AppComponent ] }) export class AppModule { } platformBrowserDynamic().bootstrapModule(AppModule); (log.service.ts)
import {Injectable} from '@angular/core'; @Injectable() export class LogService { private _log: {id: number; msg: string;}; private _logs: log[] = []; private _logCount: number = 0; constructor() { this._logs[0] = {"id": 0, "msg": '初期値'}; } listlogs() { return this._logs; } addlog(msg: string) { this._logs.push({ id: ++this._logCount, msg: msg }); }; }

関連記事の目次

コメントを残す

メールアドレスが公開されることはありません。 * が付いている欄は必須項目です