package org.bouncycastle.asn1.x509;
import java.util.Enumeration;
import java.util.Hashtable;
import java.util.Vector;
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.ASN1TaggedObject;
import org.bouncycastle.asn1.DERSequence;
The extendedKeyUsage object.
extendedKeyUsage ::= SEQUENCE SIZE (1..MAX) OF KeyPurposeId
/**
* The extendedKeyUsage object.
* <pre>
* extendedKeyUsage ::= SEQUENCE SIZE (1..MAX) OF KeyPurposeId
* </pre>
*/
public class ExtendedKeyUsage
extends ASN1Object
{
Hashtable usageTable = new Hashtable();
ASN1Sequence seq;
Return an ExtendedKeyUsage from the passed in tagged object.
Params: - obj – the tagged object containing the ExtendedKeyUsage
- explicit – true if the tagged object should be interpreted as explicitly tagged, false if implicit.
Returns: the ExtendedKeyUsage contained.
/**
* Return an ExtendedKeyUsage from the passed in tagged object.
*
* @param obj the tagged object containing the ExtendedKeyUsage
* @param explicit true if the tagged object should be interpreted as explicitly tagged, false if implicit.
* @return the ExtendedKeyUsage contained.
*/
public static ExtendedKeyUsage getInstance(
ASN1TaggedObject obj,
boolean explicit)
{
return getInstance(ASN1Sequence.getInstance(obj, explicit));
}
Return an ExtendedKeyUsage from the passed in object.
Params: - obj – an ExtendedKeyUsage, some form or encoding of one, or null.
Returns: an ExtendedKeyUsage object, or null if null is passed in.
/**
* Return an ExtendedKeyUsage from the passed in object.
*
* @param obj an ExtendedKeyUsage, some form or encoding of one, or null.
* @return an ExtendedKeyUsage object, or null if null is passed in.
*/
public static ExtendedKeyUsage getInstance(
Object obj)
{
if (obj instanceof ExtendedKeyUsage)
{
return (ExtendedKeyUsage)obj;
}
else if (obj != null)
{
return new ExtendedKeyUsage(ASN1Sequence.getInstance(obj));
}
return null;
}
Retrieve an ExtendedKeyUsage for a passed in Extensions object, if present.
Params: - extensions – the extensions object to be examined.
Returns: the ExtendedKeyUsage, null if the extension is not present.
/**
* Retrieve an ExtendedKeyUsage for a passed in Extensions object, if present.
*
* @param extensions the extensions object to be examined.
* @return the ExtendedKeyUsage, null if the extension is not present.
*/
public static ExtendedKeyUsage fromExtensions(Extensions extensions)
{
return ExtendedKeyUsage.getInstance(extensions.getExtensionParsedValue(Extension.extendedKeyUsage));
}
Base constructor, from a single KeyPurposeId.
Params: - usage – the keyPurposeId to be included.
/**
* Base constructor, from a single KeyPurposeId.
*
* @param usage the keyPurposeId to be included.
*/
public ExtendedKeyUsage(
KeyPurposeId usage)
{
this.seq = new DERSequence(usage);
this.usageTable.put(usage, usage);
}
private ExtendedKeyUsage(
ASN1Sequence seq)
{
this.seq = seq;
Enumeration e = seq.getObjects();
while (e.hasMoreElements())
{
ASN1Encodable o = (ASN1Encodable)e.nextElement();
if (!(o.toASN1Primitive() instanceof ASN1ObjectIdentifier))
{
throw new IllegalArgumentException("Only ASN1ObjectIdentifiers allowed in ExtendedKeyUsage.");
}
this.usageTable.put(o, o);
}
}
Base constructor, from multiple KeyPurposeIds.
Params: - usages – an array of KeyPurposeIds.
/**
* Base constructor, from multiple KeyPurposeIds.
*
* @param usages an array of KeyPurposeIds.
*/
public ExtendedKeyUsage(
KeyPurposeId[] usages)
{
ASN1EncodableVector v = new ASN1EncodableVector();
for (int i = 0; i != usages.length; i++)
{
v.add(usages[i]);
this.usageTable.put(usages[i], usages[i]);
}
this.seq = new DERSequence(v);
}
Deprecated: use KeyPurposeId[] constructor.
/**
* @deprecated use KeyPurposeId[] constructor.
*/
public ExtendedKeyUsage(
Vector usages)
{
ASN1EncodableVector v = new ASN1EncodableVector();
Enumeration e = usages.elements();
while (e.hasMoreElements())
{
KeyPurposeId o = KeyPurposeId.getInstance(e.nextElement());
v.add(o);
this.usageTable.put(o, o);
}
this.seq = new DERSequence(v);
}
Return true if this ExtendedKeyUsage object contains the passed in keyPurposeId.
Params: - keyPurposeId – the KeyPurposeId of interest.
Returns: true if the keyPurposeId is present, false otherwise.
/**
* Return true if this ExtendedKeyUsage object contains the passed in keyPurposeId.
*
* @param keyPurposeId the KeyPurposeId of interest.
* @return true if the keyPurposeId is present, false otherwise.
*/
public boolean hasKeyPurposeId(
KeyPurposeId keyPurposeId)
{
return (usageTable.get(keyPurposeId) != null);
}
Returns all extended key usages.
Returns: An array with all key purposes.
/**
* Returns all extended key usages.
*
* @return An array with all key purposes.
*/
public KeyPurposeId[] getUsages()
{
KeyPurposeId[] temp = new KeyPurposeId[seq.size()];
int i = 0;
for (Enumeration it = seq.getObjects(); it.hasMoreElements();)
{
temp[i++] = KeyPurposeId.getInstance(it.nextElement());
}
return temp;
}
Return the number of KeyPurposeIds present in this ExtendedKeyUsage.
Returns: the number of KeyPurposeIds
/**
* Return the number of KeyPurposeIds present in this ExtendedKeyUsage.
*
* @return the number of KeyPurposeIds
*/
public int size()
{
return usageTable.size();
}
Return the ASN.1 primitive form of this object.
Returns: an ASN1Sequence.
/**
* Return the ASN.1 primitive form of this object.
*
* @return an ASN1Sequence.
*/
public ASN1Primitive toASN1Primitive()
{
return seq;
}
}