@@ -48,7 +48,7 @@ public class ComposableCacheResolver<T extends GemFireCache> extends AbstractCac
48
48
private final CacheResolver <T > cacheResolverTwo ;
49
49
50
50
/**
51
- * Null-safe factory method to compose an array of {@link CacheResolver} objects in a composition.
51
+ * Factory method used to compose an array of {@link CacheResolver CacheResolvers} in a composition.
52
52
*
53
53
* @param <T> {@link Class subclass} of {@link GemFireCache}.
54
54
* @param cacheResolvers array of {@link CacheResolver CacheResolvers} to compose; may be {@literal null}.
@@ -63,14 +63,17 @@ public static <T extends GemFireCache> CacheResolver<T> compose(@Nullable CacheR
63
63
}
64
64
65
65
/**
66
- * Null-safe factory method to compose an {@link Iterable} of {@link CacheResolver} objects in a composition.
66
+ * Factory method used to compose an {@link Iterable} collection of {@link CacheResolver CacheResolvers}
67
+ * in a composition.
67
68
*
68
69
* @param <T> {@link Class subclass} of {@link GemFireCache}.
69
- * @param cacheResolvers {@link Iterable} of {@link CacheResolver CacheResolvers} to compose; may be {@literal null}.
70
- * @return a composition from the {@link Iterable} of {@link CacheResolver CacheResolvers}; may be {@literal null}.
70
+ * @param cacheResolvers {@link Iterable} collection of {@link CacheResolver CacheResolvers} to compose;
71
+ * may be {@literal null}.
72
+ * @return a composition from the {@link Iterable} collection of {@link CacheResolver CacheResolvers};
73
+ * may be {@literal null}.
74
+ * @see #compose(CacheResolver, CacheResolver)
71
75
* @see org.springframework.data.gemfire.CacheResolver
72
76
* @see java.lang.Iterable
73
- * @see #compose(CacheResolver, CacheResolver)
74
77
*/
75
78
@ Nullable
76
79
public static <T extends GemFireCache > CacheResolver <T > compose (@ Nullable Iterable <CacheResolver <T >> cacheResolvers ) {
@@ -105,14 +108,15 @@ public static <T extends GemFireCache> CacheResolver<T> compose(@Nullable CacheR
105
108
106
109
/**
107
110
* Constructs a new instance of {@link ComposableCacheResolver} initialized and composed with
108
- * the given {@link CacheResolver} objects/arguments .
111
+ * the given {@link CacheResolver CacheResolvers} forming the composition .
109
112
*
110
113
* @param cacheResolverOne first {@link CacheResolver} in the composition.
111
114
* @param cacheResolverTwo second {@link CacheResolver} in the composition.
112
115
* @throws IllegalArgumentException if either {@link CacheResolver} argument is {@literal null}.
113
116
* @see org.springframework.data.gemfire.CacheResolver
114
117
*/
115
- protected ComposableCacheResolver (CacheResolver <T > cacheResolverOne , CacheResolver <T > cacheResolverTwo ) {
118
+ protected ComposableCacheResolver (@ NonNull CacheResolver <T > cacheResolverOne ,
119
+ @ NonNull CacheResolver <T > cacheResolverTwo ) {
116
120
117
121
Assert .notNull (cacheResolverOne , "CacheResolver 1 must not be null" );
118
122
Assert .notNull (cacheResolverTwo , "CacheResolver 2 must not be null" );
@@ -137,13 +141,13 @@ protected ComposableCacheResolver(CacheResolver<T> cacheResolverOne, CacheResolv
137
141
* @return a reference to the second {@link CacheResolver} in the composition.
138
142
* @see org.springframework.data.gemfire.CacheResolver
139
143
*/
140
- protected CacheResolver <T > getCacheResolverTwo () {
144
+ protected @ NonNull CacheResolver <T > getCacheResolverTwo () {
141
145
return this .cacheResolverTwo ;
142
146
}
143
147
144
148
/**
145
149
* Resolves the first, single reference to a {@link GemFireCache}, handling any {@link Exception Exceptions}
146
- * throwing by composed {@link CacheResolver CacheResolvers}, such as a {@link CacheClosedException}.
150
+ * throwing by the composed {@link CacheResolver CacheResolvers}, such as a {@link CacheClosedException}.
147
151
*
148
152
* This method may ultimately still result in a thrown {@link Exception}, but it will make a best effort to
149
153
* exhaustively consult all composed {@link CacheResolver CacheResolvers}.
0 commit comments