// Copyright (c) 2002 Graz University of Technology. All rights reserved. // // Redistribution and use in source and binary forms, with or without modification, // are permitted provided that the following conditions are met: // // 1. Redistributions of source code must retain the above copyright notice, this // list of conditions and the following disclaimer. // // 2. Redistributions in binary form must reproduce the above copyright notice, // this list of conditions and the following disclaimer in the documentation // and/or other materials provided with the distribution. // // 3. The end-user documentation included with the redistribution, if any, must // include the following acknowledgment: // // "This product includes software developed by IAIK of Graz University of // Technology." // // Alternately, this acknowledgment may appear in the software itself, if and // wherever such third-party acknowledgments normally appear. // // 4. The names "Graz University of Technology" and "IAIK of Graz University of // Technology" must not be used to endorse or promote products derived from this // software without prior written permission. // // 5. Products derived from this software may not be called "IAIK PKCS Wrapper", // nor may "IAIK" appear in their name, without prior written permission of // Graz University of Technology. // // THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED // WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED // WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR // PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE LICENSOR BE // LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, // OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, // OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON // ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, // OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY // OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE // POSSIBILITY OF SUCH DAMAGE. package iaik.pkcs.pkcs11.objects; import iaik.pkcs.pkcs11.wrapper.CK_ATTRIBUTE; import iaik.pkcs.pkcs11.wrapper.Constants; import java.util.ArrayList; import java.util.Enumeration; import java.util.List; /** * Objects of this class represent a attribute array of a PKCS#11 object * as specified by PKCS#11. This attribute is available since * cryptoki version 2.20. * * * @author Birgit Haas * @version 1.0 * @invariants */ public class AttributeArray extends Attribute { /** * The attributes of this attribute array in their object class representation. * Needed for printing and comparing this attribute array. */ protected Object template_; /** * Default constructor - only for internal use. */ AttributeArray() { super(); } /** * Constructor taking the PKCS#11 type of the attribute. * * @param type The PKCS#11 type of this attribute; e.g. * PKCS11Constants.CKA_VALUE. * @preconditions (type <> null) * @postconditions */ public AttributeArray(Long type) { super(type); } /** * Set the attributes of this attribute array by specifying a GenericTemplate. * Null, is also valid. * A call to this method sets the present flag to true. * * @param value The AttributeArray value to set. May be null. * @preconditions * @postconditions */ public void setAttributeArrayValue(Object value) { template_ = value; List attributeList = new ArrayList(); Enumeration attributeEnumeration = template_.attributeTable_.elements(); while (attributeEnumeration.hasMoreElements()) { Attribute attribute = (Attribute) attributeEnumeration.nextElement(); if (attribute.present_) { attributeList.add(attribute.getCkAttribute()); } } ckAttribute_.pValue = (CK_ATTRIBUTE[]) attributeList.toArray(new CK_ATTRIBUTE[0]);; present_ = true; } /** * Get the attribute array value of this attribute. Null, is also possible. * * @return The attribute array value of this attribute or null. * @preconditions * @postconditions */ public Object getAttributeArrayValue() { if (template_ == null) { if (ckAttribute_.pValue != null && ((CK_ATTRIBUTE[]) ckAttribute_.pValue).length > 0) { CK_ATTRIBUTE[] attributesArray = (CK_ATTRIBUTE[]) ckAttribute_.pValue; GenericTemplate template = new GenericTemplate(); for (int i = 0; i < attributesArray.length; i++) { Long type = new Long(attributesArray[i].type); Class implementation = (Class) Attribute.getAttributeClass(type); Attribute attribute; if (implementation == null) { attribute = new OtherAttribute(); attribute.setType(type); attribute.setCkAttribute(attributesArray[i]); } else { try { attribute = (Attribute) implementation.newInstance(); attribute.setCkAttribute(attributesArray[i]); attribute.setPresent(true); template.addAttribute(attribute); } catch (Exception ex) { System.err.println("Error when trying to create a " + implementation + " instance for " + type + ": " + ex.getMessage()); System.err.flush(); continue; } } } return template; } else { return null; } } else { return template_; } } /** * Get a string representation of the value of this attribute. * * @return A string representation of the value of this attribute. * @preconditions * @postconditions (result <> null) */ protected String getValueString() { String valueString = ""; if (template_ == null) template_ = getAttributeArrayValue(); if (template_ == null) { valueString = ""; } else { String indent = Constants.INDENT + Constants.INDENT + Constants.INDENT; valueString += template_.toString(true, true, indent); } return valueString; } /** * Compares all member variables of this object with the other object. * Returns only true, if all are equal in both objects. * * @param otherObject The other object to compare to. * @return True, if other is an instance of this class and all member * variables of both objects are equal. False, otherwise. * @preconditions * @postconditions */ public boolean equals(java.lang.Object otherObject) { boolean equal = false; if (otherObject instanceof AttributeArray) { AttributeArray other = (AttributeArray) otherObject; if (this.template_ == null) this.template_ = this.getAttributeArrayValue(); if (other.template_ == null) other.template_ = other.getAttributeArrayValue(); equal = (this == other) || (((this.present_ == false) && (other.present_ == false)) || (((this.present_ == true) && (other.present_ == true)) && ((this.sensitive_ == other.sensitive_) && (this.template_ .equals(other.template_))))); } return equal; } /** * The overriding of this method should ensure that the objects of this class * work correctly in a hashtable. * * @return The hash code of this object. * @preconditions * @postconditions */ public int hashCode() { if (template_ == null) template_ = getAttributeArrayValue(); return template_.hashCode(); } /** * Create a (deep) clone of this object. * The attributes in the CK_ATTRIBUTE[] need not be cloned, as they can't be set * separately. * * @return A clone of this object. * @preconditions * @postconditions (result <> null) * and (result instanceof AttributeArray) * and (result.equals(this)) */ public java.lang.Object clone() { AttributeArray clone; clone = (AttributeArray) super.clone(); if (template_ == null) template_ = getAttributeArrayValue(); if (template_ != null) clone.template_ = (GenericTemplate) this.template_.clone(); return clone; } /* (non-Javadoc) * @see iaik.pkcs.pkcs11.objects.Attribute#setValue(java.lang.Object) */ public void setValue(java.lang.Object value) throws UnsupportedOperationException { setAttributeArrayValue((Object) value); } }