后端Web框架【免费下载链接】dropwizardA damn simple library for building production-ready RESTful web services.项目地址https://gitcode.com/gh_mirrors/dr/dropwizard点击查看免费下载本指南围绕 Dropwizard 开箱即用的依赖注入DI机制展开以官方手册 docs/source/manual/di.rst 为骨架结合仓库源码讲清如何用配置驱动 DI、如何用 CDI 注解消费依赖、如何在测试中替换依赖。读完你将掌握一套可复制的实战方案定义DependencyInjectionConfiguration接口、编写DependencyInjectionBundle注册 HK2 绑定以及通过继承配置类注入 Mock 完成单元/集成测试。开箱即用的 DI为什么底层是 Eclipse HK2Dropwizard 官方开箱即用的依赖注入底层库是Eclipse 的 HK2——一个兼容 CDIContexts and Dependency InjectionJakarta 上下文与依赖注入规范的依赖注入框架。也就是说你不需要引入任何额外的 DI 容器Dropwizard 的 Jersey 环境天然就带有 HK2 的注入能力。从仓库源码可以印证这一点Environment在构造时创建DropwizardResourceConfigJersey 的ResourceConfig子类而 Dropwizard 依赖的 Jersey 运行时内部即由 HK2 驱动。例如 DropwizardResourceConfig.java 的构造函数里就通过AbstractBinder注册了一批内置绑定其中MetricRegistryBinder就是标准的 HK2 绑定static final class MetricRegistryBinder extends AbstractBinder { private final MetricRegistry metricRegistry; Override protected void configure() { bind(metricRegistry).to(MetricRegistry.class); } }这说明用AbstractBinder把实例/类型绑定到 HK2正是 Dropwizard 自身的标准做法下文的自定义 DI 方案与之完全同构。若需要更高级的 DI 能力如模块化组装、AOP 拦截等官方手册推荐使用第三方dropwizard-guicey提供的 Guice bundle 来扩展但本指南聚焦于内建的 HK2 方案它已覆盖绝大多数 RESTful 服务的注入需求。第一步用 Configuration 表达 DI 需求官方推荐的做法是把 DI 的声明放进应用配置对象而不是散落在代码各处。这样做的最大好处是测试时可以通过继承配置类覆盖 DI 绑定实现可注入 Mock的目标。首先定义一个接口作为 DI 配置的契约public interface DependencyInjectionConfiguration { ListClass? getSingletons(); ListNamedProperty? extends Object getNamedProperties(); }getSingletons()返回需要以单例形式绑定的类列表getNamedProperties()返回一批命名属性——即按名字id绑定到指定类型clazz的实例value。NamedPropertyT是一个泛型值对象三个字段分别描述属性名、属性值、属性类型并通过 Jackson 注解支持从配置反序列化public class NamedPropertyT { private final String id; private final T value; private final ClassT clazz; JsonCreator public NamedProperty(JsonProperty(id) String id, JsonProperty(value) T value, JsonProperty(clazz) ClassT clazz) { this.id id; this.value value; this.clazz clazz; } public String getId() { return id; } public T getValue() { return value; } public ClassT getClazz() { return clazz; } }注意JsonCreator与JsonProperty的组合如果将来把 DI 声明放进 YAML 配置文件Dropwizard 的 Jackson 就能直接反序列化出NamedProperty列表。ClassT字段的序列化/反序列化由 Jackson 的类型系统支持值为类的完全限定名。接着让你的应用配置类实现该接口。以手册中的ExampleConfiguration为例它继承 Dropwizard 的ConfigurationYAML 配置对象基类见 Configuration.java并声明要绑定的单例与命名属性public class ExampleConfiguration extends Configuration implements DependencyInjectionConfiguration { protected Class? getUserRepository() { return UserRepository.class; } Override public ListClass? getSingletons() { final ListClass? result new ArrayList(); result.add(getUserRepository()); result.add(UserResource.class); return result; } Override public ListNamedProperty? extends Object getNamedProperties() { final ListNamedProperty? extends Object result new ArrayList(); result.add(new NamedProperty(dbUser, dummy_db_user, String.class)); return result; } }这里有两个值得注意的设计getUserRepository()被声明为protected方法子类可以覆盖它——这正是测试替换的钩子后文详述getNamedProperties()返回的NamedProperty(dbUser, dummy_db_user, String.class)语义是把字符串dummy_db_user以名字dbUser绑定到String类型供Named(dbUser)注入点消费。第二步实现 ConfiguredBundle 注册 HK2 绑定DI 配置定义好了还需要一个搬运工把配置翻译成 HK2 绑定。实现一个ConfiguredBundleTpublic class DependencyInjectionBundle implements ConfiguredBundleDependencyInjectionConfiguration { Override public void run(DependencyInjectionConfiguration configuration, Environment environment) throws Exception { environment .jersey() .register( new AbstractBinder() { Override protected void configure() { for (Class? singletonClass : configuration.getSingletons()) { bindAsContract(singletonClass).in(Singleton.class); } for (NamedProperty? extends Object namedProperty : configuration.getNamedProperties()) { bind((Object) namedProperty.getValue()) .to((ClassObject) namedProperty.getClazz()) .named(namedProperty.getId()); } } } ); } }逐行解读这段关键代码ConfiguredBundleT是 Dropwizard 的扩展点接口定义于 ConfiguredBundle.javarun(T configuration, Environment environment)在应用启动时执行initialize(Bootstrap?)用于启动早期初始化。泛型参数限定了该 bundle 需要何种配置类型。environment.jersey()返回JerseyEnvironment见 Environment.java 与 JerseyEnvironment.java其register(Object)方法把组件注册进 Jersey/HK2 环境。bindAsContract(singletonClass).in(Singleton.class)把类本身作为契约注册并声明为单例作用域。这是 HK2 的按类绑定。bind(value).to(clazz).named(id)把具体实例按类型 限定名绑定供Named(id)注入点解析。这是 HK2 的按命名实例绑定。为什么register()能接受AbstractBinder看 DropwizardResourceConfig.java 的register(Object)实现它会判断组件类是否实现org.glassfish.hk2.utilities.Binder若是则直接交给 Jersey 注册绑定器否则动态生成一个SpecificBinder把实例绑定到其类型。仓库中 SessionFactoryProvider.java 的内嵌Binder也是同一模式public static class Binder extends AbstractBinder { Override protected void configure() { bind(SessionFactoryProvider.class).to(ValueParamProvider.class).in(Singleton.class); } }第三步在 Application 中装配 Bundle最后在应用的run方法里实例化并执行该 bundlerun方法签名与ConfiguredBundle.run一致Override public void run(ExampleConfiguration config, Environment environment) { final DependencyInjectionBundle dependencyInjectionBundle new DependencyInjectionBundle(); dependencyInjectionBundle.run(configuration, environment); }此时应用启动后HK2 环境中就存在以下绑定绑定目标作用域说明UserRepositorySingleton由getSingletons()声明UserResourceSingleton由getSingletons()声明String名字dbUser实例绑定值为dummy_db_user由getNamedProperties()声明这种用 bundle 消费配置的方式也符合 Dropwizard 的既有生态——例如 HelloWorldApplication.java 就是在run中通过environment.jersey().register(...)注册各类组件与过滤器。消费依赖在资源类中使用 CDI 注解绑定就绪后资源类就能用标准的 CDI 注解声明依赖。手册给出了UserResource与UserRepository的完整示例Singleton public class UserResource { private final UserRepository userRepository; Inject public UserResource(UserRepository userRepository) { this.userRepository userRepository; } } Singleton public class UserRepository { private final String dbUser; Inject public UserRepository(Named(dbUser) String dbUser) { this.dbUser dbUser; } }依赖注入链路清晰可见UserResource的构造器Inject要求注入一个UserRepositoryHK2 按类型解析到上一步bindAsContract(UserRepository.class)创建的 Singleton 实例UserRepository的构造器要求注入Named(dbUser)的StringHK2 按类型 限定名解析到bind(dummy_db_user).to(String.class).named(dbUser)绑定的实例两者都是 Singleton整个应用生命周期内只实例化一次且字段final、构造器注入天然线程安全。测试替换继承配置注入 Mock这套方案的精髓在于测试场景。只要配置对象支持覆盖就无需改动任何业务代码。手册的做法是让TestConfiguration继承ExampleConfiguration并覆盖getUserRepository()public class TestConfiguration extends ExampleConfiguration { Override protected Class? getUserRepository() { return MockUserRepository.class; } }由于getSingletons()内部调用的是getUserRepository()动态方法分派返回的绑定就变成了MockUserRepository而UserResource的注入点声明的是UserRepository类型——只要MockUserRepository extends UserRepositoryHK2 的按类型解析依然命中。随后用 JUnit 5 扩展 DropwizardAppExtension启动应用进行测试。DropwizardAppExtension位于 dropwizard-testing/src/main/java/io/dropwizard/testing/junit5/DropwizardAppExtension.java支持直接传入配置实例而非配置文件路径DisplayName(User endpoint) ExtendWith(DropwizardExtensionsSupport.class) public class UserControllerTests { public static final DropwizardAppExtensionTestConfiguration app new DropwizardAppExtension(ExampleApplication.class, new TestConfiguration()); }测试类初始化时DropwizardAppExtension会用TestConfiguration启动完整的应用随机端口因此测试中发起的 HTTP 请求会命中注入了 MockUserRepository的资源。结合 docs/source/manual/testing.rst 的测试方法论你可以把这种配置覆盖模式推广到任何需要替换依赖的场景——数据库访问层、外部 API 客户端、消息生产者等。注意事项Singleton 的作用范围手册末尾特别强调了一个易踩的坑Singleton注解只对 Dropwizard 资源Resource生效。对于自定义类不要忘记像上文那样用bindAsContract(singletonClass).in(Singleton.class)显式注册。原因在于Jersey 会扫描并管理资源类的作用域Singleton的资源类由 Jersey/HK2 按单例处理而自定义类如果不在getSingletons()中显式声明即使标注了Singleton也无法保证被 HK2 以单例契约注册可能造成多次实例化或注入失败。因此任何非资源类的单例依赖仓库、DAO、服务类等都应放进getSingletons()列表。扩展方向Guice 等高级 DI内建 HK2 方案解决了简单 DI的需求但如果你需要模块化绑定组装、基于注解的 AOP 拦截、按环境条件绑定等企业级能力官方手册推荐接入dropwizard-guiceyGuice bundle。它的接入方式与本文的ConfiguredBundle模式一脉相承通过Bootstrap.addBundle()注册、由配置驱动绑定、同样支持测试覆盖。选择哪种方案取决于复杂度轻量服务用 HK2 内建方案即可大型应用再考虑 Guice。总结Dropwizard 的 DI 能力可以总结为一条清晰的链路声明在Configuration子类中实现DependencyInjectionConfiguration接口输出单例类列表与命名属性列表绑定编写ConfiguredBundle在run()中通过environment.jersey().register(new AbstractBinder() {...})将配置翻译为 HK2 绑定bindAsContract().in(Singleton.class)与bind().to().named()装配在应用的run()方法中执行 bundle消费资源类用Inject、Named、Singleton等 CDI 注解声明依赖测试继承配置类覆盖受保护方法配合DropwizardAppExtension与DropwizardExtensionsSupport注入 Mock。整个过程零外部依赖、与 Dropwizard 内建机制同构且测试可替换性极强。相关源码与文档可在以下位置继续深入阅读手册原文docs/source/manual/di.rstBundle 扩展点ConfiguredBundle.java环境与注册入口Environment.java、JerseyEnvironment.javaBinder 识别与内置绑定示例DropwizardResourceConfig.java、SessionFactoryProvider.java测试扩展DropwizardAppExtension.java、docs/source/manual/testing.rst配置基类Configuration.java赞分享后端Web框架【免费下载链接】dropwizardA damn simple library for building production-ready RESTful web services.项目地址https://gitcode.com/gh_mirrors/dr/dropwizard点击查看免费下载相关推荐Dropwizard依赖注入终极指南HK2与Guice集成方案深度对比想要构建生产级的RESTful Web服务Dropwizard框架为你提供了完美的解决方案 作为一款简单强大的Java Web框架Dropwizard后端Web框架PowerToys终极指南15个免费工具彻底改变你的Windows使用体验PowerToys终极指南15个免费工具彻底改变你的Windows使用体验 PowerToys是微软官方推出的Windows系统增强工具集专为提升用户生产力桌面应用开发工具Angular依赖注入详解基于johnpapa/styleguide的DI实践Angular依赖注入详解基于johnpapa/styleguide的DI实践 在Angular开发中依赖注入Dependency Injection简上一篇Flue 迁移指南从 1.0.0-beta.9 升级到 Flue 2 的完整实战手册下一篇如何快速部署MiMo-VL-7B-RL-GGUF模型完整指南助你5分钟启动多模态AI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
