Satellizer依赖注入：AngularJS服务设计与解耦实践
项目地址: https://gitcode.com/gh_mirrors/sa/satellizer 在AngularJS应用开发中，依赖注入（Dependency Injection, DI）是实现代码解耦和模块化的核心机制。Satellizer作为Token-based认证解决方案，其架构设计充分利用了AngularJS的DI特性，通过分层服务设计实现了认证逻辑的高内聚低耦合。本文将从核心模块设计、依赖注入实践、解耦案例分析三个维度，剖析Satellizer如何通过DI提升代码可维护性和扩展性。
核心模块的依赖注入设计
Satellizer的认证功能通过多个独立服务协同实现，各服务间通过构造函数注入建立依赖关系，形成清晰的调用链。
认证服务的依赖树
AuthProvider作为核心服务，聚合了本地认证（SatellizerLocal）、OAuth认证（SatellizerOAuth）和共享工具（SatellizerShared）等依赖，通过$get方法暴露统一API。其依赖注入定义如下：
// [authProvider.ts](https://link.gitcode.com/i/5f88389182036ef0d886933add8f49b0)
AuthProvider.prototype.$get.$inject = ['SatellizerShared', 'SatellizerLocal', 'SatellizerOAuth'];
这种设计使AuthProvider专注于接口定义，将具体实现委托给注入的依赖服务，符合单一职责原则。
HTTP拦截器的依赖注入
认证令牌的自动附加逻辑由Interceptor服务实现，其构造函数注入了配置（SatellizerConfig）、共享工具（SatellizerShared）和存储服务（SatellizerStorage）：
// [interceptor.ts](https://link.gitcode.com/i/b3d8d9796c800c72698a8077c04c4332)
static $inject = ['SatellizerConfig', 'SatellizerShared', 'SatellizerStorage'];
通过DI获取配置参数和存储实例，Interceptor无需硬编码依赖，可灵活适配不同存储策略（如localStorage/sessionStorage）。
配置服务的注入与使用
Config服务作为全局配置中心，通过DI向各模块提供统一的参数访问接口，实现配置的集中管理。
配置注入示例
AuthProvider通过构造函数注入SatellizerConfig，实现对认证参数的访问和修改：
// [authProvider.ts](https://link.gitcode.com/i/9adc33c2b0d02c0b709ce55954254c41)
constructor(private SatellizerConfig: Config) {}
// 配置访问示例
get tokenName(): string { return this.SatellizerConfig.tokenName; }
set tokenName(value) { this.SatellizerConfig.tokenName = value; }
多环境配置实践
在应用初始化阶段，可通过$authProvider配置不同环境的参数。以下是客户端示例中配置OAuth提供商的代码：
// [app.js](https://link.gitcode.com/i/78f1b4d27eb99927644c86664f0dd521)
$authProvider.facebook({
clientId: '603122136500203'
});
通过DI注入的配置服务，应用可在不同环境（开发/生产）加载差异化配置，无需修改核心代码。
存储服务的抽象与注入
Storage服务封装了不同存储策略的实现细节，通过DI向其他模块提供统一的存储接口，实现存储逻辑的解耦。
存储服务实现
Storage服务支持localStorage、sessionStorage和内存存储，通过配置动态切换：
// [storage.ts](https://link.gitcode.com/i/31566cd9f705ad279d45734435575320)
get(key: string): string {
try {
return this.$window[this.SatellizerConfig.storageType].getItem(key);
} catch (e) {
return this.memoryStore[key]; // 降级到内存存储
}
}
存储服务注入使用
Interceptor通过注入SatellizerStorage实现令牌的获取：
// [interceptor.ts](https://link.gitcode.com/i/f4ca51c3396d70afa5dbc912af3727dd)
let token = this.SatellizerStorage.get(tokenName);
这种设计使存储实现与使用方完全解耦，更换存储策略时只需修改配置，无需调整依赖存储服务的代码。
应用层的依赖注入实践
客户端示例展示了如何在实际应用中通过DI使用Satellizer服务，构建完整的认证流程。
应用模块依赖声明
客户端应用模块声明依赖satellizer模块，使Satellizer服务可通过DI注入：
// [app.js](https://link.gitcode.com/i/f8c225f0db22c96a45fc64fbeb6c5b75)
angular.module('MyApp', ['ngResource', 'ngMessages', 'ngAnimate', 'toastr', 'ui.router', 'satellizer'])
控制器中的服务注入
Navbar控制器通过注入$auth服务实现认证状态判断：
<!-- [index.html](https://link.gitcode.com/i/ce655f7ac4cbdfb373623ba7cc021e57) -->
<li ng-if="isAuthenticated()"><a href="/#/profile">Profile</a></li>
对应的控制器实现：
// 控制器通过$auth服务判断认证状态
$scope.isAuthenticated = function() {
return $auth.isAuthenticated();
};
依赖注入的优势与最佳实践
Satellizer的DI设计带来多重收益，同时也形成了可复用的AngularJS服务设计模式。
DI带来的架构优势
- 代码解耦：通过接口依赖替代具体实现，如AuthProvider依赖抽象的SatellizerLocal而非具体实现
- 可测试性：支持依赖模拟，如测试AuthProvider时可注入MockSatellizerLocal
- 可扩展性：新增认证方式只需实现新的OAuth服务并注入AuthProvider
- 配置集中：通过Config服务统一管理参数，便于环境切换
服务设计最佳实践
- 最小知识原则：服务只依赖必要的最小集，如Interceptor仅依赖配置、共享工具和存储服务
- 接口稳定：依赖服务的接口应保持稳定，变更通过版本控制管理
- 注入注解：始终使用
$inject显式声明依赖，避免代码压缩导致的注入失败
图：Satellizer认证流程示意图（基于项目favicon图标创建的概念图）
总结
Satellizer通过系统化的依赖注入设计，构建了灵活可扩展的AngularJS认证框架。其核心在于：
- 分层服务设计：将认证逻辑拆分为配置、存储、拦截器等独立服务
- 依赖注入应用：通过构造函数注入和
$inject注解建立服务间依赖 - 接口抽象：定义清晰的服务接口，实现具体实现与使用方的解耦
这种架构使Satellizer能够适应不同的应用场景和扩展需求，同时保持代码的可维护性。开发者可借鉴其DI实践，提升AngularJS应用的模块化水平。
官方文档：README.md 核心服务源码：src/ 客户端示例：examples/client/
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
