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);
}
}