diff options
Diffstat (limited to 'pki/base/util/src/netscape/security/x509/AVAValueConverter.java')
-rw-r--r-- | pki/base/util/src/netscape/security/x509/AVAValueConverter.java | 69 |
1 files changed, 32 insertions, 37 deletions
diff --git a/pki/base/util/src/netscape/security/x509/AVAValueConverter.java b/pki/base/util/src/netscape/security/x509/AVAValueConverter.java index 87c386f11..8153099c5 100644 --- a/pki/base/util/src/netscape/security/x509/AVAValueConverter.java +++ b/pki/base/util/src/netscape/security/x509/AVAValueConverter.java @@ -22,68 +22,63 @@ import java.io.IOException; import netscape.security.util.DerValue; /** - * Interface for classes that convert a attribute value string to a + * Interface for classes that convert a attribute value string to a * DER encoded ASN.1 value and vice versa. - * The converters are associated with attribute types, such as - * directory string, ia5string, etc. + * The converters are associated with attribute types, such as + * directory string, ia5string, etc. + * + * <P> + * For example, to convert a string, such as an organization name for the "O" attribute to a DerValue, the "O" attribute is mapped to the DirStrConverter which is used to convert the organization name to a DER encoded Directory String which is a DerValue of a ASN.1 PrintableString, T.61String or UniversalString for the organization name. * - * <P>For example, to convert a string, such as an organization name for the - * "O" attribute to a DerValue, the "O" attribute is mapped to the - * DirStrConverter which is used to convert the organization name to a - * DER encoded Directory String which is a DerValue of a ASN.1 PrintableString, - * T.61String or UniversalString for the organization name. - * * @author Lily Hsiao, Slava Galperin at Netscape Communications, Inc. */ -public interface AVAValueConverter -{ +public interface AVAValueConverter { /** * Converts a string to a DER encoded attribute value. * - * @param valueString An AVA value string not encoded in any form. + * @param valueString An AVA value string not encoded in any form. + * + * @return A DerValue object. * - * @return A DerValue object. - * - * @exception IOException if an error occurs during the conversion. + * @exception IOException if an error occurs during the conversion. */ - public DerValue getValue(String valueString) - throws IOException; - + public DerValue getValue(String valueString) + throws IOException; /** - * Converts a string to a DER encoded attribute value. - * Specify the order of DER tags to use if more than one encoding is - * possible. Currently Directory Strings can have different order + * Converts a string to a DER encoded attribute value. + * Specify the order of DER tags to use if more than one encoding is + * possible. Currently Directory Strings can have different order * for backwards compatibility. By 2003 all should be UTF8String. * - * @param valueString An AVA value string not encoded in any form. + * @param valueString An AVA value string not encoded in any form. * - * @return A DerValue object. - * - * @exception IOException if an error occurs during the conversion. + * @return A DerValue object. + * + * @exception IOException if an error occurs during the conversion. */ - public DerValue getValue(String valueString, byte[] tags) - throws IOException; + public DerValue getValue(String valueString, byte[] tags) + throws IOException; /** * Converts a BER encoded value to a DER encoded attribute value. * - * @param berStream A byte array of the BER encoded AVA value. - * @return A DerValue object. + * @param berStream A byte array of the BER encoded AVA value. + * @return A DerValue object. */ - public DerValue getValue(byte[] berStream) - throws IOException; + public DerValue getValue(byte[] berStream) + throws IOException; /** * Converts a DER encoded value to a string, not encoded in any form. * - * @param avaValue A DerValue object. - * - * @return A string for the value or null if it can't be converted. - * + * @param avaValue A DerValue object. + * + * @return A string for the value or null if it can't be converted. + * * @exception IOException if an error occurs during the conversion. */ - public String getAsString(DerValue avaValue) - throws IOException; + public String getAsString(DerValue avaValue) + throws IOException; } |