class OpenSSL::ASN1::Primitive
所有原始编码的父类。属性与 ASN1Data 的属性相同,但增加了标记。 Primitive 值永远不能使用不定长度形式进行编码,因此不可能为 Primitive 及其子类设置 indefinite_length 属性。
Primitive 子类及其到 Ruby 类的映射¶ ↑
-
OpenSSL::ASN1::EndOfContent<=> value 始终为nil -
OpenSSL::ASN1::Boolean<=> value 为true或false -
OpenSSL::ASN1::Integer<=> value 是一个OpenSSL::BN -
OpenSSL::ASN1::BitString<=> value 是一个String -
OpenSSL::ASN1::OctetString <=> value 是一个
String -
OpenSSL::ASN1::Null <=> value 始终为
nil -
OpenSSL::ASN1::Object<=> value 是一个String -
OpenSSL::ASN1::Enumerated<=> value 是一个OpenSSL::BN -
OpenSSL::ASN1::UTF8String <=> value 是一个
String -
OpenSSL::ASN1::NumericString <=> value 是一个
String -
OpenSSL::ASN1::PrintableString <=> value 是一个
String -
OpenSSL::ASN1::T61String <=> value 是一个
String -
OpenSSL::ASN1::VideotexString <=> value 是一个
String -
OpenSSL::ASN1::IA5String <=> value 是一个
String -
OpenSSL::ASN1::UTCTime <=> value 是一个
Time -
OpenSSL::ASN1::GeneralizedTime <=> value 是一个
Time -
OpenSSL::ASN1::GraphicString <=> value 是一个
String -
OpenSSL::ASN1::ISO64String <=> value 是一个
String -
OpenSSL::ASN1::GeneralString <=> value 是一个
String -
OpenSSL::ASN1::UniversalString <=> value 是一个
String -
OpenSSL::ASN1::BMPString <=> value 是一个
String
OpenSSL::ASN1::BitString¶ ↑
附加属性¶ ↑
unused_bits:如果底层 BIT STRING 的长度是 8 的倍数,则 unused_bits 为 0。否则,unused_bits 指示在 BitString 的 value 的最后一个八位字节中要忽略的位数。
OpenSSL::ASN1::ObjectId¶ ↑
注意:虽然 OpenSSL::ASN1::ObjectId.new 将分配一个新的 ObjectId,但通常不会以这种方式分配,而是从解析的 ASN1 编码中接收。
附加属性¶ ↑
-
sn:在 <openssl/objects.h> 中定义的短名称。
-
ln:在 <openssl/objects.h> 中定义的长名称。
-
oid:对象标识符,类型为
String,例如 “1.2.3.4.5” -
short_name:sn 的别名。
-
long_name:ln 的别名。
示例¶ ↑
除了 OpenSSL::ASN1::EndOfContent 之外,每个 Primitive 类构造函数都至少需要一个参数,即 value。
创建 EndOfContent¶ ↑
eoc = OpenSSL::ASN1::EndOfContent.new
创建任何其他 Primitive¶ ↑
prim = <class>.new(value) # <class> being one of the sub-classes except EndOfContent prim_zero_tagged_implicit = <class>.new(value, 0, :IMPLICIT) prim_zero_tagged_explicit = <class>.new(value, 0, :EXPLICIT)
公共实例方法
来源
static VALUE
ossl_asn1prim_to_der(VALUE self)
{
ASN1_TYPE *asn1;
long alllen, bodylen;
unsigned char *p0, *p1;
int j, tag, tc, state;
VALUE str;
if (ossl_asn1_default_tag(self) == -1) {
str = ossl_asn1_get_value(self);
return to_der_internal(self, 0, 0, StringValue(str));
}
asn1 = ossl_asn1_get_asn1type(self);
alllen = i2d_ASN1_TYPE(asn1, NULL);
if (alllen < 0) {
ASN1_TYPE_free(asn1);
ossl_raise(eASN1Error, "i2d_ASN1_TYPE");
}
str = ossl_str_new(NULL, alllen, &state);
if (state) {
ASN1_TYPE_free(asn1);
rb_jump_tag(state);
}
p0 = p1 = (unsigned char *)RSTRING_PTR(str);
if (i2d_ASN1_TYPE(asn1, &p0) < 0) {
ASN1_TYPE_free(asn1);
ossl_raise(eASN1Error, "i2d_ASN1_TYPE");
}
ASN1_TYPE_free(asn1);
ossl_str_adjust(str, p0);
/* Strip header since to_der_internal() wants only the payload */
j = ASN1_get_object((const unsigned char **)&p1, &bodylen, &tag, &tc, alllen);
if (j & 0x80)
ossl_raise(eASN1Error, "ASN1_get_object"); /* should not happen */
return to_der_internal(self, 0, 0, rb_str_drop_bytes(str, alllen - bodylen));
}
有关详细信息,请参阅 ASN1Data#to_der。