Util (Jenkins core 2.348 API)

java.lang.Object
- hudson.Util

```
public class Util
extends Object
```
Various utility methods that don't have more proper home.

Author:

Kohsuke Kawaguchi

Field Summary

Fields
Modifier and Type	Field and Description
`static boolean`	`NO_SYMLINK` On Unix environment that cannot run "ln", set this to true.
`static org.apache.commons.lang.time.FastDateFormat`	`RFC822_DATETIME_FORMATTER`
`static boolean`	`SYMLINK_ESCAPEHATCH`
`static org.apache.commons.lang.time.FastDateFormat`	`XS_DATETIME_FORMATTER`

Constructor Summary

Constructors
Constructor and Description

Util()

Constructors
Constructor and Description
`Util()`

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static File`	`changeExtension(File dst, String ext)` Returns a file name by changing its extension.
`static void`	`closeAndLogFailures(Closeable toClose, Logger logger, String closeableName, String closeableOwner)` Closes the item and logs error to the log in the case of error.
`static String`	`combine(long n, String suffix)` Deprecated. Use individual localization methods instead. See `Messages.Util_year(Object)` for an example. Deprecated since 2009-06-24, remove method after 2009-12-24.
`static void`	`copyFile(File src, File dst)` Deprecated. since 2.335; use `Files.copy(Path, Path, CopyOption...)` directly
`static void`	`copyStream(InputStream in, OutputStream out)` Deprecated. Use `IOUtils.copy(InputStream, OutputStream)`
`static void`	`copyStream(Reader in, Writer out)` Deprecated. Use `IOUtils.copy(Reader, Writer)`
`static void`	`copyStreamAndClose(InputStream in, OutputStream out)` Deprecated. Use `IOUtils.copy(InputStream, OutputStream)` in a `try`-with-resources block
`static void`	`copyStreamAndClose(Reader in, Writer out)` Deprecated. Use `IOUtils.copy(Reader, Writer)` in a `try`-with-resources block
`static Path`	`createDirectories(Path dir, FileAttribute<?>... attrs)` Create a directory by creating all nonexistent parent directories first.
`static org.apache.tools.ant.types.FileSet`	`createFileSet(File baseDir, String includes)`
`static org.apache.tools.ant.types.FileSet`	`createFileSet(File baseDir, String includes, String excludes)` Creates Ant `FileSet` with the base dir and include pattern.
`static <T> List<T>`	`createSubList(Collection<?> source, Class<T> type)` Create a sub-list by only picking up instances of the specified type.
`static void`	`createSymlink(File baseDir, String targetPath, String symlinkPath, TaskListener listener)` Creates a symlink to targetPath at baseDir+symlinkPath.
`static File`	`createTempDir()` Creates a new temporary directory.
`static long`	`daysBetween(Date a, Date b)` Compute the number of calendar days elapsed since the given date.
`static long`	`daysElapsedSince(Date date)`
`static void`	`deleteContentsRecursive(File file)` Deletes the contents of the given directory (but not the directory itself) recursively.
`static void`	`deleteContentsRecursive(Path path, PathRemover.PathChecker pathChecker)` Deletes the given directory contents (but not the directory itself) recursively using a PathChecker.
`static void`	`deleteFile(File f)` Deletes this file (and does not take no for an answer).
`static void`	`deleteRecursive(File dir)` Deletes the given directory (including its contents) recursively.
`static void`	`deleteRecursive(Path dir, PathRemover.PathChecker pathChecker)` Deletes the given directory and contents recursively using a filter.
`static void`	`displayIOException(IOException e, TaskListener listener)` On Windows, error messages for IOException aren't very helpful.
`static String`	`encode(String s)` Escapes non-ASCII characters in URL.
`static String`	`encodeRFC2396(String url)` Deprecated. since 2008-05-13. This method is broken (see JENKINS-1666). It should probably be removed but I'm not sure if it is considered part of the public API that needs to be maintained for backwards compatibility. Use `encode(String)` instead.
`static String`	`ensureEndsWith(String subject, String suffix)` Ensure string ends with suffix
`static String`	`escape(String text)` Escapes HTML unsafe characters like <, & to the respective character entities.
`static Path`	`fileToPath(File file)` Converts a `File` into a `Path` and checks runtime exceptions.
`static <T> List<T>`	`filter(Iterable<?> base, Class<T> type)` Creates a filtered sublist.
`static <T> List<T>`	`filter(List<?> base, Class<T> type)` Creates a filtered sublist.
`static String`	`fixEmpty(String s)` Convert empty string to null.
`static String`	`fixEmptyAndTrim(String s)` Convert empty string to null, and trim whitespace.
`static <T> Collection<T>`	`fixNull(Collection<T> l)`
`static <T> Iterable<T>`	`fixNull(Iterable<T> l)`
`static <T> List<T>`	`fixNull(List<T> l)`
`static <T> Set<T>`	`fixNull(Set<T> l)`
`static String`	`fixNull(String s)` Convert null to "".
`static <T> T`	`fixNull(T s, T defaultValue)` Convert `null` to a default value.
`static byte[]`	`fromHexString(String data)`
`static String`	`fullEncode(String s)` Encode a single path component for use in an HTTP URL.
`static String`	`getDigestOf(File file)` Computes the MD5 digest of a file.
`static String`	`getDigestOf(InputStream source)` Computes MD5 digest of the given input stream.
`static String`	`getDigestOf(String text)`
`static String`	`getFileName(String filePath)` Cuts all the leading path portion and get just the file name.
`static String`	`getHostName()` Guesses the current host name.
`static <T> T`	`getNearestAncestorOfTypeOrThrow(org.kohsuke.stapler.StaplerRequest request, Class<T> clazz)` Find the specific ancestor, or throw an exception.
`static String`	`getPastTimeString(long duration)` Deprecated. Actually identical to `getTimeSpanString(long)`, does not add `ago`.
`static String`	`getTimeSpanString(long duration)` Returns a human readable text of the time duration, for example "3 minutes 40 seconds".
`static String`	`getWin32ErrorMessage(int n)` Gets a human readable message for the given Win32 error code.
`static String`	`getWin32ErrorMessage(IOException e)`
`static String`	`getWin32ErrorMessage(Throwable e)` Extracts the Win32 error message from `Throwable` if possible.
`static <T> T`	`ifOverridden(Supplier<T> supplier, Class<?> base, Class<?> derived, String methodName, Class<?>... types)` Calls the given supplier if the method defined on the base type with the given arguments is overridden in the given derived type.
`static String`	`intern(String s)` Null-safe String intern method.
`static boolean`	`isAbsoluteUri(String uri)` Deprecated. Use `isSafeToRedirectTo(java.lang.String)` instead if your goal is to prevent open redirects
`static boolean`	`isDescendant(File forParent, File potentialChild)` A check if a file path is a descendant of a parent path
`static boolean`	`isOverridden(Class<?> base, Class<?> derived, String methodName, Class<?>... types)` Checks whether the method defined on the base type with the given arguments is overridden in the given derived type.
`static boolean`	`isRelativePath(String path)` A mostly accurate check of whether a path is a relative path or not.
`static boolean`	`isSafeToRedirectTo(String uri)` Return true iff the parameter does not denote an absolute URI and not a scheme-relative URI.
`static boolean`	`isSymlink(File file)` Checks if the given file represents a symlink.
`static boolean`	`isSymlink(Path path)`
`static String`	`join(Collection<?> strings, String separator)` Deprecated. since 2.292; use `String.join(CharSequence, Iterable)`
`static <T> List<T>`	`join(Collection<? extends T>... items)` Combines all the given collections into a single list.
`static String`	`loadFile(File logfile)` Deprecated. call `loadFile(java.io.File, java.nio.charset.Charset)` instead to specify the charset to use for decoding (preferably `StandardCharsets.UTF_8`).
`static String`	`loadFile(File logfile, Charset charset)` Reads the entire contents of the text file at `logfile` into a string using `charset` for decoding.
`static Properties`	`loadProperties(String properties)` Loads a key/value pair string as `Properties`
`static String[]`	`mapToEnv(Map<String,String> m)` Converts the map format of the environment variables to the K=V format in the array.
`static int`	`min(int x, int... values)`
`static Set<PosixFilePermission>`	`modeToPermissions(int mode)`
`static String`	`nullify(String v)`
`static int`	`permissionsToMode(Set<PosixFilePermission> permissions)`
`static String`	`rawEncode(String s)` Encode a single path component for use in an HTTP URL.
`static String`	`removeTrailingSlash(String s)`
`static String`	`replaceMacro(String s, Map<String,String> properties)` Replaces the occurrence of '$key' by `properties.get('key')`.
`static String`	`replaceMacro(String s, VariableResolver<String> resolver)` Replaces the occurrence of '$key' by `resolver.get('key')`.
`static String`	`resolveSymlink(File link)` Resolves symlink, if the given file is a symlink.
`static String`	`resolveSymlink(File link, TaskListener listener)` Deprecated. as of 1.456 Use `resolveSymlink(File)`
`static File`	`resolveSymlinkToFile(File link)` Resolves a symlink to the `File` that points to.
`static String`	`singleQuote(String s)` Surrounds by a single-quote.
`static SecretKey`	`toAes128Key(String s)` Converts a string into 128-bit AES key.
`static String`	`toHexString(byte[] bytes)`
`static String`	`toHexString(byte[] data, int start, int len)`
`static String[]`	`tokenize(String s)`
`static String[]`	`tokenize(String s, String delimiter)` Tokenizes the text separated by delimiters.
`static void`	`touch(File file)` Creates an empty file if nonexistent or truncates the existing file.
`static Number`	`tryParseNumber(String numberStr, Number defaultNumber)` Returns the parsed string if parsed successful; otherwise returns the default number.
`static String`	`wrapToErrorSpan(String s)` Wraps with the error icon and the CSS class to render error message.
`static String`	`xmlEscape(String text)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

XS_DATETIME_FORMATTER

public static final org.apache.commons.lang.time.FastDateFormat XS_DATETIME_FORMATTER

RFC822_DATETIME_FORMATTER

public static final org.apache.commons.lang.time.FastDateFormat RFC822_DATETIME_FORMATTER

NO_SYMLINK
```
public static boolean NO_SYMLINK
```
On Unix environment that cannot run "ln", set this to true.

SYMLINK_ESCAPEHATCH

public static boolean SYMLINK_ESCAPEHATCH

Constructor Detail
- Util
```
public Util()
```

Method Detail

filter

@NonNull
public static <T> List<T> filter(@NonNull
                                          Iterable<?> base,
                                          @NonNull
                                          Class<T> type)

Creates a filtered sublist.

Since:: 1.176

filter

@NonNull
public static <T> List<T> filter(@NonNull
                                          List<?> base,
                                          @NonNull
                                          Class<T> type)

Creates a filtered sublist.

replaceMacro

@Nullable
public static String replaceMacro(@CheckForNull
                                            String s,
                                            @NonNull
                                            Map<String,String> properties)

Replaces the occurrence of '$key' by properties.get('key').

Unlike shell, undefined variables are left as-is (this behavior is the same as Ant.)

replaceMacro

@Nullable
public static String replaceMacro(@CheckForNull
                                            String s,
                                            @NonNull
                                            VariableResolver<String> resolver)

Replaces the occurrence of '$key' by resolver.get('key').

Unlike shell, undefined variables are left as-is (this behavior is the same as Ant.)

loadFile
```
@NonNull
 @Deprecated
public static String loadFile(@NonNull
                                                    File logfile)
                                             throws IOException
```
Deprecated. call loadFile(java.io.File, java.nio.charset.Charset) instead to specify the charset to use for decoding (preferably StandardCharsets.UTF_8).

Reads the entire contents of the text file at logfile into a string using the default charset for decoding. If no such file exists, an empty string is returned.

Parameters:

logfile - The text file to read in its entirety.

Returns:

The entire text content of logfile.

Throws:

IOException - If an error occurs while reading the file.

loadFile
```
@NonNull
public static String loadFile(@NonNull
                                       File logfile,
                                       @NonNull
                                       Charset charset)
                                throws IOException
```
Reads the entire contents of the text file at logfile into a string using charset for decoding. If no such file exists, an empty string is returned.

Parameters:

logfile - The text file to read in its entirety.

charset - The charset to use for decoding the bytes in logfile.

Returns:

The entire text content of logfile.

Throws:

IOException - If an error occurs while reading the file.

deleteContentsRecursive
```
public static void deleteContentsRecursive(@NonNull
                                           File file)
                                    throws IOException
```
Deletes the contents of the given directory (but not the directory itself) recursively. It does not take no for an answer - if necessary, it will have multiple attempts at deleting things.

Throws:

IOException - if the operation fails.

deleteContentsRecursive

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public static void deleteContentsRecursive(@NonNull
                                                                                                                  Path path,
                                                                                                                  @NonNull
                                                                                                                  PathRemover.PathChecker pathChecker)
                                                                                                           throws IOException

Deletes the given directory contents (but not the directory itself) recursively using a PathChecker.

Parameters:: path - a directory to delete; pathChecker - a security check to validate a path before deleting
Throws:: IOException - if the operation fails

deleteFile
```
public static void deleteFile(@NonNull
                              File f)
                       throws IOException
```
Deletes this file (and does not take no for an answer). If necessary, it will have multiple attempts at deleting things.

Parameters:

f - a file to delete

Throws:

IOException - if it exists but could not be successfully deleted

deleteRecursive
```
public static void deleteRecursive(@NonNull
                                   File dir)
                            throws IOException
```
Deletes the given directory (including its contents) recursively. It does not take no for an answer - if necessary, it will have multiple attempts at deleting things.

Throws:

IOException - if the operation fails.

deleteRecursive

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public static void deleteRecursive(@NonNull
                                                                                                          Path dir,
                                                                                                          @NonNull
                                                                                                          PathRemover.PathChecker pathChecker)
                                                                                                   throws IOException

Deletes the given directory and contents recursively using a filter.

Parameters:: dir - a directory to delete; pathChecker - a security check to validate a path before deleting
Throws:: IOException - if the operation fails

isSymlink
```
public static boolean isSymlink(@NonNull
                                File file)
                         throws IOException
```
Checks if the given file represents a symlink. Unlike Files.isSymbolicLink(Path), this method also considers NTFS junction points as symbolic links.

Throws:

IOException

isSymlink

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public static boolean isSymlink(@NonNull
                                                                                                       Path path)

isRelativePath
```
public static boolean isRelativePath(String path)
```
A mostly accurate check of whether a path is a relative path or not. This is designed to take a path against an unknown operating system so may give invalid results.

Parameters:

path - the path.

Returns:

true if the path looks relative.

Since:

1.606

isDescendant
```
public static boolean isDescendant(File forParent,
                                   File potentialChild)
                            throws IOException
```
A check if a file path is a descendant of a parent path

Parameters:

forParent - the parent the child should be a descendant of

potentialChild - the path to check

Returns:

true if so

Throws:

IOException - for invalid paths

Since:

2.80

See Also:

InvalidPathException

createTempDir

public static File createTempDir()
                          throws IOException

Creates a new temporary directory.

Throws:: IOException

displayIOException

public static void displayIOException(@NonNull
                                      IOException e,
                                      @NonNull
                                      TaskListener listener)

On Windows, error messages for IOException aren't very helpful. This method generates additional user-friendly error message to the listener

getWin32ErrorMessage

@CheckForNull
public static String getWin32ErrorMessage(@NonNull
                                                        IOException e)

getWin32ErrorMessage
```
@CheckForNull
public static String getWin32ErrorMessage(Throwable e)
```
Extracts the Win32 error message from Throwable if possible.

Returns:

null if there seems to be no error code or if the platform is not Win32.

getWin32ErrorMessage
```
@CheckForNull
public static String getWin32ErrorMessage(int n)
```
Gets a human readable message for the given Win32 error code.

Returns:

null if no such message is available.

getHostName

@NonNull
public static String getHostName()

Guesses the current host name.

copyStream

@Deprecated
public static void copyStream(@NonNull
                                          InputStream in,
                                          @NonNull
                                          OutputStream out)
                                   throws IOException

Deprecated. Use IOUtils.copy(InputStream, OutputStream)

Throws:: IOException

copyStream

@Deprecated
public static void copyStream(@NonNull
                                          Reader in,
                                          @NonNull
                                          Writer out)
                                   throws IOException

Deprecated. Use IOUtils.copy(Reader, Writer)

Throws:: IOException

copyStreamAndClose

@Deprecated
public static void copyStreamAndClose(@NonNull
                                                  InputStream in,
                                                  @NonNull
                                                  OutputStream out)
                                           throws IOException

Deprecated. Use IOUtils.copy(InputStream, OutputStream) in a try-with-resources block

Throws:: IOException

copyStreamAndClose

@Deprecated
public static void copyStreamAndClose(@NonNull
                                                  Reader in,
                                                  @NonNull
                                                  Writer out)
                                           throws IOException

Deprecated. Use IOUtils.copy(Reader, Writer) in a try-with-resources block

Throws:: IOException

tokenize

@NonNull
public static String[] tokenize(@NonNull
                                         String s,
                                         @CheckForNull
                                         String delimiter)

Tokenizes the text separated by delimiters.

In 1.210, this method was changed to handle quotes like Unix shell does. Before that, this method just used StringTokenizer.

Since:: 1.145
See Also:: QuotedStringTokenizer

tokenize

@NonNull
public static String[] tokenize(@NonNull
                                         String s)

mapToEnv

@NonNull
public static String[] mapToEnv(@NonNull
                                         Map<String,String> m)

Converts the map format of the environment variables to the K=V format in the array.

min

public static int min(int x,
                      @NonNull
                      int... values)

nullify

@CheckForNull
public static String nullify(@CheckForNull
                                           String v)

removeTrailingSlash

@NonNull
public static String removeTrailingSlash(@NonNull
                                                  String s)

ensureEndsWith

@Nullable
public static String ensureEndsWith(@CheckForNull
                                              String subject,
                                              @CheckForNull
                                              String suffix)

Ensure string ends with suffix

Parameters:: subject - Examined string; suffix - Desired suffix
Returns:: Original subject in case it already ends with suffix, null in case subject was null and subject + suffix otherwise.
Since:: 1.505

getDigestOf
```
@NonNull
public static String getDigestOf(@NonNull
                                          InputStream source)
                                   throws IOException
```
Computes MD5 digest of the given input stream. This method should only be used for non-security applications where the MD5 weakness is not a problem.

Parameters:

source - The stream will be closed by this method at the end of this method.

Returns:

32-char wide string

Throws:

IOException

See Also:

DigestUtils.md5Hex(InputStream)

getDigestOf

@NonNull
public static String getDigestOf(@NonNull
                                          String text)

getDigestOf

@NonNull
public static String getDigestOf(@NonNull
                                          File file)
                                   throws IOException

Computes the MD5 digest of a file.

Parameters:: file - a file
Returns:: a 32-character string
Throws:: IOException - in case reading fails
Since:: 1.525

toAes128Key

@NonNull
public static SecretKey toAes128Key(@NonNull
                                             String s)

Converts a string into 128-bit AES key.

Since:: 1.308

toHexString

@NonNull
public static String toHexString(@NonNull
                                          byte[] data,
                                          int start,
                                          int len)

toHexString

@NonNull
public static String toHexString(@NonNull
                                          byte[] bytes)

fromHexString

@NonNull
public static byte[] fromHexString(@NonNull
                                            String data)

getTimeSpanString
```
@NonNull
public static String getTimeSpanString(long duration)
```
Returns a human readable text of the time duration, for example "3 minutes 40 seconds". This version should be used for representing a duration of some activity (like build)

Parameters:

duration - number of milliseconds.

getPastTimeString
```
@Deprecated
 @NonNull
public static String getPastTimeString(long duration)
```
Deprecated. Actually identical to getTimeSpanString(long), does not add ago.

Get a human readable string representing strings like "xxx days ago", which should be used to point to the occurrence of an event in the past.

combine

@NonNull
 @Deprecated
public static String combine(long n,
                                                   @NonNull
                                                   String suffix)

Deprecated. Use individual localization methods instead. See Messages.Util_year(Object) for an example. Deprecated since 2009-06-24, remove method after 2009-12-24.

Combines number and unit, with a plural suffix if needed.

createSubList

@NonNull
public static <T> List<T> createSubList(@NonNull
                                                 Collection<?> source,
                                                 @NonNull
                                                 Class<T> type)

Create a sub-list by only picking up instances of the specified type.

encode
```
@NonNull
public static String encode(@NonNull
                                     String s)
```
Escapes non-ASCII characters in URL.
Note that this methods only escapes non-ASCII but leaves other URL-unsafe characters, such as '#'. rawEncode(String) should generally be used instead, though be careful to pass only a single path component to that method (it will encode /, but this method does not).

rawEncode
```
@NonNull
public static String rawEncode(@NonNull
                                        String s)
```
Encode a single path component for use in an HTTP URL. Escapes all non-ASCII, general unsafe (space and "#%<>[\]^`{|}~) and HTTP special characters (/;:?) as specified in RFC1738. (so alphanumeric and !@$&*()-_=+',. are not encoded) Note that slash (/) is encoded, so the given string should be a single path component used in constructing a URL. Method name inspired by PHP's rawurlencode.

fullEncode
```
@NonNull
public static String fullEncode(@NonNull
                                         String s)
```
Encode a single path component for use in an HTTP URL. Escapes all special characters including those outside of the characters specified in RFC1738. All characters outside numbers and letters without diacritic are encoded. Note that slash (/) is encoded, so the given string should be a single path component used in constructing a URL.

singleQuote

public static String singleQuote(String s)

Surrounds by a single-quote.

escape

@Nullable
public static String escape(@CheckForNull
                                      String text)

Escapes HTML unsafe characters like <, & to the respective character entities.

xmlEscape

@NonNull
public static String xmlEscape(@NonNull
                                        String text)

touch
```
public static void touch(@NonNull
                         File file)
                  throws IOException
```
Creates an empty file if nonexistent or truncates the existing file. Note: The behavior of this method in the case where the file already exists is unlike the POSIX touch utility which merely updates the file's access and/or modification time.

Throws:

IOException

copyFile

@Deprecated
 @Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
 @RestrictedSince(value="2.335")
public static void copyFile(@NonNull
                                                                                                                                                 File src,
                                                                                                                                                 @NonNull
                                                                                                                                                 File dst)
                                                                                                                                          throws org.apache.tools.ant.BuildException

Deprecated. since 2.335; use Files.copy(Path, Path, CopyOption...) directly

Copies a single file by using Ant.

Throws:: org.apache.tools.ant.BuildException

fixNull

@NonNull
public static String fixNull(@CheckForNull
                                      String s)

Convert null to "".

fixNull

@NonNull
public static <T> T fixNull(@CheckForNull
                                     T s,
                                     @NonNull
                                     T defaultValue)

Convert null to a default value.

Parameters:: defaultValue - Default value. It may be immutable or not, depending on the implementation.
Since:: 2.144

fixEmpty

@CheckForNull
public static String fixEmpty(@CheckForNull
                                            String s)

Convert empty string to null.

fixEmptyAndTrim

@CheckForNull
public static String fixEmptyAndTrim(@CheckForNull
                                                   String s)

Convert empty string to null, and trim whitespace.

Since:: 1.154

fixNull

@NonNull
public static <T> List<T> fixNull(@CheckForNull
                                           List<T> l)

Type Parameters:: T - Type of the list.
Parameters:: l - list to check.
Returns:: l if l is not null. An empty immutable list if l is null.

fixNull

@NonNull
public static <T> Set<T> fixNull(@CheckForNull
                                          Set<T> l)

Type Parameters:: T - Type of the set.
Parameters:: l - set to check.
Returns:: l if l is not null. An empty immutable set if l is null.

fixNull

@NonNull
public static <T> Collection<T> fixNull(@CheckForNull
                                                 Collection<T> l)

Type Parameters:: T - Type of the collection.
Parameters:: l - collection to check.
Returns:: l if l is not null. An empty immutable set if l is null.

fixNull

@NonNull
public static <T> Iterable<T> fixNull(@CheckForNull
                                               Iterable<T> l)

Type Parameters:: T - Type of the iterable.
Parameters:: l - iterable to check.
Returns:: l if l is not null. An empty immutable set if l is null.

getFileName

@NonNull
public static String getFileName(@NonNull
                                          String filePath)

Cuts all the leading path portion and get just the file name.

join

@Deprecated
 @NonNull
public static String join(@NonNull
                                                Collection<?> strings,
                                                @NonNull
                                                String separator)

Deprecated. since 2.292; use String.join(CharSequence, Iterable)

Concatenate multiple strings by inserting a separator.

join

@NonNull
public static <T> List<T> join(@NonNull
                                        Collection<? extends T>... items)

Combines all the given collections into a single list.

createFileSet

@NonNull
public static org.apache.tools.ant.types.FileSet createFileSet(@NonNull
                                                                        File baseDir,
                                                                        @NonNull
                                                                        String includes,
                                                                        @CheckForNull
                                                                        String excludes)

Creates Ant FileSet with the base dir and include pattern.

The difference with this and using AbstractFileSet.setIncludes(String) is that this method doesn't treat whitespace as a pattern separator, which makes it impossible to use space in the file path.

Parameters:: includes - String like "foo/bar/*.xml" Multiple patterns can be separated by ',', and whitespace can surround ',' (so that you can write "abc, def" and "abc,def" to mean the same thing.; excludes - Exclusion pattern. Follows the same format as the 'includes' parameter. Can be null.
Since:: 1.172

createFileSet

@NonNull
public static org.apache.tools.ant.types.FileSet createFileSet(@NonNull
                                                                        File baseDir,
                                                                        @NonNull
                                                                        String includes)

createSymlink

public static void createSymlink(@NonNull
                                 File baseDir,
                                 @NonNull
                                 String targetPath,
                                 @NonNull
                                 String symlinkPath,
                                 @NonNull
                                 TaskListener listener)
                          throws InterruptedException

Creates a symlink to targetPath at baseDir+symlinkPath.

If there's a prior symlink at baseDir+symlinkPath, it will be overwritten.

Parameters:: baseDir - Base directory to resolve the 'symlinkPath' parameter.; targetPath - The file that the symlink should point to. Usually relative to the directory of the symlink but may instead be an absolute path.; symlinkPath - Where to create a symlink in (relative to baseDir)
Throws:: InterruptedException

resolveSymlink

@Deprecated
public static String resolveSymlink(File link,
                                                TaskListener listener)
                                         throws InterruptedException,
                                                IOException

Deprecated. as of 1.456 Use resolveSymlink(File)

Throws:: InterruptedException; IOException

resolveSymlinkToFile

@CheckForNull
public static File resolveSymlinkToFile(@NonNull
                                                      File link)
                                               throws InterruptedException,
                                                      IOException

Resolves a symlink to the File that points to.

Returns:: null if the specified file is not a symlink.
Throws:: InterruptedException; IOException

resolveSymlink
```
@CheckForNull
public static String resolveSymlink(@NonNull
                                                  File link)
                                           throws IOException
```
Resolves symlink, if the given file is a symlink. Otherwise return null.
If the resolution fails, report an error.

Returns:

null if the given file is not a symlink. If the symlink is absolute, the returned string is an absolute path. If the symlink is relative, the returned string is that relative representation. The relative path is meant to be resolved from the location of the symlink.

Throws:

IOException

encodeRFC2396
```
@Deprecated
public static String encodeRFC2396(String url)
```
Deprecated. since 2008-05-13. This method is broken (see JENKINS-1666). It should probably be removed but I'm not sure if it is considered part of the public API that needs to be maintained for backwards compatibility. Use encode(String) instead.

Encodes the URL by RFC 2396. I thought there's another spec that refers to UTF-8 as the encoding, but don't remember it right now.

Since:

1.204

wrapToErrorSpan

@NonNull
public static String wrapToErrorSpan(@NonNull
                                              String s)

Wraps with the error icon and the CSS class to render error message.

Since:: 1.173

tryParseNumber

@CheckForNull
public static Number tryParseNumber(@CheckForNull
                                                  String numberStr,
                                                  @CheckForNull
                                                  Number defaultNumber)

Returns the parsed string if parsed successful; otherwise returns the default number. If the string is null, empty or a ParseException is thrown then the defaultNumber is returned.

Parameters:: numberStr - string to parse; defaultNumber - number to return if the string can not be parsed
Returns:: returns the parsed string; otherwise the default number

isOverridden

public static boolean isOverridden(@NonNull
                                   Class<?> base,
                                   @NonNull
                                   Class<?> derived,
                                   @NonNull
                                   String methodName,
                                   @NonNull
                                   Class<?>... types)

Checks whether the method defined on the base type with the given arguments is overridden in the given derived type.

Parameters:: base - The base type.; derived - The derived type.; methodName - The name of the method.; types - The types of the arguments for the method.
Returns:: true when derived provides the specified method other than as inherited from base.
Throws:: IllegalArgumentException - When derived does not derive from base, or when base does not contain the specified method.

ifOverridden
```
public static <T> T ifOverridden(Supplier<T> supplier,
                                 @NonNull
                                 Class<?> base,
                                 @NonNull
                                 Class<?> derived,
                                 @NonNull
                                 String methodName,
                                 @NonNull
                                 Class<?>... types)
```
Calls the given supplier if the method defined on the base type with the given arguments is overridden in the given derived type.

Parameters:

supplier - The supplier to call if the method is indeed overridden.

base - The base type.

derived - The derived type.

methodName - The name of the method.

types - The types of the arguments for the method.

Returns:

true when derived provides the specified method other than as inherited from base.

Throws:

IllegalArgumentException - When derived does not derive from base, or when base does not contain the specified method.

AbstractMethodError - If the derived class doesn't override the given method.

Since:

2.259

changeExtension

@NonNull
public static File changeExtension(@NonNull
                                            File dst,
                                            @NonNull
                                            String ext)

Returns a file name by changing its extension.

Parameters:: ext - For example, ".zip"

intern

@Nullable
public static String intern(@CheckForNull
                                      String s)

Null-safe String intern method.

Returns:: A canonical representation for the string object. Null for null input strings

isAbsoluteUri

@Deprecated
 @RestrictedSince(value="1.651.2 / 2.3")
 @Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public static boolean isAbsoluteUri(@NonNull
                                                                                                                                                                 String uri)

Deprecated. Use isSafeToRedirectTo(java.lang.String) instead if your goal is to prevent open redirects

Return true if the systemId denotes an absolute URI . The same algorithm can be seen in URI, but implementing this by ourselves allow it to be more lenient about escaping of URI.

isSafeToRedirectTo

public static boolean isSafeToRedirectTo(@NonNull
                                         String uri)

Return true iff the parameter does not denote an absolute URI and not a scheme-relative URI.

Since:: 2.3 / 1.651.2

loadProperties

@NonNull
public static Properties loadProperties(@NonNull
                                                 String properties)
                                          throws IOException

Loads a key/value pair string as Properties

Throws:: IOException
Since:: 1.392

closeAndLogFailures

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public static void closeAndLogFailures(@CheckForNull
                                                                                                              Closeable toClose,
                                                                                                              @NonNull
                                                                                                              Logger logger,
                                                                                                              @NonNull
                                                                                                              String closeableName,
                                                                                                              @NonNull
                                                                                                              String closeableOwner)

Closes the item and logs error to the log in the case of error. Logging will be performed on the WARNING level.

Parameters:: toClose - Item to close. Nothing will happen if it is null; logger - Logger, which receives the error; closeableName - Name of the closeable item; closeableOwner - String representation of the closeable holder
Since:: 2.19, but TODO update once un-restricted

permissionsToMode

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public static int permissionsToMode(Set<PosixFilePermission> permissions)

modeToPermissions

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public static Set<PosixFilePermission> modeToPermissions(int mode)
                                                                                                                         throws IOException

Throws:: IOException

fileToPath

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
 @NonNull
public static Path fileToPath(@NonNull
                                                                                                               File file)
                                                                                                        throws IOException

Converts a File into a Path and checks runtime exceptions.

Throws:: IOException - if f.toPath() throws InvalidPathException.

createDirectories
```
@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public static Path createDirectories(@NonNull
                                                                                                            Path dir,
                                                                                                            FileAttribute<?>... attrs)
                                                                                                     throws IOException
```
Create a directory by creating all nonexistent parent directories first.
Unlike Files.createDirectory(java.nio.file.Path, java.nio.file.attribute.FileAttribute<?>...), an exception is not thrown if the directory could not be created because it already exists. Unlike Files.createDirectories(java.nio.file.Path, java.nio.file.attribute.FileAttribute<?>...), an exception is not thrown if the directory (or one of its parents) is a symbolic link.
The attrs parameter contains optional file attributes to set atomically when creating the nonexistent directories. Each file attribute is identified by its FileAttribute.name(). If more than one attribute of the same name is included in the array, then all but the last occurrence is ignored.
If this method fails, then it may do so after creating some, but not all, of the parent directories.

Parameters:

dir - The directory to create.

attrs - An optional list of file attributes to set atomically when creating the directory.

Returns:

The directory.

Throws:

UnsupportedOperationException - If the array contains an attribute that cannot be set atomically when creating the directory.

FileAlreadyExistsException - If dir exists but is not a directory.

IOException - If an I/O error occurs.

See Also:

Files.createDirectories(Path, FileAttribute[])

daysBetween

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public static long daysBetween(@NonNull
                                                                                                      Date a,
                                                                                                      @NonNull
                                                                                                      Date b)

Compute the number of calendar days elapsed since the given date. As it's only the calendar days difference that matter, "11.00pm" to "2.00am the day after" returns 1, even if there are only 3 hours between. As well as "10am" to "2pm" both on the same day, returns 0.

daysElapsedSince

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public static long daysElapsedSince(@NonNull
                                                                                                           Date date)

Returns:: positive number of days between the given date and now
See Also:: daysBetween(Date, Date)

getNearestAncestorOfTypeOrThrow

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
 @NonNull
public static <T> T getNearestAncestorOfTypeOrThrow(@NonNull
                                                                                                                                     org.kohsuke.stapler.StaplerRequest request,
                                                                                                                                     @NonNull
                                                                                                                                     Class<T> clazz)

Find the specific ancestor, or throw an exception. Useful for an ancestor we know is inside the URL to ease readability

Class Util

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

XS_DATETIME_FORMATTER

RFC822_DATETIME_FORMATTER

NO_SYMLINK

SYMLINK_ESCAPEHATCH

Constructor Detail

Util

Method Detail

filter

filter

replaceMacro

replaceMacro

loadFile

loadFile

deleteContentsRecursive

deleteContentsRecursive

deleteFile

deleteRecursive

deleteRecursive

isSymlink

isSymlink

isRelativePath

isDescendant

createTempDir

displayIOException

getWin32ErrorMessage

getWin32ErrorMessage

getWin32ErrorMessage

getHostName

copyStream

copyStream

copyStreamAndClose

copyStreamAndClose

tokenize

tokenize

mapToEnv

min

nullify

removeTrailingSlash

ensureEndsWith

getDigestOf

getDigestOf

getDigestOf

toAes128Key

toHexString

toHexString

fromHexString

getTimeSpanString

getPastTimeString

combine

createSubList

encode

rawEncode

fullEncode

singleQuote

escape

xmlEscape

touch

copyFile

fixNull

fixNull

fixEmpty

fixEmptyAndTrim

fixNull

fixNull

fixNull

fixNull

getFileName

join

join

createFileSet

createFileSet

createSymlink

resolveSymlink

resolveSymlinkToFile