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 | 73 |
1 files changed, 39 insertions, 34 deletions
diff --git a/pki/base/util/src/netscape/security/x509/AVAValueConverter.java b/pki/base/util/src/netscape/security/x509/AVAValueConverter.java index 5c60e32cf..87c386f11 100644 --- a/pki/base/util/src/netscape/security/x509/AVAValueConverter.java +++ b/pki/base/util/src/netscape/security/x509/AVAValueConverter.java @@ -22,63 +22,68 @@ import java.io.IOException; import netscape.security.util.DerValue; /** - * 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. - * - * <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. + * 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. * + * <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. - * - * @return A DerValue object. + * @param valueString An AVA value string not encoded in any form. * - * @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) 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 for backwards compatibility. - * By 2003 all should be UTF8String. + * 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; } |