Angular核心HTTP API详解 - 基于codecraft-tv/angular-course项目

前言

在现代Web开发中，与服务器进行HTTP通信是必不可少的功能。Angular提供了一个强大且易用的HTTP客户端模块，使开发者能够轻松实现各种HTTP请求。本文将深入讲解Angular中的核心HTTP API，帮助开发者掌握这一重要技能。

HTTP模块配置

依赖注入基础

Angular的HTTP客户端是一个可注入的服务，我们可以像这样在类中注入它：

class MyClass {
  constructor(private http: Http) {
  }
}

模块导入

要使用HTTP功能，我们需要从@angular/http模块导入相关类：

import { Http, Response, RequestOptions, Headers } from '@angular/http';

正确配置HttpModule

配置HTTP依赖的最佳方式是导入HttpModule并将其添加到NgModule的imports数组中：

import { HttpModule } from '@angular/http';

@NgModule({
  imports: [
    HttpModule
  ]
})

这种方式会自动配置所有必要的HTTP提供者，比单独配置每个提供者更加简洁高效。

HTTP请求实践

演示API与示例组件

我们将使用httpbin.org作为测试API，它提供了多种端点来测试不同的HTTP操作。示例组件包含一系列按钮，每个按钮触发不同的HTTP操作：

@Component({
  selector: 'app',
  template: `
    <div class="row">
      <div class="m-t-1">
        <button class="btn btn-primary" (click)="doGET()">GET</button>
        <button class="btn btn-primary" (click)="doPOST()">POST</button>
        <button class="btn btn-primary" (click)="doPUT()">PUT</button>
        <button class="btn btn-primary" (click)="doDELETE()">DELETE</button>
      </div>
    </div>
    <!-- 其他按钮省略 -->
  `
})

GET请求详解

GET是最常用的HTTP方法，用于从服务器获取数据：

doGET() {
  let url = `${this.apiRoot}/get`;
  this.http.get(url).subscribe(res => console.log(res.json()));
}

• res.json()将响应体解析为JSON对象
• res.text()获取原始响应文本

带查询参数的GET请求

我们可以使用URLSearchParams添加查询参数：

doGET() {
  let url = `${this.apiRoot}/get`;
  let search = new URLSearchParams();
  search.set('foo', 'moo');
  search.set('limit', 25);
  this.http.get(url, {search}).subscribe(res => console.log(res.json()));
}

POST请求

POST用于向服务器提交数据：

doPOST() {
  let url = `${this.apiRoot}/post`;
  this.http.post(url, {moo:"foo",goo:"loo"}).subscribe(res => console.log(res.json()));
}

PUT请求

PUT用于更新服务器上的资源：

doPUT() {
  let url = `${this.apiRoot}/put`;
  this.http.put(url, {moo:"foo",goo:"loo"}).subscribe(res => console.log(res.json()));
}

DELETE请求

DELETE用于删除服务器上的资源：

doDELETE() {
  let url = `${this.apiRoot}/delete`;
  this.http.delete(url).subscribe(res => console.log(res.json()));
}

高级特性

使用Promise替代Observable

虽然Angular的HTTP客户端默认返回Observable，但我们可以轻松转换为Promise：

import 'rxjs/add/operator/toPromise';

doGETAsPromise() {
  let url = `${this.apiRoot}/get`;
  this.http.get(url)
    .toPromise()
    .then(res => console.log(res.json()));
}

注意：需要显式导入toPromise操作符。

错误处理

无论是使用Observable还是Promise，都需要正确处理错误：

Promise错误处理

doGETAsPromiseError() {
  let url = `${this.apiRoot}/post`;
  this.http.get(url)
    .toPromise()
    .then(
      res => console.log(res.json()),
      msg => console.error(`Error: ${msg.status} ${msg.statusText}`)
    );
}

Observable错误处理

doGETAsObservableError() {
  let url = `${this.apiRoot}/post`;
  this.http.get(url).subscribe(
    res => console.log(res.json()),
    msg => console.error(`Error: ${msg.status} ${msg.statusText}`)
  );
}

自定义请求头

我们可以通过Headers和RequestOptions添加自定义请求头：

doGETWithHeaders() {
  let headers = new Headers();
  headers.append('Authorization', btoa('username:password'));
  let opts = new RequestOptions();
  opts.headers = headers;
  let url = `${this.apiRoot}/get`;
  this.http.get(url, opts).subscribe(
    res => console.log(res.json()),
    msg => console.error(`Error: ${msg.status} ${msg.statusText}`)
  );
}

最佳实践与注意事项

1. 模块化组织：始终在根模块中导入HttpModule，而不是在特性模块中重复导入
2. 错误处理：不要忽略错误处理，即使是简单的日志记录也很重要
3. 响应解析：根据响应内容类型选择json()或text()方法
4. 内存管理：对于长时间运行的Observable，记得取消订阅
5. 安全考虑：不要在客户端代码中硬编码敏感信息如认证凭据

总结

Angular的HTTP客户端提供了强大而灵活的功能来处理各种HTTP请求。通过本文的学习，你应该已经掌握了：

• 如何正确配置HTTP模块
• 各种HTTP方法(GET/POST/PUT/DELETE)的使用
• 如何添加查询参数和请求头
• 错误处理的最佳实践
• Observable和Promise之间的转换

这些知识将为你构建健壮的Angular应用打下坚实基础。在实际开发中，建议将这些HTTP调用封装到专门的Service中，以保持代码的组织性和可维护性。