Package org.junit.platform.commons.util
Class PackageUtils
- java.lang.Object
-
- org.junit.platform.commons.util.PackageUtils
-
@API(status=INTERNAL, since="1.0") public final class PackageUtils extends Object
Collection of utilities for working with packages.DISCLAIMER
These utilities are intended solely for usage within the JUnit framework itself. Any usage by external parties is not supported. Use at your own risk!
- Since:
- 1.0
-
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static Optional<String>
getAttribute(Class<?> type, String name)
Get the value of the specified attribute name, specified as a string, or an emptyOptional
if the attribute was not found.static Optional<String>
getAttribute(Class<?> type, Function<Package,String> function)
Get the package attribute for the suppliedtype
using the suppliedfunction
.
-
-
-
Method Detail
-
getAttribute
public static Optional<String> getAttribute(Class<?> type, Function<Package,String> function)
Get the package attribute for the suppliedtype
using the suppliedfunction
.This method only returns a non-empty
Optional
value holder if the class loader for the supplied type created aPackage
object and the supplied function does not returnnull
when applied.- Parameters:
type
- the type to get the package attribute forfunction
- a function that computes the package attribute value (e.g.,Package::getImplementationTitle
); nevernull
- Returns:
- an
Optional
containing the attribute value; nevernull
but potentially empty - Throws:
PreconditionViolationException
- if the supplied type or function isnull
- See Also:
Class.getPackage()
,Package.getImplementationTitle()
,Package.getImplementationVersion()
-
getAttribute
public static Optional<String> getAttribute(Class<?> type, String name)
Get the value of the specified attribute name, specified as a string, or an emptyOptional
if the attribute was not found. The attribute name is case-insensitive.This method also returns an empty
Optional
value holder if any exception is caught while loading the manifest file via the JAR file of the specified type.- Parameters:
type
- the type to get the attribute forname
- the attribute name as a string- Returns:
- an
Optional
containing the attribute value; nevernull
but potentially empty - Throws:
PreconditionViolationException
- if the supplied type isnull
or the specified name is blank- See Also:
Manifest.getMainAttributes()
-
-