com.tencent.kona.sun.security.action

Class GetIntegerAction

java.lang.Object

com.tencent.kona.sun.security.action.GetIntegerAction

All Implemented Interfaces:

java.security.PrivilegedAction<java.lang.Integer>

public class GetIntegerAction
extends java.lang.Object
implements java.security.PrivilegedAction<java.lang.Integer>

A convenience class for retrieving the integer value of a system property as a privileged action.

An instance of this class can be used as the argument of AccessController.doPrivileged.

The following code retrieves the integer value of the system property named "prop" as a privileged action. Since it does not pass a default value to be used in case the property "prop" is not defined, it has to check the result for null:

 Integer tmp = java.security.AccessController.doPrivileged
     (new sun.security.action.GetIntegerAction("prop"));
 int i;
 if (tmp != null) {
     i = tmp.intValue();
 }
 

The following code retrieves the integer value of the system property named "prop" as a privileged action, and also passes a default value to be used in case the property "prop" is not defined:

 int i = ((Integer)java.security.AccessController.doPrivileged(
                         new GetIntegerAction("prop", 3))).intValue();
 

Since:

1.2

See Also:

PrivilegedAction, AccessController

Constructor Summary

Constructors

Constructor and Description
GetIntegerAction(java.lang.String theProp) Constructor that takes the name of the system property whose integer value needs to be determined.
GetIntegerAction(java.lang.String theProp, int defaultVal) Constructor that takes the name of the system property and the default value of that property.

Method Summary

Modifier and Type	Method and Description
static java.lang.Integer	privilegedGetProperty(java.lang.String theProp) Convenience method to get a property without going through doPrivileged if no security manager is present.
static java.lang.Integer	privilegedGetProperty(java.lang.String theProp, int defaultVal) Convenience method to get a property without going through doPrivileged if no security manager is present.
java.lang.Integer	run() Determines the integer value of the system property whose name was specified in the constructor.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GetIntegerAction

public GetIntegerAction(java.lang.String theProp)

Constructor that takes the name of the system property whose integer value needs to be determined.

Parameters:

theProp - the name of the system property.

GetIntegerAction

public GetIntegerAction(java.lang.String theProp,
                        int defaultVal)

Constructor that takes the name of the system property and the default value of that property.

Parameters:

theProp - the name of the system property.

defaultVal - the default value.

Method Detail

run

public java.lang.Integer run()

Determines the integer value of the system property whose name was specified in the constructor.

If there is no property of the specified name, or if the property does not have the correct numeric format, then an Integer object representing the default value that was specified in the constructor is returned, or null if no default value was specified.

Specified by:

run in interface java.security.PrivilegedAction<java.lang.Integer>

Returns:

the Integer value of the property.

privilegedGetProperty

public static java.lang.Integer privilegedGetProperty(java.lang.String theProp)

Convenience method to get a property without going through doPrivileged if no security manager is present. This is unsafe for inclusion in a public API but allowable here since this class is now encapsulated. Note that this method performs a privileged action using caller-provided inputs. The caller of this method should take care to ensure that the inputs are not tainted and the returned property is not made accessible to untrusted code if it contains sensitive information.

Parameters:

theProp - the name of the system property.

privilegedGetProperty

public static java.lang.Integer privilegedGetProperty(java.lang.String theProp,
                                                      int defaultVal)

Convenience method to get a property without going through doPrivileged if no security manager is present. This is unsafe for inclusion in a public API but allowable here since this class is now encapsulated. Note that this method performs a privileged action using caller-provided inputs. The caller of this method should take care to ensure that the inputs are not tainted and the returned property is not made accessible to untrusted code if it contains sensitive information.

Parameters:

theProp - the name of the system property.

defaultVal - the default value.