Merge "Merge remote-tracking branch 'aosp/upstream-master' into merge-152-from-upstream"

1 files changed, 35 insertions, 0 deletions

diff --git a/bcpkix/src/main/java/org/bouncycastle/operator/AlgorithmNameFinder.java b/bcpkix/src/main/java/org/bouncycastle/operator/AlgorithmNameFinder.java
new file mode 100644
index 0000000..c196cfc
--- /dev/null
+++ b/bcpkix/src/main/java/org/bouncycastle/operator/AlgorithmNameFinder.java
@@ -0,0 +1,35 @@
+package org.bouncycastle.operator;
+
+import org.bouncycastle.asn1.ASN1ObjectIdentifier;
+import org.bouncycastle.asn1.x509.AlgorithmIdentifier;
+
+/**
+ * General finder for converting OIDs and AlgorithmIdentifiers into strings.
+ */
+public interface AlgorithmNameFinder
+{
+    /**
+     * Return true if the passed in objectIdentifier has a "human friendly" name associated with it.
+     *
+     * @param objectIdentifier the OID of interest.
+     * @boolean true if a name lookup exists for the OID, false otherwise.
+     */
+    boolean hasAlgorithmName(ASN1ObjectIdentifier objectIdentifier);
+
+    /**
+     * Return a string representation of the passed in objectIdentifier.
+     *
+     * @param objectIdentifier the OID of interest.
+     * @return a "human friendly" representation of the OID, the OID as a string if none available.
+     */
+    String getAlgorithmName(ASN1ObjectIdentifier objectIdentifier);
+
+    /**
+     * Return a string representation of the passed in AlgorithmIdentifier, based on the OID in the AlgorithmField, with the parameters
+     * included where appropriate.
+     *
+     * @param algorithmIdentifier the AlgorithmIdentifier of interest.
+     * @return a "human friendly" representation of the algorithmIdentifier, the identifiers OID as a string if none available.
+     */
+    String getAlgorithmName(AlgorithmIdentifier algorithmIdentifier);
+}