class OpenSSL::ASN1::Constructive
Родительский класс для всех составных кодировок. Атрибут value объекта Constructive всегда имеет тип Array. Атрибуты те же, что и у ASN1Data, с добавлением tagging.
SET и SEQUENCE
Большинство составных кодировок представляются в виде SET или SEQUENCE. Эти кодировки представлены одним из двух подклассов Constructive:
-
OpenSSL::ASN1::Sequence
Обратите внимание: помеченные последовательности и множества по-прежнему разбираются как экземпляры ASN1Data. Дополнительные сведения о помеченных значениях см. в Find.
Пример — создание SEQUENCE
int = OpenSSL::ASN1::Integer.new(1)
str = OpenSSL::ASN1::PrintableString.new('abc')
sequence = OpenSSL::ASN1::Sequence.new( [ int, str ] )
Пример — создание SET
int = OpenSSL::ASN1::Integer.new(1)
str = OpenSSL::ASN1::PrintableString.new('abc')
set = OpenSSL::ASN1::Set.new( [ int, str ] )
Атрибуты
Может использоваться как подсказка при кодировании значения — неявно или явно; для этого ему нужно присвоить :IMPLICIT или :EXPLICIT. Значение tagging не задаётся при разборе структуры ASN.1 с помощью OpenSSL::ASN1.decode.
Публичные методы класса
static VALUE
ossl_asn1_initialize(int argc, VALUE *argv, VALUE self)
{
VALUE value, tag, tagging, tag_class;
int default_tag;
rb_scan_args(argc, argv, "13", &value, &tag, &tagging, &tag_class);
default_tag = ossl_asn1_default_tag(self);
if (default_tag == -1 || argc > 1) {
if(NIL_P(tag))
ossl_raise(eASN1Error, "must specify tag number");
if(!NIL_P(tagging) && !SYMBOL_P(tagging))
ossl_raise(eASN1Error, "invalid tagging method");
if(NIL_P(tag_class)) {
if (NIL_P(tagging))
tag_class = sym_UNIVERSAL;
else
tag_class = sym_CONTEXT_SPECIFIC;
}
if(!SYMBOL_P(tag_class))
ossl_raise(eASN1Error, "invalid tag class");
}
else{
tag = INT2NUM(default_tag);
tagging = Qnil;
tag_class = sym_UNIVERSAL;
}
ossl_asn1_set_tag(self, tag);
ossl_asn1_set_value(self, value);
ossl_asn1_set_tagging(self, tagging);
ossl_asn1_set_tag_class(self, tag_class);
ossl_asn1_set_indefinite_length(self, Qfalse);
if (default_tag == V_ASN1_BIT_STRING)
rb_ivar_set(self, sivUNUSED_BITS, INT2FIX(0));
return self;
} value: обязательный параметр.
tag: необязательный параметр, может быть указан для помеченных значений. Если tag не указан, по умолчанию используется тег UNIVERSAL, соответствующий подклассу Primitive.
tagging: может использоваться как подсказка при кодировании значения — явно или неявно; возможные значения см. в ASN1.
tag_class: если tag и tagging равны nil, по умолчанию устанавливается значение :UNIVERSAL. Если задан хотя бы один из параметров tag или tagging, по умолчанию используется :CONTEXT_SPECIFIC. Возможные значения см. в ASN1.
Пример
int = OpenSSL::ASN1::Integer.new(42) zero_tagged_int = OpenSSL::ASN1::Integer.new(42, 0, :IMPLICIT) private_explicit_zero_tagged_int = OpenSSL::ASN1::Integer.new(42, 0, :EXPLICIT, :PRIVATE)
Публичные методы экземпляра
static VALUE
ossl_asn1cons_each(VALUE self)
{
rb_block_call(ossl_asn1_get_value(self), id_each, 0, 0, 0, 0);
return self;
} Вызывает переданный блок один раз для каждого элемента объекта self, передавая этот элемент в качестве параметра asn1. Если блок не передан, вместо этого возвращается перечислитель.
Пример
asn1_ary.each do |asn1| puts asn1 end
static VALUE
ossl_asn1cons_to_der(VALUE self)
{
VALUE ary, str;
long i;
int indef_len;
indef_len = RTEST(ossl_asn1_get_indefinite_length(self));
ary = rb_convert_type(ossl_asn1_get_value(self), T_ARRAY, "Array", "to_a");
str = rb_str_new(NULL, 0);
for (i = 0; i < RARRAY_LEN(ary); i++) {
VALUE item = RARRAY_AREF(ary, i);
if (indef_len && rb_obj_is_kind_of(item, cASN1EndOfContent)) {
if (i != RARRAY_LEN(ary) - 1)
ossl_raise(eASN1Error, "illegal EOC octets in value");
/*
* EOC is not really part of the content, but we required to add one
* at the end in the past.
*/
break;
}
item = ossl_to_der_if_possible(item);
StringValue(item);
rb_str_append(str, item);
}
return to_der_internal(self, 1, indef_len, str);
} Подробные сведения см. в ASN1Data#to_der.
Ruby Core © 1993–2025 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.
