类 OpenSSL::ASN1::ASN1Data
表示任何 ASN.1 对象的顶级类。当由 ASN1.decode 解析时，带标签的值始终由 ASN1Data 的实例表示。
ASN1Data 在解析带标签值中的作用¶ ↑
在编码 ASN.1 类型时，无论其标记如何，其原始类型（例如 INTEGER、OCTET STRING 等）都非常明确。但与编码 ASN.1 类型时相反，在解析它们时，无法推断带标签值的“真实类型”。这就是为什么带标签的值通常被解析为 ASN1Data 实例，但隐式和显式标记的结果不同。
解析隐式带标签值的示例¶ ↑
隐式 1 标记的 INTEGER 值将被解析为 ASN1Data，其中
-
tag 等于 1
-
tag_class 等于
:CONTEXT_SPECIFIC -
value 等于一个字符串，该字符串包含 INTEGER 的原始编码。
这意味着需要后续解码步骤才能完全解码隐式带标签的值。
解析显式带标签值的示例¶ ↑
显式 1 标记的 INTEGER 值将被解析为 ASN1Data，其中
-
tag 等于 1
-
tag_class 等于
:CONTEXT_SPECIFIC -
value 等于一个数组，该数组只有一个元素，即
OpenSSL::ASN1::Integer的实例，即内部元素是非标记的原始值，标记在外部ASN1Data中表示。
示例 - 解码隐式带标签的 INTEGER¶ ↑
int = OpenSSL::ASN1::Integer.new(1, 0, :IMPLICIT) # implicit 0-tagged seq = OpenSSL::ASN1::Sequence.new( [int] ) der = seq.to_der asn1 = OpenSSL::ASN1.decode(der) # pp asn1 => #<OpenSSL::ASN1::Sequence:0x87326e0 # @indefinite_length=false, # @tag=16, # @tag_class=:UNIVERSAL, # @tagging=nil, # @value= # [#<OpenSSL::ASN1::ASN1Data:0x87326f4 # @indefinite_length=false, # @tag=0, # @tag_class=:CONTEXT_SPECIFIC, # @value="\x01">]> raw_int = asn1.value[0] # manually rewrite tag and tag class to make it an UNIVERSAL value raw_int.tag = OpenSSL::ASN1::INTEGER raw_int.tag_class = :UNIVERSAL int2 = OpenSSL::ASN1.decode(raw_int) puts int2.value # => 1
示例 - 解码显式带标签的 INTEGER¶ ↑
int = OpenSSL::ASN1::Integer.new(1, 0, :EXPLICIT) # explicit 0-tagged seq = OpenSSL::ASN1::Sequence.new( [int] ) der = seq.to_der asn1 = OpenSSL::ASN1.decode(der) # pp asn1 => #<OpenSSL::ASN1::Sequence:0x87326e0 # @indefinite_length=false, # @tag=16, # @tag_class=:UNIVERSAL, # @tagging=nil, # @value= # [#<OpenSSL::ASN1::ASN1Data:0x87326f4 # @indefinite_length=false, # @tag=0, # @tag_class=:CONTEXT_SPECIFIC, # @value= # [#<OpenSSL::ASN1::Integer:0x85bf308 # @indefinite_length=false, # @tag=2, # @tag_class=:UNIVERSAL # @tagging=nil, # @value=1>]>]> int2 = asn1.value[0].value[0] puts int2.value # => 1
属性
永远不会是 nil。一个布尔值，表示编码是否使用不定长（在解析的情况下）或是否应使用不定长形式（在编码的情况下）。在 DER 中，每个值都使用定长形式。但在需要传输大量数据的场景中，可能需要某种流支持。例如，巨大的 OCTET STRING 最好以较小的块发送，每次发送一个块。这可以通过在 BER 中将编码的长度字节设置为零来实现，并以此表示后续值将以块的形式发送。不定长编码始终是构造的。这种块流的结束通过发送 EOC（内容结束）标记来指示。SET 和 SEQUENCE 可以使用不定长编码，但原始类型（例如 OCTET STRING 或 BIT STRING）也可以利用此功能（参见 ITU-T X.690）。
永远不会是 nil。一个布尔值，表示编码是否使用不定长（在解析的情况下）或是否应使用不定长形式（在编码的情况下）。在 DER 中，每个值都使用定长形式。但在需要传输大量数据的场景中，可能需要某种流支持。例如，巨大的 OCTET STRING 最好以较小的块发送，每次发送一个块。这可以通过在 BER 中将编码的长度字节设置为零来实现，并以此表示后续值将以块的形式发送。不定长编码始终是构造的。这种块流的结束通过发送 EOC（内容结束）标记来指示。SET 和 SEQUENCE 可以使用不定长编码，但原始类型（例如 OCTET STRING 或 BIT STRING）也可以利用此功能（参见 ITU-T X.690）。
承载 ASN.1 类型的值。请参阅 Constructive 和 Primitive，了解 ASN.1 数据类型和 Ruby 类之间的映射。
公共类方法
value：请查看 Constructive 和 Primitive，了解 Ruby 类型如何映射到 ASN.1 类型，反之亦然。
tag：一个表示标签号的 Integer。
tag_class：一个表示标签类的 Symbol。有关可能的值，请参见 ASN1。
示例¶ ↑
asn1_int = OpenSSL::ASN1Data.new(42, 2, :UNIVERSAL) # => Same as OpenSSL::ASN1::Integer.new(42) tagged_int = OpenSSL::ASN1Data.new(42, 0, :CONTEXT_SPECIFIC) # implicitly 0-tagged INTEGER
static VALUE
ossl_asn1data_initialize(VALUE self, VALUE value, VALUE tag, VALUE tag_class)
{
if(!SYMBOL_P(tag_class))
ossl_raise(eASN1Error, "invalid tag class");
ossl_asn1_set_tag(self, tag);
ossl_asn1_set_value(self, value);
ossl_asn1_set_tag_class(self, tag_class);
ossl_asn1_set_indefinite_length(self, Qfalse);
return self;
}
公共实例方法
将此 ASN1Data 编码为 DER 编码的字符串值。结果是 DER 编码的，除了可能存在不定长形式。不定长形式在严格的 DER 中是不允许的，因此严格来说，这种编码的结果将是 BER 编码。
static VALUE
ossl_asn1data_to_der(VALUE self)
{
VALUE value = ossl_asn1_get_value(self);
if (rb_obj_is_kind_of(value, rb_cArray))
return ossl_asn1cons_to_der(self);
else {
if (RTEST(ossl_asn1_get_indefinite_length(self)))
ossl_raise(eASN1Error, "indefinite length form cannot be used " \
"with primitive encoding");
return ossl_asn1prim_to_der(self);
}
}