com.safenetinc.jcprov

Class CK_ATTRIBUTE

java.lang.Object

com.safenetinc.jcprov.CK_ATTRIBUTE

public class CK_ATTRIBUTE
extends java.lang.Object

Class to contain the type, value and length of an attribute.

Further information is provided in the PKCS#11 standard and the SDK Reference Guide.

See Also:

CKA

Field Summary

Fields

Modifier and Type	Field and Description
java.lang.Object	pValue Value of this attribute.
CK_ATTRIBUTE_TYPE	type Type of this attribute.
long	valueLen Amount of data referenced by pValue.

Constructor Summary

Constructors

Constructor and Description
CK_ATTRIBUTE() Values initialised to 0 or null.
CK_ATTRIBUTE(CK_ATTRIBUTE_TYPE type, long value) Intercept primitive long constant being passed in to avoid JVM caching issue see: Long::valueOf public static Long valueOf?(long l) Returns a Long instance representing the specified long value.
CK_ATTRIBUTE(CK_ATTRIBUTE_TYPE type, java.lang.Long value) Intercept Long being passed in to avoid JVM caching issue (see above)
CK_ATTRIBUTE(CK_ATTRIBUTE_TYPE type, java.lang.Object pValue) The type of the pValue is examined, and if supported, then the valueLen is determined.
CK_ATTRIBUTE(CK_ATTRIBUTE_TYPE type, java.lang.Object pValue, long valueLen) Values initialised as specified.

Method Summary

Methods

Modifier and Type	Method and Description
static long	getAttributeValueSize(java.lang.Object pValue) Determine the size in bytes of the attribute value, if supported.
static boolean	updateAttribute(CK_ATTRIBUTE attr, CK_ATTRIBUTE_TYPE type, java.lang.Object pValue) Updates the specified attribute, include type, value and length.

Methods inherited from class java.lang.Object

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

Field Detail

type

public CK_ATTRIBUTE_TYPE type

Type of this attribute.

See Also:

CKA

pValue

public java.lang.Object pValue

Value of this attribute.
Typically one of :-
Long
byte[]
Boolean
String
CK_DATE

valueLen

public long valueLen

Amount of data referenced by pValue.

Constructor Detail

CK_ATTRIBUTE

public CK_ATTRIBUTE()

Values initialised to 0 or null.

CK_ATTRIBUTE

public CK_ATTRIBUTE(CK_ATTRIBUTE_TYPE type,
            java.lang.Object pValue,
            long valueLen)

Values initialised as specified.

Parameters:

type - attribute type

pValue - attribute value

valueLen - length of attribute value

CK_ATTRIBUTE

public CK_ATTRIBUTE(CK_ATTRIBUTE_TYPE type,
            java.lang.Object pValue)

The type of the pValue is examined, and if supported, then the valueLen is determined.

Parameters:

type - attribute type

pValue - attribute value

CK_ATTRIBUTE

public CK_ATTRIBUTE(CK_ATTRIBUTE_TYPE type,
            long value)

Intercept primitive long constant being passed in to avoid JVM caching issue see: Long::valueOf public static Long valueOf?(long l) Returns a Long instance representing the specified long value. If a new Long instance is not required, this method should generally be used in preference to the constructor Long(long), as this method is likely to yield significantly better space and time performance by caching frequently requested values. This method will always cache values in the range -128 to 127, inclusive, and may cache other values outside of this range. Parameters: l - a long value. Returns: a Long instance representing l. Since: 1.5

Parameters:

type -

value -

CK_ATTRIBUTE

public CK_ATTRIBUTE(CK_ATTRIBUTE_TYPE type,
            java.lang.Long value)

Intercept Long being passed in to avoid JVM caching issue (see above)

Parameters:

type -

value -

Method Detail

getAttributeValueSize

public static long getAttributeValueSize(java.lang.Object pValue)

Determine the size in bytes of the attribute value, if supported.

Parameters:

pValue - value

Returns:

the attribute value length. See Mappings Mappings :-

• byte[] byte[].length
• String String.length()
• Long 4
• CK_BBOOL 1
• CK_DATE 8
• CK_OBJECT_HANDLE 4
• CK_CERTIFICATE_TYPE 4
• CK_HW_FEATURE_TYPE 4
• CK_KEY_TYPE 4
• CK_MECHANISM_TYPE 4
• CK_OBJECT_CLASS 4
• CK_RSA_PKCS_OAEP_SOURCE_TYPE 4
• CK_STATE 4
• CK_USER_TYPE 4
• else 0

updateAttribute

public static boolean updateAttribute(CK_ATTRIBUTE attr,
                      CK_ATTRIBUTE_TYPE type,
                      java.lang.Object pValue)

Updates the specified attribute, include type, value and length.

Parameters:

attr - the attribute

type - the attribute type

pValue - the attribute value The type of the pValue is examined, and if supported, then the valueLen is determined.

Returns:

true otherwise throws Exception