This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-lang.git
The following commit(s) were added to refs/heads/master by this push:
new a58fa283f Javadoc
a58fa283f is described below
commit a58fa283f4ecf2dc583e2c075cf67bf9c04946d9
Author: Gary Gregory <[email protected]>
AuthorDate: Thu Sep 18 10:22:12 2025 -0400
Javadoc
---
.../apache/commons/lang3/RandomStringUtils.java | 36 +++++++++++-----------
1 file changed, 18 insertions(+), 18 deletions(-)
diff --git a/src/main/java/org/apache/commons/lang3/RandomStringUtils.java
b/src/main/java/org/apache/commons/lang3/RandomStringUtils.java
index 7776ff686..5f0392e3a 100644
--- a/src/main/java/org/apache/commons/lang3/RandomStringUtils.java
+++ b/src/main/java/org/apache/commons/lang3/RandomStringUtils.java
@@ -129,7 +129,7 @@ public static RandomStringUtils insecure() {
* @param count the length of random string to create.
* @return the random string.
* @throws IllegalArgumentException if {@code count} < 0.
- * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link
#insecure()}.
+ * @deprecated Use {@link #next(int)} from {@link #secure()}, {@link
#secureStrong()}, or {@link #insecure()}.
*/
@Deprecated
public static String random(final int count) {
@@ -148,7 +148,7 @@ public static String random(final int count) {
* @param numbers if {@code true}, generated string may include numeric
characters.
* @return the random string.
* @throws IllegalArgumentException if {@code count} < 0.
- * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link
#insecure()}.
+ * @deprecated Use {@link #next(int, boolean, boolean)} from {@link
#secure()}, {@link #secureStrong()}, or {@link #insecure()}.
*/
@Deprecated
public static String random(final int count, final boolean letters, final
boolean numbers) {
@@ -166,7 +166,7 @@ public static String random(final int count, final boolean
letters, final boolea
* @param chars the character array containing the set of characters to
use, may be null.
* @return the random string.
* @throws IllegalArgumentException if {@code count} < 0.
- * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link
#insecure()}.
+ * @deprecated Use {@link #next(int, char...)} from {@link #secure()},
{@link #secureStrong()}, or {@link #insecure()}.
*/
@Deprecated
public static String random(final int count, final char... chars) {
@@ -187,7 +187,7 @@ public static String random(final int count, final char...
chars) {
* @param numbers if {@code true}, generated string may include numeric
characters.
* @return the random string.
* @throws IllegalArgumentException if {@code count} < 0.
- * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link
#insecure()}.
+ * @deprecated Use {@link #next(int, int, int, boolean)} from {@link
#secure()}, {@link #secureStrong()}, or {@link #insecure()}.
*/
@Deprecated
public static String random(final int count, final int start, final int
end, final boolean letters,
@@ -213,7 +213,7 @@ public static String random(final int count, final int
start, final int end, fin
* @return the random string.
* @throws ArrayIndexOutOfBoundsException if there are not {@code (end -
start) + 1} characters in the set array.
* @throws IllegalArgumentException if {@code count} < 0.
- * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link
#insecure()}.
+ * @deprecated Use {@link #next(int, int, int, boolean, boolean, char...)}
from {@link #secure()}, {@link #secureStrong()}, or {@link #insecure()}.
*/
@Deprecated
public static String random(final int count, final int start, final int
end, final boolean letters,
@@ -402,7 +402,7 @@ public static String random(int count, int start, int end,
final boolean letters
* @param chars the String containing the set of characters to use, may be
null, but must not be empty.
* @return the random string.
* @throws IllegalArgumentException if {@code count} < 0 or the string
is empty.
- * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link
#insecure()}.
+ * @deprecated Use {@link #next(int, String)} from {@link #secure()},
{@link #secureStrong()}, or {@link #insecure()}.
*/
@Deprecated
public static String random(final int count, final String chars) {
@@ -419,7 +419,7 @@ public static String random(final int count, final String
chars) {
* @param count the length of random string to create.
* @return the random string.
* @throws IllegalArgumentException if {@code count} < 0.
- * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link
#insecure()}.
+ * @deprecated Use {@link #nextAlphabetic(int)} from {@link #secure()},
{@link #secureStrong()}, or {@link #insecure()}.
*/
@Deprecated
public static String randomAlphabetic(final int count) {
@@ -437,7 +437,7 @@ public static String randomAlphabetic(final int count) {
* @param maxLengthExclusive the exclusive maximum length of the string to
generate.
* @return the random string.
* @since 3.5
- * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link
#insecure()}.
+ * @deprecated Use {@link #nextAlphabetic(int, int)} from {@link
#secure()}, {@link #secureStrong()}, or {@link #insecure()}.
*/
@Deprecated
public static String randomAlphabetic(final int minLengthInclusive, final
int maxLengthExclusive) {
@@ -454,7 +454,7 @@ public static String randomAlphabetic(final int
minLengthInclusive, final int ma
* @param count the length of random string to create.
* @return the random string.
* @throws IllegalArgumentException if {@code count} < 0.
- * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link
#insecure()}.
+ * @deprecated Use {@link #nextAlphanumeric(int)} from {@link #secure()},
{@link #secureStrong()}, or {@link #insecure()}.
*/
@Deprecated
public static String randomAlphanumeric(final int count) {
@@ -472,7 +472,7 @@ public static String randomAlphanumeric(final int count) {
* @param maxLengthExclusive the exclusive maximum length of the string to
generate.
* @return the random string.
* @since 3.5
- * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link
#insecure()}.
+ * @deprecated Use {@link #nextAlphanumeric(int, int)} from {@link
#secure()}, {@link #secureStrong()}, or {@link #insecure()}.
*/
@Deprecated
public static String randomAlphanumeric(final int minLengthInclusive,
final int maxLengthExclusive) {
@@ -490,7 +490,7 @@ public static String randomAlphanumeric(final int
minLengthInclusive, final int
* @param count the length of random string to create.
* @return the random string.
* @throws IllegalArgumentException if {@code count} < 0.
- * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link
#insecure()}.
+ * @deprecated Use {@link #nextAscii(int)} from {@link #secure()}, {@link
#secureStrong()}, or {@link #insecure()}.
*/
@Deprecated
public static String randomAscii(final int count) {
@@ -509,7 +509,7 @@ public static String randomAscii(final int count) {
* @param maxLengthExclusive the exclusive maximum length of the string to
generate.
* @return the random string.
* @since 3.5
- * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link
#insecure()}.
+ * @deprecated Use {@link #nextAscii(int, int)} from {@link #secure()},
{@link #secureStrong()}, or {@link #insecure()}.
*/
@Deprecated
public static String randomAscii(final int minLengthInclusive, final int
maxLengthExclusive) {
@@ -528,7 +528,7 @@ public static String randomAscii(final int
minLengthInclusive, final int maxLeng
* @return the random string.
* @throws IllegalArgumentException if {@code count} < 0.
* @since 3.5
- * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link
#insecure()}.
+ * @deprecated Use {@link #nextGraph(int)} from {@link #secure()}, {@link
#secureStrong()}, or {@link #insecure()}.
*/
@Deprecated
public static String randomGraph(final int count) {
@@ -546,7 +546,7 @@ public static String randomGraph(final int count) {
* @param maxLengthExclusive the exclusive maximum length of the string to
generate.
* @return the random string.
* @since 3.5
- * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link
#insecure()}.
+ * @deprecated Use {@link #nextGraph(int, int)} from {@link #secure()},
{@link #secureStrong()}, or {@link #insecure()}.
*/
@Deprecated
public static String randomGraph(final int minLengthInclusive, final int
maxLengthExclusive) {
@@ -563,7 +563,7 @@ public static String randomGraph(final int
minLengthInclusive, final int maxLeng
* @param count the length of random string to create.
* @return the random string.
* @throws IllegalArgumentException if {@code count} < 0.
- * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link
#insecure()}.
+ * @deprecated Use {@link #nextNumeric(int)} from {@link #secure()},
{@link #secureStrong()}, or {@link #insecure()}.
*/
@Deprecated
public static String randomNumeric(final int count) {
@@ -581,7 +581,7 @@ public static String randomNumeric(final int count) {
* @param maxLengthExclusive the exclusive maximum length of the string to
generate.
* @return the random string.
* @since 3.5
- * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link
#insecure()}.
+ * @deprecated Use {@link #nextNumeric(int, int)} from {@link #secure()},
{@link #secureStrong()}, or {@link #insecure()}.
*/
@Deprecated
public static String randomNumeric(final int minLengthInclusive, final int
maxLengthExclusive) {
@@ -600,7 +600,7 @@ public static String randomNumeric(final int
minLengthInclusive, final int maxLe
* @return the random string.
* @throws IllegalArgumentException if {@code count} < 0.
* @since 3.5
- * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link
#insecure()}.
+ * @deprecated Use {@link #randomPrint(int)} from {@link #secure()},
{@link #secureStrong()}, or {@link #insecure()}.
*/
@Deprecated
public static String randomPrint(final int count) {
@@ -618,7 +618,7 @@ public static String randomPrint(final int count) {
* @param maxLengthExclusive the exclusive maximum length of the string to
generate.
* @return the random string.
* @since 3.5
- * @deprecated Use {@link #secure()}, {@link #secureStrong()}, or {@link
#insecure()}.
+ * @deprecated Use {@link #randomPrint(int, int)} from {@link #secure()},
{@link #secureStrong()}, or {@link #insecure()}.
*/
@Deprecated
public static String randomPrint(final int minLengthInclusive, final int
maxLengthExclusive) {
