Skip to content

Commit 24324ca

Browse files
samebGuice Team
authored andcommitted
Prepare for the Guice 6.0 & 7.0 releases. This change does the following:
* Bumps the snapshot version to 7.0.1-SNAPSHOT * Adds Guice 6 & Guice 7 release pages, with explanations of the jakarta transition & how Guice 6.0 & 7.0 should be used. They also include changelogs since 5.1.0. * Updates the top-level README to reference the 6.0 & 7.0 releases, as well as including "installation instructions" (which fixes #1698). * Updates the wiki to make sure it's meaningful for both javax & jakarta references, pointing to the correct ones where appropriate. PiperOrigin-RevId: 529770936
1 parent 49b1a33 commit 24324ca

File tree

16 files changed

+55
-19
lines changed

16 files changed

+55
-19
lines changed

README.md

Lines changed: 40 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,18 +2,26 @@ Guice
22
====
33

44
- **Latest release: [5.1.0](https://github.com/google/guice/wiki/Guice510)**
5+
- **Latest pre-releases:**
6+
* **[6.0.0-rc2](https://github.com/google/guice/wiki/Guice600) (supports `jakarta.inject`, `jakarta.servlet`, and `jakarta.persistence`, [mostly supports](https://github.com/google/guice/wiki/Guice600#jee-jakarta-transition) `jakarta.inject`)**
7+
* **[7.0.0-rc1](https://github.com/google/guice/wiki/Guice700) (supports `jakarta.inject`, `jakarta.servlet`, and `jakarta.persistence`)**
58
- **Documentation:**
6-
[User Guide](https://github.com/google/guice/wiki/Motivation),
7-
[Latest javadocs](https://google.github.io/guice/api-docs/latest/javadoc/index.html)
8-
[5.1.0 javadocs](https://google.github.io/guice/api-docs/5.1.0/javadoc/index.html)
9+
* [User Guide](https://github.com/google/guice/wiki/Motivation),
10+
* [5.1.0 javadocs](https://google.github.io/guice/api-docs/5.1.0/javadoc/index.html)
11+
* [6.0.0 javadocs](https://google.github.io/guice/api-docs/6.0.0-rc2/javadoc/index.html)
12+
* [7.0.0 javadocs](https://google.github.io/guice/api-docs/7.0.0-rc1/javadoc/index.html)
13+
* [Latest Snapshot javadocs](https://google.github.io/guice/api-docs/latest/javadoc/index.html)
914
- **Continuous Integration:**
1015
[![Build Status](https://github.com/google/guice/workflows/continuous-integration/badge.svg)](https://github.com/google/guice/actions)
1116
- **Mailing Lists:** [User Mailing List](http://groups.google.com/group/google-guice) <br/>
1217
- **License:** [Apache 2.0](http://www.apache.org/licenses/LICENSE-2.0)
1318

19+
Overview
20+
====
21+
1422
Put simply, Guice alleviates the need for factories and the use of new in your Java code. Think of Guice's @Inject as the new new. You will still need to write factories in some cases, but your code will not depend directly on them. Your code will be easier to change, unit test and reuse in other contexts.
1523

16-
Guice embraces Java's type safe nature, especially when it comes to features introduced in Java 5 such as generics and annotations. You might think of Guice as filling in missing features for core Java. Ideally, the language itself would provide most of the same features, but until such a language comes along, we have Guice.
24+
Guice embraces Java's type safe nature. You might think of Guice as filling in missing features for core Java. Ideally, the language itself would provide most of the same features, but until such a language comes along, we have Guice.
1725

1826
Guice helps you design better APIs, and the Guice API itself sets a good example. Guice is not a kitchen sink. We justify each feature with at least three use cases. When in doubt, we leave it out. We build general functionality which enables you to extend Guice rather than adding every feature to the core framework.
1927

@@ -23,4 +31,32 @@ For an introduction to Guice and a comparison to new and the factory pattern, se
2331

2432
We've been running Guice in mission critical applications since 2006, and now you can, too. We hope you enjoy it as much as we do.
2533

34+
35+
Installation Instructions
36+
====
37+
Guice Core (Maven)
38+
```xml
39+
<dependency>
40+
<groupId>com.google.inject</groupId>
41+
<artifactId>guice</artifactId>
42+
<!-- {version} can be 5.1.0, 6.0.0-rc2, 7.0.0-rc1, etc. -->
43+
<version>{version}</version>
44+
</dependency>
45+
```
46+
47+
Guice Extension (Maven)
48+
```xml
49+
<dependency>
50+
<groupId>com.google.inject.extensions</groupId>
51+
<!-- {extension-name} can be one of: assistedinject, dagger-adapter,
52+
grapher, jmx, jndi, persist, spring, testlib or throwingproviders -->
53+
<artifactId>guice-{extension-name}</artifactId>
54+
<!-- {version} must match the guice core version. -->
55+
<version>{version}</version>
56+
</dependency>
57+
```
58+
59+
See [Maven Central](https://central.sonatype.com/artifact/com.google.inject/guice/) for more details, including snippets for other build systems such as Gradle, Ivy, sbt, and more.
60+
61+
---
2662
[![jolt award](https://user-images.githubusercontent.com/1885701/52603534-0d620380-2e1c-11e9-8cd5-95f0e141fcb0.png)](http://www.drdobbs.com/tools/winners-of-the-18th-jolt-product-excelle/207600666?pgno=6)

bom/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<parent>
77
<groupId>com.google.inject</groupId>
88
<artifactId>guice-parent</artifactId>
9-
<version>5.1.1-SNAPSHOT</version>
9+
<version>7.0.1-SNAPSHOT</version>
1010
</parent>
1111

1212
<packaging>pom</packaging>

core/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<parent>
77
<groupId>com.google.inject</groupId>
88
<artifactId>guice-parent</artifactId>
9-
<version>5.1.1-SNAPSHOT</version>
9+
<version>7.0.1-SNAPSHOT</version>
1010
</parent>
1111

1212
<artifactId>guice</artifactId>

extensions/assistedinject/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<parent>
77
<groupId>com.google.inject.extensions</groupId>
88
<artifactId>extensions-parent</artifactId>
9-
<version>5.1.1-SNAPSHOT</version>
9+
<version>7.0.1-SNAPSHOT</version>
1010
</parent>
1111

1212
<artifactId>guice-assistedinject</artifactId>

extensions/dagger-adapter/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
<parent>
66
<groupId>com.google.inject.extensions</groupId>
77
<artifactId>extensions-parent</artifactId>
8-
<version>5.1.1-SNAPSHOT</version>
8+
<version>7.0.1-SNAPSHOT</version>
99
</parent>
1010
<artifactId>guice-dagger-adapter</artifactId>
1111
<name>Google Guice - Extensions - Dagger Adapter</name>

extensions/grapher/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<parent>
77
<groupId>com.google.inject.extensions</groupId>
88
<artifactId>extensions-parent</artifactId>
9-
<version>5.1.1-SNAPSHOT</version>
9+
<version>7.0.1-SNAPSHOT</version>
1010
</parent>
1111

1212
<artifactId>guice-grapher</artifactId>

extensions/jmx/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<parent>
77
<groupId>com.google.inject.extensions</groupId>
88
<artifactId>extensions-parent</artifactId>
9-
<version>5.1.1-SNAPSHOT</version>
9+
<version>7.0.1-SNAPSHOT</version>
1010
</parent>
1111

1212
<artifactId>guice-jmx</artifactId>

extensions/jndi/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<parent>
77
<groupId>com.google.inject.extensions</groupId>
88
<artifactId>extensions-parent</artifactId>
9-
<version>5.1.1-SNAPSHOT</version>
9+
<version>7.0.1-SNAPSHOT</version>
1010
</parent>
1111

1212
<artifactId>guice-jndi</artifactId>

extensions/persist/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<parent>
77
<groupId>com.google.inject.extensions</groupId>
88
<artifactId>extensions-parent</artifactId>
9-
<version>5.1.1-SNAPSHOT</version>
9+
<version>7.0.1-SNAPSHOT</version>
1010
</parent>
1111

1212
<artifactId>guice-persist</artifactId>

extensions/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<parent>
77
<groupId>com.google.inject</groupId>
88
<artifactId>guice-parent</artifactId>
9-
<version>5.1.1-SNAPSHOT</version>
9+
<version>7.0.1-SNAPSHOT</version>
1010
</parent>
1111

1212
<packaging>pom</packaging>

0 commit comments

Comments
 (0)