package org.bouncycastle.asn1.cms; import org.bouncycastle.asn1.ASN1Encodable; import org.bouncycastle.asn1.ASN1EncodableVector; import org.bouncycastle.asn1.ASN1Object; import org.bouncycastle.asn1.ASN1ObjectIdentifier; import org.bouncycastle.asn1.ASN1Primitive; import org.bouncycastle.asn1.ASN1Sequence; import org.bouncycastle.asn1.ASN1Set; import org.bouncycastle.asn1.DERSequence; /** * <a href="http://tools.ietf.org/html/rfc5652#page-14">RFC 5652</a>: * Attribute is a pair of OID (as type identifier) + set of values. * <p> * <pre> * Attribute ::= SEQUENCE { * attrType OBJECT IDENTIFIER, * attrValues SET OF AttributeValue * } * * AttributeValue ::= ANY * </pre> * <p> * General rule on values is that same AttributeValue must not be included * multiple times into the set. That is, if the value is a SET OF INTEGERs, * then having same value repeated is wrong: (1, 1), but different values is OK: (1, 2). * Normally the AttributeValue syntaxes are more complicated than that. * <p> * General rule of Attribute usage is that the {@link Attributes} containers * must not have multiple Attribute:s with same attrType (OID) there. */ public class Attribute extends ASN1Object { private ASN1ObjectIdentifier attrType; private ASN1Set attrValues; /** * Return an Attribute object from the given object. * <p> * Accepted inputs: * <ul> * <li> null → null * <li> {@link Attribute} object * <li> {@link org.bouncycastle.asn1.ASN1Sequence#getInstance(java.lang.Object) ASN1Sequence} input formats with Attribute structure inside * </ul> * * @param o the object we want converted. * @exception IllegalArgumentException if the object cannot be converted. */ public static Attribute getInstance( Object o) { if (o instanceof Attribute) { return (Attribute)o; } if (o != null) { return new Attribute(ASN1Sequence.getInstance(o)); } return null; } private Attribute( ASN1Sequence seq) { attrType = (ASN1ObjectIdentifier)seq.getObjectAt(0); attrValues = (ASN1Set)seq.getObjectAt(1); } public Attribute( ASN1ObjectIdentifier attrType, ASN1Set attrValues) { this.attrType = attrType; this.attrValues = attrValues; } public ASN1ObjectIdentifier getAttrType() { return attrType; } public ASN1Set getAttrValues() { return attrValues; } public ASN1Encodable[] getAttributeValues() { return attrValues.toArray(); } /** * Produce an object suitable for an ASN1OutputStream. */ public ASN1Primitive toASN1Primitive() { ASN1EncodableVector v = new ASN1EncodableVector(); v.add(attrType); v.add(attrValues); return new DERSequence(v); } }