后端【免费下载链接】guiceGuice (pronounced juice) is a lightweight dependency injection framework for Java 11 and above, brought to you by Google.项目地址https://gitcode.com/gh_mirrors/gui/guice点击查看免费下载本文以 Guice 仓库根目录 README.md 为主线系统解读 Google Guice 的核心设计理念、Inject注入模型、6.0.0 与 7.0.0 两个版本的 javax/jakarta 命名空间差异以及 Guice Core 与全部扩展模块的 Maven 安装方式并结合仓库源码如 Guice.java、Injector.java、AbstractModule.java与示例工程 guice-demo 展开实战讲解。读完本文你将能够独立完成 Guice 的依赖引入、版本选型、基础模块编写与扩展组件装配。一、Guice 是什么把new变成InjectREADME 的开篇用一句话概括了 Guice 的定位Guice alleviates the need for factories and the use of new in your Java code——它消除了 Java 代码中对工厂类和new关键字的直接依赖。README 进一步给出了一个口号式表述把 Guice 的Inject看作是 the new new。这并不意味着开发者完全不需要写工厂而是意味着即便仍然存在工厂业务代码也不再直接依赖它们。由此带来的直接收益是代码更容易变更、更容易做单元测试、更容易在其它上下文中复用。README 还阐述了 Guice 的几个核心设计原则这些原则与仓库源码一一对应拥抱 Java 的类型安全type safeGuice 被视为对核心 Java 缺失特性的补充类型安全贯穿整个绑定体系典型体现是KeyT与TypeLiteralT对泛型的完整保留。不搞大而全not a kitchen sinkREADME 明确写道 We justify each feature with at least three use cases. When in doubt, we leave it out即每个特性都要有至少三个使用场景才被纳入宁可缺失也不盲目堆砌同时框架提供通用扩展机制Binder、SPI、ModuleAnnotatedMethodScanner而非把所有功能塞进核心。让开发和调试更简单快速make development and debugging easier and fasterGuice 尽量避免惊喜与魔法并且goes the extra mile to generate helpful messages——在出错时生成尽可能有用的错误信息。仓库中的错误格式化与提示系统如 Errors.java、MissingImplementationErrorHints.java正是这一原则的实现。从源码结构看core/src/com/google/inject/目录整个核心库围绕 4 个层次组织层次代表类型职责启动门面Guice.java从Module集合创建Injector注入模型Inject、Provides、Provider声明依赖与提供实例绑定/装配Module.java、AbstractModule.java、Binder.java以 EDSL 方式配置绑定运行时核心Injector.java、Stage.java构建对象图、按需提供实例二、Inject注入点的三种形态README 提到的Inject在仓库中的权威定义位于 Inject.java。它标注构造器、方法与字段三类成员其 javadoc 明确定义了Injector需要执行注入的三类对象Injector 自己构造的每一个实例被构造的类必须有一个标注Inject的构造器或者有一个无参构造器随后 Injector 会继续执行字段注入与方法注入。预先构造好的实例通过Injector.injectMembers、LinkedBindingBuilder.toInstance(...)或toProvider(...)传入的实例此时所有构造器都被忽略只做字段与方法注入。静态字段与静态方法当Module通过Binder.requestStaticInjection明确请求静态注入时。值得注意的两个细节无论成员的访问修饰符是private、包私有、protected还是public都可以被注入对应源码注释 a member can be injected regardless of its Java access specifier。Inject支持optional() default false属性设为true时若找不到合适的绑定Injector 会跳过该字段/方法的注入而不是报错对字段而言已赋的默认值会保留对方法而言只有所有参数都有绑定时才会被调用但若标注在构造器上Injector 创建时依然会产生错误。在jakarta.inject体系中Inject等价于javax.inject.Inject二者均可与 Guice 的Provider体系互通——Provider.java 直接extends jakarta.inject.ProviderT这是 7.x 版本全面转向 jakarta 命名空间的关键证据。三、核心设计理念类型安全、少即是多、友好报错README 用一整段阐述了 Guice 的世界观值得开发者认真体会因为它直接影响了 API 的形态You might think of Guice as filling in missing features for core Java.—— 在 Java 语言原生支持依赖注入之前Guice 补上了这个缺口。Guice helps you design better APIs, and the Guice API itself sets a good example.—— Guice 不只是注入框架其自身 API 就是良好 API 设计的范例。Guice steers clear of surprises and magic.—— 代码在没有工具辅助的情况下也应可读工具只是让事情更容易。错误处理上不遗余力当错误发生时Guice 会尽力生成有帮助的信息。仓库core/test/com/google/inject/errors/下的大量黄金文件golden file测试如missing_implementation_errors.txt、multiple_binding_already_set_errors.txt、class_names_are_compressed_in_error_message.txt逐一锁定了各类配置错误的输出格式是友好报错原则的直接测试证据。四、版本选型6.0.0 与 7.0.0 的 javax / jakarta 分水岭README 的 Latest releases 部分给出当前两个稳定版本线这是安装前必须做出的第一个决定版本支持的命名空间说明6.0.0javax.{inject,servlet,persistence}对jakarta.inject为mostly supports大部分支持JEE/Jakarta 过渡版本兼容旧生态7.0.0jakarta.{inject,servlet,persistence}全面转向 Jakarta EE 命名空间两者关系——6.0.0 7.0.0 are equivalent except for their javax/jakarta support除命名空间差异外二者功能等价从仓库构建配置可以印证这一结论pom.xml 中guice.api.version为1.4说明自 2006 年立项以来公共 API 一直保持高度稳定guice.lastStableRelease7.0.0/guice.lastStableRelease表明 7.0.0 是当前基线版本。仓库根 pom.xml 的模块清单为bom、core、extensions说明发布物由 BOM依赖清单、核心库与扩展库三部分组成。core/pom.xml以及 pom.xml 中的 maven-compiler-plugin 配置release11/release明确构建目标为Java 11即 README 所述 Guice is a lightweight dependency injection framework for Java 11 and above 的落地配置。选型建议基于 README 与仓库状态的事实判断如果你正在使用或迁移到 Jakarta EE 9 生态Tomcat 10、Jetty 11 等基于 jakarta.servlet 的容器应选择 7.0.0如果你的代码仍依赖javax.inject、javax.servlet等旧 API则应选择 6.0.0。仓库的 OSGi 打包配置也体现了这一趋势——pom.xml 中Import-Package!com.google.inject.*,!javax.annotation,*/Import-Package与 extensions/pom.xml 中 struts2 模块被注释struts2 doesnt support jakarta.servlet yet都表明整个项目正全面向 jakarta 迁移。五、安装Guice Core 与扩展的 Maven 坐标5.1 Guice Core核心库README 给出的核心依赖声明如下{version}可填6.0.0、7.0.0等稳定版本dependency groupIdcom.google.inject/groupId artifactIdguice/artifactId !-- {version} can be 6.0.0, 7.0.0, etc. -- version{version}/version /dependency仓库中的真实用法示例examples/guice-demo/pom.xml 以 5.1.0 为例声明了同样的坐标并同时依赖测试扩展guice-testlib与 JUnit 4.13.2dependency groupIdcom.google.inject/groupId artifactIdguice/artifactId version${guice.version}/version /dependency5.2 Guice Extension扩展库README 给出扩展模块的通用声明方式dependency groupIdcom.google.inject.extensions/groupId !-- {extension-name} can be one of: assistedinject, dagger-adapter, grapher, jmx, jndi, persist, spring, testlib or throwingproviders -- artifactIdguice-{extension-name}/artifactId !-- {version} must match the guice core version. -- version{version}/version /dependency注意 README 强调的约束{version}must match the guice core version——扩展版本必须与核心版本完全一致。这一约束在仓库构建中被强制执行extensions/pom.xml 中所有扩展统一依赖com.google.inject:guice:${project.version}即与扩展本身同版本号。结合 extensions/pom.xml 的modules清单与 bom/pom.xml 的 artifactId 命名当前仓库实际存在的扩展及用途可归纳如下扩展名Maven artifactIdguice-前缀用途依据源码assistedinjectguice-assistedinject自动生成工厂接口实现将调用方参数与 Injector 提供的依赖结合构造对象见 FactoryModuleBuilder.javadagger-adapterguice-dagger-adapter让 Dagger 风格的注解Binds、Provides等可被 Guice 模块扫描使用grapherguice-grapher将 Injector 的依赖图渲染为 Graphviz 图jmxguice-jmxJMX 管理扩展jndiguice-jndiJNDI 资源注入见 JndiIntegration.javapersistguice-persistJPA 持久化单元与Transactional拦截器见 PersistModule.javaservletguice-servletServlet 容器集成与请求级作用域对应 pom 中jakarta.servlet-api5.0.0 依赖见 extensions/servlet/pom.xmlspringguice-spring与 Spring 框架互操作testlibguice-testlib测试辅助库如BoundFieldModule见 AppTest.javathrowingprovidersguice-throwingproviders允许 Provider 抛出受检异常的变体补充两点仓库事实struts2扩展在 extensions/pom.xml 与 bom/pom.xml 中均被注释排除原因是 struts2 doesnt support jakarta.servlet yet因此当前版本不随 Maven 发布。README 提到 See Maven Central for more details, including snippets for other build systems such as Gradle, Ivy, sbt——即除 Maven 外同样坐标适用于 Gradle、Ivy、sbt 等其它构建工具。5.3 使用 BOM 统一版本管理仓库 bom 模块提供guice-bom一次性声明核心与全部扩展的版本避免多依赖版本漂移dependencyManagement dependencies dependency groupIdcom.google.inject/groupId artifactIdguice-bom/artifactId version{version}/version typepom/type scopeimport/scope /dependency /dependencies /dependencyManagement引入 BOM 后各依赖即可省略version由 BOM 统一约束。六、从一个可运行的例子理解安装成果guice-demo仓库自带最小可运行示例 examples/guice-demo其入口 App.java 展示了依赖安装完成后最典型的用法——Guice.createInjector(modules).getInstance(App.class)public static void main(String[] args) { Printer consolePrinter new Printer() { /* 打印到控制台 */ }; App app Guice.createInjector( new MessageModule(), new AbstractModule() { Override protected void configure() { bind(Printer.class).toInstance(consolePrinter); } }) .getInstance(App.class); app.run(); }这个例子浓缩了四个关键 API 的用法逐一对应源码Guice.createInjector(Module...)入口门面见 Guice.java其 javadoc 给出的范式正是应用在main方法中创建 Injector然后getInstance取出启动器对象。AbstractModule继承它即可在configure()里用继承方法bind、install、bindConstant等配置绑定见 AbstractModule.java 的官方示例。注意Module.configure(Binder)是唯一的抽象方法Module接口本身被标注为FunctionalInterface见 Module.java。Provides方法在MessageModule中Provides Message String provideMessage()把方法返回值绑定到其返回类型配合自定义Qualifier注解见 Provides.java——The methods return type is bound to its returned value. Guice will pass dependencies to the method as parameters.Injector.getInstance等价于getProvider(type).get()见 Injector.java官方 javadoc 提醒when feasible, avoid using this method, in favor of having Guice inject your dependencies ahead of time即尽量依赖注入而非手动取实例。该示例的测试 AppTest.java 还示范了测试扩展guice-testlib的BoundFieldModule用法在测试类字段上用Bind声明绑定再Guice.createInjector(BoundFieldModule.of(this)).injectMembers(this)完成注入。6.1 安装与运行命令在 examples/guice-demo 目录下或任意已声明 Guice 依赖的 Maven 工程中mvn compile # 编译验证依赖解析成功 mvn test # 运行测试AppTest 会验证依赖注入链路 mvn exec:java # 运行 App.main需另配 exec 插件或直接 java -cp 运行依赖是否就绪的快速判断标准mvn dependency:tree输出中应出现com.google.inject:guice及所选的扩展且版本与核心一致。七、从 README 到实战理解 Injector 与 Binder 的核心能力README 只给出了整体介绍但要让安装的依赖真正跑起来还需要理解两个核心类型的能力边界它们都由源码直接定义7.1 Injector应用的对象图Injector.java 的 javadoc 明确Injector 构建构成应用程序的对象图跟踪每个类型的依赖并用绑定完成注入这是 DI 区别于 Service Locator 模式的根本所在。它还自带若干默认绑定该Injector实例本身每个类型T的绑定对应的ProviderT被注入类对应的java.util.logging.Logger创建 Injector 时的Stage。常用能力一览均来自 Injector.java方法作用getInstance(ClassT)/getInstance(KeyT)取得实例等价于getProvider(key).get()getProvider(ClassT)/getProvider(KeyT)取得延迟实例化入口可避免提前创建injectMembers(Object)对已构造对象执行字段/方法注入getBindings()/getAllBindings()获取显式绑定含 JIT 绑定的只读快照供 SPI 工具使用createChildInjector(Module...)创建子 Injector继承父级全部绑定、作用域、拦截器与类型转换器getParent()返回父 Injector其中createChildInjector与Binder.newPrivateBinder、PrivateModule构成分层注入体系官方 javadoc 特别提醒分层场景下可能需要显式bind(ServiceImpl.class)才能把绑定正确关联到当前 Injector否则 Guice 可能把绑定提升到祖先 Injector。7.2 Binder 的绑定 EDSLBinder.java 定义了完整的绑定 DSLjavadoc 中给出了官方示例系列这里提炼为速查表省略了binder前缀与继承AbstractModule的写法一致bind(ServiceImpl.class); // 自身绑定显式清单 bind(Service.class).to(ServiceImpl.class); // 链接绑定覆盖 ImplementedBy / ProvidedBy bind(Service.class).toProvider(ServiceProvider.class); // 绑定到 Provider 类 bind(Service.class).annotatedWith(Red.class).to(...); // 绑定注解限定 bind(ServiceImpl.class).in(Singleton.class); // 单例作用域 bind(new TypeLiteralPaymentServiceCreditCard() {}) .to(CreditCardPaymentService.class); // 参数化类型绑定 bind(Service.class).toInstance(new ServiceImpl()); // 绑定到已构造实例eager loading bindConstant().annotatedWith(Names.named(port)).to(8080); // 常量绑定 bind(Service.class) .annotatedWith(Names.named(blue)) .to(BlueService.class); // 命名绑定几个值得注意的语义细节均有源码依据作用域覆盖规则in(Singleton.class)会覆盖ServiceImpl类上注解声明的作用域a scope specified in this way overrides any scope that was specified with an annotation on the ServiceImpl class。常量绑定转换字符串常量可自动转换为所有基本类型、所有枚举Enum.valueOf与类字面量其它类型需通过convertToTypes(Matcher, TypeConverter)注册自定义转换。JIT 绑定未显式绑定的类型若存在可注入构造器或无参构造器Guice 会在首次请求时按需创建隐式绑定即 Just-In-Time bindinggetBinding的 javadoc 明确说明了这一行为。严格模式开关requireExplicitBindings()禁止隐式绑定、disableCircularProxies()禁止循环依赖代理、requireAtInjectOnConstructors()强制构造器必须标注Inject、requireExactBindingAnnotations()禁止模糊匹配绑定注解——这些方法在 Binder.java 中均有完整语义说明适合对隐式行为敏感的生产项目。7.3 Stage工具、开发与生产三种阶段Stage.java 定义了三个枚举值README 未展开但安装后立刻会遇到Guice.createInjector(Stage, Module...)的重载Stage行为定位TOOL运行在工具如 IDE 插件中只需要绑定元数据不做成员注入、不加载 eager singleton创建的 Injector 不能用于满足注入DEVELOPMENT追求快速启动牺牲部分运行时性能与前置错误检查Guice.createInjector(Module...)的默认值PRODUCTION尽可能提前捕获错误前置成本高、运行时性能好选择建议日常开发用默认的DEVELOPMENT发布前跑一次PRODUCTION可尽早暴露配置错误。八、扩展机制让框架按需生长README 强调 Guice builds general functionality which enables you to extend Guice rather than adding every feature to the core framework即通过通用扩展点让用户扩展框架而非在核心堆砌特性。从源码看核心的扩展点包括Binder.install(Module)组合子模块。注意Module接口 javadoc 强调不要直接调用configure(Binder)安装子模块而应使用install因为后者才能确保Provides等 provider 方法被扫描发现。TypeListener/ProvisionListener通过bindListener(...)注册分别在类型被发现时与对象被提供前后获得回调。TypeConverter通过convertToTypes(...)注册字符串到任意类型的转换。ModuleAnnotatedMethodScanner通过scanModulesForAnnotatedMethods(...)注册可让自定义注解像Provides一样被扫描并绑定dagger-adapter 扩展即基于此机制。bindScopeScope注册自定义作用域注解README 也提到 servlet 扩展提供ServletScopes等请求级作用域。这些扩展点在 Binder.java 中均有完整签名与语义说明是理解少即是多 可扩展设计的最佳入口。九、总结安装 Guice 前的最终核对清单回到 README 的核心内容安装与使用 Guice 的完整决策链是选版本Java 11 环境使用javax.*选6.0.0使用jakarta.*选7.0.0二者除命名空间外功能等价。引依赖核心用com.google.inject:guice:{version}扩展用com.google.inject.extensions:guice-{extension-name}:{version}且扩展版本必须与核心一致可借助guice-bom统一管理。写模块继承AbstractModule在configure()中使用绑定 EDSL或用Provides方法用install()组合子模块。启动在main方法中Guice.createInjector(modules)创建Injector随后getInstance(...)或让框架自动注入。按需强化生产环境用Stage.PRODUCTION提前暴露错误对隐式行为敏感时启用requireExplicitBindings()等严格选项复杂场景再按需引入 servlet、persist、assistedinject 等扩展。最后补充一个仓库事实guice-parent的当前 SNAPSHOT 版本为7.0.1-SNAPSHOT见 pom.xml说明 7.x 主线仍在持续演进而自 2006 年起 Guice 就被用于关键业务系统README 原话 Weve been running Guice in mission critical applications since 2006其 API 以guice.api.version 1.4保持了十余年的向后兼容。对于希望深入了解底层实现的读者推荐继续阅读仓库内的 InjectorImpl.java注入器核心实现与 BindingBuilder.java绑定 EDSL 实现以及 BinderTest.java、InjectorTest.java 等核心测试它们与本文所述语义一一对应。赞分享后端【免费下载链接】guiceGuice (pronounced juice) is a lightweight dependency injection framework for Java 11 and above, brought to you by Google.项目地址https://gitcode.com/gh_mirrors/gui/guice点击查看免费下载相关推荐深入理解Google Guice轻量级Java依赖注入框架入门指南深入理解Google Guice轻量级Java依赖注入框架入门指南 本文全面介绍了Google Guice框架的核心概念、设计哲学和实际应用。Guice作为J后端Koin框架深度解析轻量级Kotlin依赖注入的完美选择Koin框架深度解析轻量级Kotlin依赖注入的完美选择 Koin是一个专为Kotlin开发者设计的轻量级、实用的依赖注入框架采用纯Kotlin编写并充分利后端Google Guice完整指南掌握轻量级依赖注入框架的终极教程Google Guice完整指南掌握轻量级依赖注入框架的终极教程 Google Guice发音为juice是谷歌推出的一款专为Java 8及以上版本设后端上一篇DeTikZify突破性智能LaTeX绘图3分钟实现科研图表零编码革命下一篇终极指南使用OpenCore Legacy Patcher让老旧Mac重获新生创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
后端【免费下载链接】guiceGuice (pronounced juice) is a lightweight dependency injection framework for Java 11 and above, brought to you by Google.项目地址https://gitcode.com/gh_mirrors/gui/guice点击查看免费下载本文以 Guice 仓库根目录 README.md 为主线系统解读 Google Guice 的核心设计理念、Inject注入模型、6.0.0 与 7.0.0 两个版本的 javax/jakarta 命名空间差异以及 Guice Core 与全部扩展模块的 Maven 安装方式并结合仓库源码如 Guice.java、Injector.java、AbstractModule.java与示例工程 guice-demo 展开实战讲解。读完本文你将能够独立完成 Guice 的依赖引入、版本选型、基础模块编写与扩展组件装配。一、Guice 是什么把new变成InjectREADME 的开篇用一句话概括了 Guice 的定位Guice alleviates the need for factories and the use of new in your Java code——它消除了 Java 代码中对工厂类和new关键字的直接依赖。README 进一步给出了一个口号式表述把 Guice 的Inject看作是 the new new。这并不意味着开发者完全不需要写工厂而是意味着即便仍然存在工厂业务代码也不再直接依赖它们。由此带来的直接收益是代码更容易变更、更容易做单元测试、更容易在其它上下文中复用。README 还阐述了 Guice 的几个核心设计原则这些原则与仓库源码一一对应拥抱 Java 的类型安全type safeGuice 被视为对核心 Java 缺失特性的补充类型安全贯穿整个绑定体系典型体现是KeyT与TypeLiteralT对泛型的完整保留。不搞大而全not a kitchen sinkREADME 明确写道 We justify each feature with at least three use cases. When in doubt, we leave it out即每个特性都要有至少三个使用场景才被纳入宁可缺失也不盲目堆砌同时框架提供通用扩展机制Binder、SPI、ModuleAnnotatedMethodScanner而非把所有功能塞进核心。让开发和调试更简单快速make development and debugging easier and fasterGuice 尽量避免惊喜与魔法并且goes the extra mile to generate helpful messages——在出错时生成尽可能有用的错误信息。仓库中的错误格式化与提示系统如 Errors.java、MissingImplementationErrorHints.java正是这一原则的实现。从源码结构看core/src/com/google/inject/目录整个核心库围绕 4 个层次组织层次代表类型职责启动门面Guice.java从Module集合创建Injector注入模型Inject、Provides、Provider声明依赖与提供实例绑定/装配Module.java、AbstractModule.java、Binder.java以 EDSL 方式配置绑定运行时核心Injector.java、Stage.java构建对象图、按需提供实例二、Inject注入点的三种形态README 提到的Inject在仓库中的权威定义位于 Inject.java。它标注构造器、方法与字段三类成员其 javadoc 明确定义了Injector需要执行注入的三类对象Injector 自己构造的每一个实例被构造的类必须有一个标注Inject的构造器或者有一个无参构造器随后 Injector 会继续执行字段注入与方法注入。预先构造好的实例通过Injector.injectMembers、LinkedBindingBuilder.toInstance(...)或toProvider(...)传入的实例此时所有构造器都被忽略只做字段与方法注入。静态字段与静态方法当Module通过Binder.requestStaticInjection明确请求静态注入时。值得注意的两个细节无论成员的访问修饰符是private、包私有、protected还是public都可以被注入对应源码注释 a member can be injected regardless of its Java access specifier。Inject支持optional() default false属性设为true时若找不到合适的绑定Injector 会跳过该字段/方法的注入而不是报错对字段而言已赋的默认值会保留对方法而言只有所有参数都有绑定时才会被调用但若标注在构造器上Injector 创建时依然会产生错误。在jakarta.inject体系中Inject等价于javax.inject.Inject二者均可与 Guice 的Provider体系互通——Provider.java 直接extends jakarta.inject.ProviderT这是 7.x 版本全面转向 jakarta 命名空间的关键证据。三、核心设计理念类型安全、少即是多、友好报错README 用一整段阐述了 Guice 的世界观值得开发者认真体会因为它直接影响了 API 的形态You might think of Guice as filling in missing features for core Java.—— 在 Java 语言原生支持依赖注入之前Guice 补上了这个缺口。Guice helps you design better APIs, and the Guice API itself sets a good example.—— Guice 不只是注入框架其自身 API 就是良好 API 设计的范例。Guice steers clear of surprises and magic.—— 代码在没有工具辅助的情况下也应可读工具只是让事情更容易。错误处理上不遗余力当错误发生时Guice 会尽力生成有帮助的信息。仓库core/test/com/google/inject/errors/下的大量黄金文件golden file测试如missing_implementation_errors.txt、multiple_binding_already_set_errors.txt、class_names_are_compressed_in_error_message.txt逐一锁定了各类配置错误的输出格式是友好报错原则的直接测试证据。四、版本选型6.0.0 与 7.0.0 的 javax / jakarta 分水岭README 的 Latest releases 部分给出当前两个稳定版本线这是安装前必须做出的第一个决定版本支持的命名空间说明6.0.0javax.{inject,servlet,persistence}对jakarta.inject为mostly supports大部分支持JEE/Jakarta 过渡版本兼容旧生态7.0.0jakarta.{inject,servlet,persistence}全面转向 Jakarta EE 命名空间两者关系——6.0.0 7.0.0 are equivalent except for their javax/jakarta support除命名空间差异外二者功能等价从仓库构建配置可以印证这一结论pom.xml 中guice.api.version为1.4说明自 2006 年立项以来公共 API 一直保持高度稳定guice.lastStableRelease7.0.0/guice.lastStableRelease表明 7.0.0 是当前基线版本。仓库根 pom.xml 的模块清单为bom、core、extensions说明发布物由 BOM依赖清单、核心库与扩展库三部分组成。core/pom.xml以及 pom.xml 中的 maven-compiler-plugin 配置release11/release明确构建目标为Java 11即 README 所述 Guice is a lightweight dependency injection framework for Java 11 and above 的落地配置。选型建议基于 README 与仓库状态的事实判断如果你正在使用或迁移到 Jakarta EE 9 生态Tomcat 10、Jetty 11 等基于 jakarta.servlet 的容器应选择 7.0.0如果你的代码仍依赖javax.inject、javax.servlet等旧 API则应选择 6.0.0。仓库的 OSGi 打包配置也体现了这一趋势——pom.xml 中Import-Package!com.google.inject.*,!javax.annotation,*/Import-Package与 extensions/pom.xml 中 struts2 模块被注释struts2 doesnt support jakarta.servlet yet都表明整个项目正全面向 jakarta 迁移。五、安装Guice Core 与扩展的 Maven 坐标5.1 Guice Core核心库README 给出的核心依赖声明如下{version}可填6.0.0、7.0.0等稳定版本dependency groupIdcom.google.inject/groupId artifactIdguice/artifactId !-- {version} can be 6.0.0, 7.0.0, etc. -- version{version}/version /dependency仓库中的真实用法示例examples/guice-demo/pom.xml 以 5.1.0 为例声明了同样的坐标并同时依赖测试扩展guice-testlib与 JUnit 4.13.2dependency groupIdcom.google.inject/groupId artifactIdguice/artifactId version${guice.version}/version /dependency5.2 Guice Extension扩展库README 给出扩展模块的通用声明方式dependency groupIdcom.google.inject.extensions/groupId !-- {extension-name} can be one of: assistedinject, dagger-adapter, grapher, jmx, jndi, persist, spring, testlib or throwingproviders -- artifactIdguice-{extension-name}/artifactId !-- {version} must match the guice core version. -- version{version}/version /dependency注意 README 强调的约束{version}must match the guice core version——扩展版本必须与核心版本完全一致。这一约束在仓库构建中被强制执行extensions/pom.xml 中所有扩展统一依赖com.google.inject:guice:${project.version}即与扩展本身同版本号。结合 extensions/pom.xml 的modules清单与 bom/pom.xml 的 artifactId 命名当前仓库实际存在的扩展及用途可归纳如下扩展名Maven artifactIdguice-前缀用途依据源码assistedinjectguice-assistedinject自动生成工厂接口实现将调用方参数与 Injector 提供的依赖结合构造对象见 FactoryModuleBuilder.javadagger-adapterguice-dagger-adapter让 Dagger 风格的注解Binds、Provides等可被 Guice 模块扫描使用grapherguice-grapher将 Injector 的依赖图渲染为 Graphviz 图jmxguice-jmxJMX 管理扩展jndiguice-jndiJNDI 资源注入见 JndiIntegration.javapersistguice-persistJPA 持久化单元与Transactional拦截器见 PersistModule.javaservletguice-servletServlet 容器集成与请求级作用域对应 pom 中jakarta.servlet-api5.0.0 依赖见 extensions/servlet/pom.xmlspringguice-spring与 Spring 框架互操作testlibguice-testlib测试辅助库如BoundFieldModule见 AppTest.javathrowingprovidersguice-throwingproviders允许 Provider 抛出受检异常的变体补充两点仓库事实struts2扩展在 extensions/pom.xml 与 bom/pom.xml 中均被注释排除原因是 struts2 doesnt support jakarta.servlet yet因此当前版本不随 Maven 发布。README 提到 See Maven Central for more details, including snippets for other build systems such as Gradle, Ivy, sbt——即除 Maven 外同样坐标适用于 Gradle、Ivy、sbt 等其它构建工具。5.3 使用 BOM 统一版本管理仓库 bom 模块提供guice-bom一次性声明核心与全部扩展的版本避免多依赖版本漂移dependencyManagement dependencies dependency groupIdcom.google.inject/groupId artifactIdguice-bom/artifactId version{version}/version typepom/type scopeimport/scope /dependency /dependencies /dependencyManagement引入 BOM 后各依赖即可省略version由 BOM 统一约束。六、从一个可运行的例子理解安装成果guice-demo仓库自带最小可运行示例 examples/guice-demo其入口 App.java 展示了依赖安装完成后最典型的用法——Guice.createInjector(modules).getInstance(App.class)public static void main(String[] args) { Printer consolePrinter new Printer() { /* 打印到控制台 */ }; App app Guice.createInjector( new MessageModule(), new AbstractModule() { Override protected void configure() { bind(Printer.class).toInstance(consolePrinter); } }) .getInstance(App.class); app.run(); }这个例子浓缩了四个关键 API 的用法逐一对应源码Guice.createInjector(Module...)入口门面见 Guice.java其 javadoc 给出的范式正是应用在main方法中创建 Injector然后getInstance取出启动器对象。AbstractModule继承它即可在configure()里用继承方法bind、install、bindConstant等配置绑定见 AbstractModule.java 的官方示例。注意Module.configure(Binder)是唯一的抽象方法Module接口本身被标注为FunctionalInterface见 Module.java。Provides方法在MessageModule中Provides Message String provideMessage()把方法返回值绑定到其返回类型配合自定义Qualifier注解见 Provides.java——The methods return type is bound to its returned value. Guice will pass dependencies to the method as parameters.Injector.getInstance等价于getProvider(type).get()见 Injector.java官方 javadoc 提醒when feasible, avoid using this method, in favor of having Guice inject your dependencies ahead of time即尽量依赖注入而非手动取实例。该示例的测试 AppTest.java 还示范了测试扩展guice-testlib的BoundFieldModule用法在测试类字段上用Bind声明绑定再Guice.createInjector(BoundFieldModule.of(this)).injectMembers(this)完成注入。6.1 安装与运行命令在 examples/guice-demo 目录下或任意已声明 Guice 依赖的 Maven 工程中mvn compile # 编译验证依赖解析成功 mvn test # 运行测试AppTest 会验证依赖注入链路 mvn exec:java # 运行 App.main需另配 exec 插件或直接 java -cp 运行依赖是否就绪的快速判断标准mvn dependency:tree输出中应出现com.google.inject:guice及所选的扩展且版本与核心一致。七、从 README 到实战理解 Injector 与 Binder 的核心能力README 只给出了整体介绍但要让安装的依赖真正跑起来还需要理解两个核心类型的能力边界它们都由源码直接定义7.1 Injector应用的对象图Injector.java 的 javadoc 明确Injector 构建构成应用程序的对象图跟踪每个类型的依赖并用绑定完成注入这是 DI 区别于 Service Locator 模式的根本所在。它还自带若干默认绑定该Injector实例本身每个类型T的绑定对应的ProviderT被注入类对应的java.util.logging.Logger创建 Injector 时的Stage。常用能力一览均来自 Injector.java方法作用getInstance(ClassT)/getInstance(KeyT)取得实例等价于getProvider(key).get()getProvider(ClassT)/getProvider(KeyT)取得延迟实例化入口可避免提前创建injectMembers(Object)对已构造对象执行字段/方法注入getBindings()/getAllBindings()获取显式绑定含 JIT 绑定的只读快照供 SPI 工具使用createChildInjector(Module...)创建子 Injector继承父级全部绑定、作用域、拦截器与类型转换器getParent()返回父 Injector其中createChildInjector与Binder.newPrivateBinder、PrivateModule构成分层注入体系官方 javadoc 特别提醒分层场景下可能需要显式bind(ServiceImpl.class)才能把绑定正确关联到当前 Injector否则 Guice 可能把绑定提升到祖先 Injector。7.2 Binder 的绑定 EDSLBinder.java 定义了完整的绑定 DSLjavadoc 中给出了官方示例系列这里提炼为速查表省略了binder前缀与继承AbstractModule的写法一致bind(ServiceImpl.class); // 自身绑定显式清单 bind(Service.class).to(ServiceImpl.class); // 链接绑定覆盖 ImplementedBy / ProvidedBy bind(Service.class).toProvider(ServiceProvider.class); // 绑定到 Provider 类 bind(Service.class).annotatedWith(Red.class).to(...); // 绑定注解限定 bind(ServiceImpl.class).in(Singleton.class); // 单例作用域 bind(new TypeLiteralPaymentServiceCreditCard() {}) .to(CreditCardPaymentService.class); // 参数化类型绑定 bind(Service.class).toInstance(new ServiceImpl()); // 绑定到已构造实例eager loading bindConstant().annotatedWith(Names.named(port)).to(8080); // 常量绑定 bind(Service.class) .annotatedWith(Names.named(blue)) .to(BlueService.class); // 命名绑定几个值得注意的语义细节均有源码依据作用域覆盖规则in(Singleton.class)会覆盖ServiceImpl类上注解声明的作用域a scope specified in this way overrides any scope that was specified with an annotation on the ServiceImpl class。常量绑定转换字符串常量可自动转换为所有基本类型、所有枚举Enum.valueOf与类字面量其它类型需通过convertToTypes(Matcher, TypeConverter)注册自定义转换。JIT 绑定未显式绑定的类型若存在可注入构造器或无参构造器Guice 会在首次请求时按需创建隐式绑定即 Just-In-Time bindinggetBinding的 javadoc 明确说明了这一行为。严格模式开关requireExplicitBindings()禁止隐式绑定、disableCircularProxies()禁止循环依赖代理、requireAtInjectOnConstructors()强制构造器必须标注Inject、requireExactBindingAnnotations()禁止模糊匹配绑定注解——这些方法在 Binder.java 中均有完整语义说明适合对隐式行为敏感的生产项目。7.3 Stage工具、开发与生产三种阶段Stage.java 定义了三个枚举值README 未展开但安装后立刻会遇到Guice.createInjector(Stage, Module...)的重载Stage行为定位TOOL运行在工具如 IDE 插件中只需要绑定元数据不做成员注入、不加载 eager singleton创建的 Injector 不能用于满足注入DEVELOPMENT追求快速启动牺牲部分运行时性能与前置错误检查Guice.createInjector(Module...)的默认值PRODUCTION尽可能提前捕获错误前置成本高、运行时性能好选择建议日常开发用默认的DEVELOPMENT发布前跑一次PRODUCTION可尽早暴露配置错误。八、扩展机制让框架按需生长README 强调 Guice builds general functionality which enables you to extend Guice rather than adding every feature to the core framework即通过通用扩展点让用户扩展框架而非在核心堆砌特性。从源码看核心的扩展点包括Binder.install(Module)组合子模块。注意Module接口 javadoc 强调不要直接调用configure(Binder)安装子模块而应使用install因为后者才能确保Provides等 provider 方法被扫描发现。TypeListener/ProvisionListener通过bindListener(...)注册分别在类型被发现时与对象被提供前后获得回调。TypeConverter通过convertToTypes(...)注册字符串到任意类型的转换。ModuleAnnotatedMethodScanner通过scanModulesForAnnotatedMethods(...)注册可让自定义注解像Provides一样被扫描并绑定dagger-adapter 扩展即基于此机制。bindScopeScope注册自定义作用域注解README 也提到 servlet 扩展提供ServletScopes等请求级作用域。这些扩展点在 Binder.java 中均有完整签名与语义说明是理解少即是多 可扩展设计的最佳入口。九、总结安装 Guice 前的最终核对清单回到 README 的核心内容安装与使用 Guice 的完整决策链是选版本Java 11 环境使用javax.*选6.0.0使用jakarta.*选7.0.0二者除命名空间外功能等价。引依赖核心用com.google.inject:guice:{version}扩展用com.google.inject.extensions:guice-{extension-name}:{version}且扩展版本必须与核心一致可借助guice-bom统一管理。写模块继承AbstractModule在configure()中使用绑定 EDSL或用Provides方法用install()组合子模块。启动在main方法中Guice.createInjector(modules)创建Injector随后getInstance(...)或让框架自动注入。按需强化生产环境用Stage.PRODUCTION提前暴露错误对隐式行为敏感时启用requireExplicitBindings()等严格选项复杂场景再按需引入 servlet、persist、assistedinject 等扩展。最后补充一个仓库事实guice-parent的当前 SNAPSHOT 版本为7.0.1-SNAPSHOT见 pom.xml说明 7.x 主线仍在持续演进而自 2006 年起 Guice 就被用于关键业务系统README 原话 Weve been running Guice in mission critical applications since 2006其 API 以guice.api.version 1.4保持了十余年的向后兼容。对于希望深入了解底层实现的读者推荐继续阅读仓库内的 InjectorImpl.java注入器核心实现与 BindingBuilder.java绑定 EDSL 实现以及 BinderTest.java、InjectorTest.java 等核心测试它们与本文所述语义一一对应。赞分享后端【免费下载链接】guiceGuice (pronounced juice) is a lightweight dependency injection framework for Java 11 and above, brought to you by Google.项目地址https://gitcode.com/gh_mirrors/gui/guice点击查看免费下载相关推荐深入理解Google Guice轻量级Java依赖注入框架入门指南深入理解Google Guice轻量级Java依赖注入框架入门指南 本文全面介绍了Google Guice框架的核心概念、设计哲学和实际应用。Guice作为J后端Koin框架深度解析轻量级Kotlin依赖注入的完美选择Koin框架深度解析轻量级Kotlin依赖注入的完美选择 Koin是一个专为Kotlin开发者设计的轻量级、实用的依赖注入框架采用纯Kotlin编写并充分利后端Google Guice完整指南掌握轻量级依赖注入框架的终极教程Google Guice完整指南掌握轻量级依赖注入框架的终极教程 Google Guice发音为juice是谷歌推出的一款专为Java 8及以上版本设后端上一篇DeTikZify突破性智能LaTeX绘图3分钟实现科研图表零编码革命下一篇终极指南使用OpenCore Legacy Patcher让老旧Mac重获新生创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
