com.jn.langx.asn1.spec

类 ASN1PrintableString

java.lang.Object

com.jn.langx.asn1.spec.ASN1Element

com.jn.langx.asn1.spec.ASN1PrintableString

所有已实现的接口:

Serializable

public final class ASN1PrintableString
extends ASN1Element

This class provides an ASN.1 printable string element that can hold any empty or non-empty string comprised only of the characters listed below.

• The uppercase ASCII letters A through Z.
• The lowercase ASCII letters a through z.
• The ASCII digits 0 through 9.
• The ASCII space.
• The ASCII apostrophe (aka single quote).
• The ASCII left parenthesis.
• The ASCII right parenthesis.
• The ASCII plus sign.
• The ASCII comma.
• The ASCII minus sign (aka hyphen).
• The ASCII period (aka full stop).
• The ASCII forward slash (aka solidus).
• The ASCII colon.
• The ASCII equal sign.
• The ASCII question mark.

另请参阅:

序列化表格

构造器概要

构造器

构造器和说明
ASN1PrintableString(byte type, String stringValue) Creates a new ASN.1 printable string element with the specified BER type and the provided value.
ASN1PrintableString(String stringValue) Creates a new ASN.1 printable string element with the default BER type and the provided value.

方法概要

限定符和类型	方法和说明
static ASN1PrintableString	decodeAsPrintableString(ASN1Element element) Decodes the provided ASN.1 element as a printable string element.
static ASN1PrintableString	decodeAsPrintableString(byte[] elementBytes) Decodes the contents of the provided byte array as a printable string element.
static boolean	isPrintableString(byte[] b) Indicates whether the contents of the provided byte array represent a printable LDAP string, as per RFC 4517 section 3.2.
String	stringValue() Retrieves the string value for this element.
void	toString(StringBuilder buffer) Appends a string representation of the value for this ASN.1 element to the provided buffer.

从类继承的方法 com.jn.langx.asn1.spec.ASN1Element

decode, decodeAsBigInteger, decodeAsBitString, decodeAsBoolean, decodeAsEnumerated, decodeAsGeneralizedTime, decodeAsIA5String, decodeAsInteger, decodeAsLong, decodeAsNull, decodeAsNumericString, decodeAsObjectIdentifier, decodeAsOctetString, decodeAsPrintableString, decodeAsSequence, decodeAsSet, decodeAsUTCTime, decodeAsUTF8String, encode, encodeLength, encodeTo, equals, equalsIgnoreType, getType, getTypeClass, getValue, getValueLength, hashCode, isConstructed, readFrom, readFrom, toString, writeTo

从类继承的方法 java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

构造器详细资料

ASN1PrintableString

public ASN1PrintableString(@Nullable
                           String stringValue)
                    throws ASN1Exception

Creates a new ASN.1 printable string element with the default BER type and the provided value.

参数:

stringValue - The string value to use for this element. It may be null or empty if the value should be empty. It must only contain characters allowed in printable strings.

抛出:

ASN1Exception - If the provided string does not represent a valid printable string.

ASN1PrintableString

public ASN1PrintableString(byte type,
                           @Nullable
                           String stringValue)
                    throws ASN1Exception

Creates a new ASN.1 printable string element with the specified BER type and the provided value.

参数:

type - The BER type for this element.

stringValue - The string value to use for this element. It may be null or empty if the value should be empty. It must only contain characters allowed in printable strings.

抛出:

ASN1Exception - If the provided string does not represent a valid printable string.

方法详细资料

stringValue

@NonNull
public String stringValue()

Retrieves the string value for this element.

返回:

The string value for this element.

decodeAsPrintableString

@NonNull
public static ASN1PrintableString decodeAsPrintableString(@NonNull
                                                                    byte[] elementBytes)
                                                             throws ASN1Exception

Decodes the contents of the provided byte array as a printable string element.

参数:

elementBytes - The byte array to decode as an ASN.1 printable string element.

返回:

The decoded ASN.1 printable string element.

抛出:

ASN1Exception - If the provided array cannot be decoded as a printable string element.

decodeAsPrintableString

@NonNull
public static ASN1PrintableString decodeAsPrintableString(@NonNull
                                                                    ASN1Element element)
                                                             throws ASN1Exception

Decodes the provided ASN.1 element as a printable string element.

参数:

element - The ASN.1 element to be decoded.

返回:

The decoded ASN.1 printable string element.

抛出:

ASN1Exception - If the provided element cannot be decoded as a printable string element.

isPrintableString

public static boolean isPrintableString(@NonNull
                                        byte[] b)

Indicates whether the contents of the provided byte array represent a printable LDAP string, as per RFC 4517 section 3.2. The only characters allowed in a printable string are:

• All uppercase and lowercase ASCII alphabetic letters
• All ASCII numeric digits
• The following additional ASCII characters: single quote, left parenthesis, right parenthesis, plus, comma, hyphen, period, equals, forward slash, colon, question mark, space.

If the provided array contains anything other than the above characters (i.e., if the byte array contains any non-ASCII characters, or any ASCII control characters, or if it contains excluded ASCII characters like the exclamation point, double quote, octothorpe, dollar sign, etc.), then it will not be considered printable.

参数:

b - The byte array for which to make the determination. It must not be null.

返回:

true if the contents of the provided byte array represent a printable LDAP string, or false if not.

toString

public void toString(@NonNull
                     StringBuilder buffer)

Appends a string representation of the value for this ASN.1 element to the provided buffer.

覆盖:

toString 在类中 ASN1Element

参数:

buffer - The buffer to which to append the information.