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