Class PropertiesHelper
java.lang.Object
org.glassfish.jersey.internal.util.PropertiesHelper
Helper class containing convenience methods for reading
org.glassfish.jersey.server.ResourceConfig
and Configuration
properties.-
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic <T> T
convertValue
(Object value, Class<T> type) ConvertObject
value to a value of the specified class type.private static Object
static String
getPropertyNameForRuntime
(String key, javax.ws.rs.RuntimeType runtimeType) Returns specific property value for givenRuntimeType
.static PrivilegedAction
<Properties> Get system properties.static PrivilegedAction
<String> getSystemProperty
(String name) Get system property.static PrivilegedAction
<String> getSystemProperty
(String name, String def) Get system property.static <T> T
Returns value of a specified property.static <T> T
getValue
(Map<String, ?> properties, String key, T defaultValue, Class<T> type, Map<String, String> legacyMap) Returns value of a specified property.static <T> T
Return value of a specified property.static <T> T
getValue
(Map<String, ?> properties, javax.ws.rs.RuntimeType runtimeType, String key, Class<T> type, Map<String, String> legacyMap) Returns value of a specified property.static <T> T
getValue
(Map<String, ?> properties, javax.ws.rs.RuntimeType runtimeType, String key, T defaultValue, Class<T> type, Map<String, String> legacyMap) Returns value of a specified property.static <T> T
getValue
(Map<String, ?> properties, javax.ws.rs.RuntimeType runtimeType, String key, T defaultValue, Map<String, String> legacyMap) Return value of a specified property.static boolean
isProperty
(Object value) Get the value of the property converted toboolean
.static boolean
isProperty
(Map<String, Object> properties, String name) Get the value of the property with a given name converted toboolean
.
-
Field Details
-
LOGGER
-
-
Constructor Details
-
PropertiesHelper
private PropertiesHelper()Prevent instantiation.
-
-
Method Details
-
getSystemProperties
Get system properties. This method delegates toSystem.getProperties()
while running it in a privileged code block.- Returns:
- privileged action to obtain system properties.
-
getSystemProperty
Get system property. This method delegates toSystem.getProperty(String)
while running it in a privileged code block.- Parameters:
name
- system property name.- Returns:
- privileged action to obtain system property value that will return
null
if there's no such system property.
-
getSystemProperty
Get system property. This method delegates toSystem.getProperty(String)
while running it in a privileged code block.- Parameters:
name
- system property name.def
- default property value.- Returns:
- privileged action to obtain system property value that will return the default value if there's no such system property.
-
getValue
public static <T> T getValue(Map<String, ?> properties, String key, T defaultValue, Map<String, String> legacyMap) Return value of a specified property. If the property is not set or the real value type is not compatible with defaultValue type, the specified defaultValue is returned. Calling this method is equivalent to callingPropertyHelper.getValue(properties, key, defaultValue, (Class<T>) defaultValue.getClass())
- Type Parameters:
T
- Type of the property value.- Parameters:
properties
- Map of properties to get the property value from.key
- Name of the property.defaultValue
- Default value to be returned if the specified property is not set or cannot be read.legacyMap
- Legacy fallback map, where key is the actual property name, value is the old property name- Returns:
- Value of the property or defaultValue.
-
getValue
public static <T> T getValue(Map<String, ?> properties, javax.ws.rs.RuntimeType runtimeType, String key, T defaultValue, Map<String, String> legacyMap) Return value of a specified property. If the property is not set or the real value type is not compatible with defaultValue type, the specified defaultValue is returned. Calling this method is equivalent to callingPropertyHelper.getValue(properties, runtimeType, key, defaultValue, (Class<T>) defaultValue.getClass())
- Type Parameters:
T
- Type of the property value.- Parameters:
properties
- Map of properties to get the property value from.runtimeType
- Runtime type which is used to check whether there is a property with the samekey
but post-fixed by runtime type (.server or.client
) which would override thekey
property.key
- Name of the property.defaultValue
- Default value to be returned if the specified property is not set or cannot be read.legacyMap
- Legacy fallback map, where key is the actual property name, value is the old property name- Returns:
- Value of the property or defaultValue.
-
getValue
public static <T> T getValue(Map<String, ?> properties, String key, T defaultValue, Class<T> type, Map<String, String> legacyMap) Returns value of a specified property. If the property is not set or the real value type is not compatible with the specified value type, returns defaultValue.- Type Parameters:
T
- Type of the property value.- Parameters:
properties
- Map of properties to get the property value from.key
- Name of the property.defaultValue
- Default value of the property.type
- Type to retrieve the value as.legacyMap
- Legacy fallback map, where key is the actual property name, value is the old property name- Returns:
- Value of the property or null.
-
getValue
public static <T> T getValue(Map<String, ?> properties, javax.ws.rs.RuntimeType runtimeType, String key, T defaultValue, Class<T> type, Map<String, String> legacyMap) Returns value of a specified property. If the property is not set or the real value type is not compatible with the specified value type, returns defaultValue.- Type Parameters:
T
- Type of the property value.- Parameters:
properties
- Map of properties to get the property value from.runtimeType
- Runtime type which is used to check whether there is a property with the samekey
but post-fixed by runtime type (.server or.client
) which would override thekey
property.key
- Name of the property.defaultValue
- Default value of the property.type
- Type to retrieve the value as.legacyMap
- Legacy fallback map, where key is the actual property name, value is the old property name- Returns:
- Value of the property or null.
-
getValue
public static <T> T getValue(Map<String, ?> properties, String key, Class<T> type, Map<String, String> legacyMap) Returns value of a specified property. If the property is not set or the real value type is not compatible with the specified value type, returns null.- Type Parameters:
T
- Type of the property value.- Parameters:
properties
- Map of properties to get the property value from.key
- Name of the property.type
- Type to retrieve the value as.legacyMap
- Legacy fallback map, where key is the actual property name, value is the old property name- Returns:
- Value of the property or null.
-
getValue
public static <T> T getValue(Map<String, ?> properties, javax.ws.rs.RuntimeType runtimeType, String key, Class<T> type, Map<String, String> legacyMap) Returns value of a specified property. If the property is not set or the real value type is not compatible with the specified value type, returns null.- Type Parameters:
T
- Type of the property value.- Parameters:
properties
- Map of properties to get the property value from.runtimeType
- Runtime type which is used to check whether there is a property with the samekey
but post-fixed by runtime type (.server or.client
) which would override thekey
property.key
- Name of the property.type
- Type to retrieve the value as.- Returns:
- Value of the property or null.
-
getPropertyNameForRuntime
Returns specific property value for givenRuntimeType
. Some properties have complementary client and server versions along with a common version (effective for both environments, if the specific one is not set). This methods returns a specific name for the environment (determined by convention), if runtime is not null, the property is a Jersey property name (starts withjersey.config
) and does not contain a runtime specific part already. If those conditions are not met, original property name is returned.- Parameters:
key
- property nameruntimeType
- runtime type- Returns:
- runtime-specific property name, where possible, original key in other cases. original key
-
getLegacyFallbackValue
-
convertValue
ConvertObject
value to a value of the specified class type.- Type Parameters:
T
- converted value type.- Parameters:
value
-Object
value to convert.type
- conversion type.- Returns:
- value converted to the specified class type.
-
isProperty
Get the value of the property with a given name converted toboolean
. Returnsfalse
if the value is not convertible.- Parameters:
properties
- key-value map of properties.name
- property name.- Returns:
boolean
property value orfalse
if the property is not convertible.
-
isProperty
Get the value of the property converted toboolean
. Returnsfalse
if the value is not convertible.- Parameters:
value
- property value.- Returns:
boolean
property value orfalse
if the property is not convertible.
-