التوثيق الرسمي لأنجولار يقول بأنه لا يجب على المكونات (Components) جلب البيانات أو حفظها بشكل مباشر، بل من المفترض أن يتم تفويض هذه المهمة للخدمات (Services) لكي نركز في المكونات فقط على تقديم وعرض هذه البيانات للمستخدم.
في هذا الدرس سنقوم بتطبيق هذه الفكرة عن طريق جلب بيانات وهمية (fake data) من خادم بعيد (Remote server) وإظهارها في الصفحة الرئيسية لتطبيقنا.
سنقوم باستخدام واجهة JSONPlaceholder لهذا الغرض. من خلال النقطة posts/ نستطيع جلب عدد من المقالات الوهمية، كل مقال يكون على الشكل التالي :
{ "userId": 1, "id": 1, "title": "Sunt aut facere repellat", "body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam." }
1
2
3
4
5
6

{
"userId": 1,
"id": 1,
"title": "Sunt aut facere repellat",
"body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam."
}



نحن سنعرض فقط العنون title، ففي النهاية غرضنا الوحيد هو أن نتعلم كيف نقوم باستخدام Services لجلب البيانات وتقديمها للمكونات.
إنشاء مشروع جديد

لنقم أولا بإنشاء مشروع جديد بواسطة Angular CLI من خلال تنفيذ هذا الأمر على Terminal :
ng new angular-services
1

ng new angular-services



angular-services هو اسم المشروع ويمكنك طبعا اختيار الإسم الذي تريده.
بعد إنتهاء إعداد المشروع، سنقوم بالدخول إلى المجلد angular-services عن طريق الأمر :
cd angular-services
1

cd angular-services



بعد ذلك نقوم بتنفيذ الأمر ng serve –watch حتى يمكننا فتح المشروع على المتصفح من خلال الرابط : http://localhost:4200.
ستظهر الصفحة الرئيسية الإفتراضية، وسنقوم فيما بعد بالتعديل عليها.
إنشاء الخدمة PostService

سنقوم بإنشاء الخدمة PostService عن طريق نافذة الأوامر السطرية :
ng generate service post
1

ng generate service post



هذا الأمر سيقوم بإنشاء ملفين :

• post.service.ts : وهو الملف الذي يحتوي على الكلاس PostService.
• post.service.spec.ts : الملف الذي نضع فيه الإختبارات التي نريد إجراءها للخدمة PostService. هذا الملف لن نركز عليه في هذا الدرس.

محتوى الملف post.service.ts سيكون شئيا من هذا القبيل :
import { Injectable } from '@angular/core'; @Injectable() export class PostService { constructor() { } }
1
2
3
4
5
6
7
8

import { Injectable } from '@angular/core';

@Injectable()
export class PostService {

constructor() { }

}



نلاحظ أن الكلاس PostService مسبوقة بالمصمم injectable@، هذا ضروري في تطبيقات أنجولار.
جلب البيانات بواسطة Ajax

1. إعداد الملف app.module.ts

لجلب البيانات باستخدام تقنية Ajax يلزمنا اضافة وحدة جديدة للمشروع إسمها HttpClientModule وذلك من الملف app.module.ts. بعد استيراد الوحدة HttpClientModule لا يجب أن ننسى إضافتها إلى المصفوفة imports في المصمم NgModule@ :
import { BrowserModule } from '@angular/platform-browser'; import { NgModule } from '@angular/core'; import { HttpClientModule } from '@angular/common/http'; import { AppComponent } from './app.component'; @NgModule({ declarations: [ AppComponent ], imports: [ BrowserModule, HttpClientModule ], providers: [], bootstrap: [AppComponent] }) export class AppModule { }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { HttpClientModule } from '@angular/common/http';


import { AppComponent } from './app.component';


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



2. إعداد الملف post.service.ts

بعد ذلك سنعود إلى PostService ونقوم باستيراد الكائن HttpClient. هذا الأخير هو الذي يستخدم للقيام بطلبات أجاكس في إطار العمل أنجولار.
أولا سنقوم بحقنه (Inject) داخل Constructor الخاص بالكلاس PostService، ثم نقوم باستخدامه داخل الدالة fetchPosts التي سنقوم بإنشائها، بحيث تكون مهمتها الوحيدة هي جلب المقالات من الواجهة البرمجية REST API.
import { Injectable } from '@angular/core'; import { HttpClient } from '@angular/common/http'; @Injectable() export class PostService { constructor(private HttpClient:HttpClient) { } fetchPosts(){ return this.HttpClient.get("https://jsonplaceholder.typicode.com/posts"); } }
1
2
3
4
5
6
7
8
9
10
11
12
13
14

import { Injectable } from '@angular/core';
import { HttpClient } from '@angular/common/http';


@Injectable()
export class PostService {


constructor(private HttpClient:HttpClient) { }

fetchPosts(){
return this.HttpClient.get("https://jsonplaceholder.typicode.com/posts");
}
}



2. إعداد الملف app.component.ts

الملف app.component.ts سبق إنشاؤه من قبل Angular CLI عندما قمنا بتوليد المشروع، وفيه يوجد الكلاس AppComponent المسؤول عن المكون الرئيسي للتطبيق.

1. أولا لكي يتمكن هذا المكون من الإستعانة بالخدمة PostService يجب أن نضيف هذه الأخيرة إلى المصفوفة providers الموجودة بداخل المصمم component@ الخاص بالكلاس AppComponent، هذا طبعا بعد استيراد (import) الكلاس PostService.
2. ثانيا سنقوم بحقن الخدمة في بَنَّاءِ (Constructor) الكلاس AppComponent.
3. ثالثا سننشئ خاصية بداخل AppComponent اسمها posts. هذه الخاصية سنستخدمها لإستقبال مصفوفة المقالات القادمة من الواجهة البرمجية.
4. رابعا سنقوم بإنشاء دالة جديدة اسمها getPosts وبداخلها سنطلب من الخدمة PostService أن تقوم بجلب البيانات من الواجهة البرمجية REST API. سننتظر وصول البيانات بداخل الدالة subscribe لنقوم باستقبالها في المصفوفة this.posts.
5. خامسا، يجب أن نقوم باستدعاء الدالة getPosts حالما يتم عرض المكون AppComponent على المتصفح. أفضل مكان لفعل ذلك هو في الدالة ngOnInit. هذه الأخيرة لا تتوفر لتطبيق أنجولار إلا بعد استيراد الواجهة OnInit وجعل المكون يستخدمها بواسطة التعبير implements OnInit.

export class AppComponent implements OnInit { ... }
1
2
3

export class AppComponent implements OnInit {
...
}



ngOnInit هي جزء مما يسمى دورة حياة المكونات في أنجولار. والكود الذي نضعه بداخلها يتم تنفيذه بمجرد إنشاء وإعداد المكون.
ngOnInit هي المكان الأفضل للقيام بطلبات الأجاكس التي يحتجاها المكون في بداية حياته، ولا ينصح أبدا بالقيام بمثل هذه الأمور في Constructor.بعد إتمام كل هذه الخطوات، يفترض أن يكون شكل الملف app.component.ts على هذا النحو :
import { Component, OnInit } from '@angular/core'; import { PostService } from './post.service'; @Component({ selector: 'app-root', templateUrl: './app.component.html', styleUrls: ['./app.component.css'], providers : [PostService] }) export class AppComponent implements OnInit { public posts: any; constructor (private postService: PostService) { } ngOnInit() { this.getPosts(); } getPosts(){ this.postService.fetchPosts().subscribe(data => { this.posts = data; }); } }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

import { Component, OnInit } from '@angular/core';
import { PostService } from './post.service';

@Component({
selector: 'app-root',
templateUrl: './app.component.html',
styleUrls: ['./app.component.css'],
providers : [PostService]
})
export class AppComponent implements OnInit {
public posts: any;

constructor (private postService: PostService) {

}

ngOnInit() {
this.getPosts();
}

getPosts(){
this.postService.fetchPosts().subscribe(data => {

this.posts = data;

});
}
}



4. عرض البيانات في واجهة المستخدم

الآن لم يبقى لنا سوى عرض البيانات التي حصلنا عليها في واجهة المستخدم UI. وسيلتنا لذلك هي القالب app.component.html الخاص بالمكون AppComponent.
سنمسح كل الأكواد الإفتراضية الموجدة في هذا الملف ولنجعله فارغا. كل ما سنقوم بعرضه هو عناوين المقالات التي حصلنا عليها من الواجهة البرمجية، والتي كما تتذكرون استقبلناها في الخاصية posts.
<h2 *ngFor="let post of posts"> - {{post.title}} </h2>
1
2
3

<h2 *ngFor="let post of posts">
- {{post.title}}
</h2>



ترون بأننا استخدمنا الحلقة ngFor* التي يتيحها أنجولار من أجل قراءة المصفوفة posts وعرض العناوين داخل وسوم <h2>.
بعد تحديث المتصفح سنرى بأن عناوين المقالات معروضة وفق المتوقع.

تعلمنا معا من خلال هذا الدرس كيف نقوم بإنشاء الخدمات في إطار العمل Angular، ورأينا كيف نقوم بحقنها للمكونات لجلب البيانات التي تحتاجاها. هذه الخدمات تكرس مبدأ مهما في البرمجة، وهو مبدأ المسؤولية الواحدة Single Responsibility Principle، بحيث أن كل جزء من التطبيق مسؤول عن مهام محددة بدقة، وكلما تم توزيع المهام بشكل أفضل كلما كان الكود أكثر تنظيما وقابلية للفهم والقراءة والصيانة.