Class: Thrift::BinaryProtocol

Inherits:
BaseProtocol show all
Defined in:
lib/thrift/protocol/binaryprotocol.rb,
lib/thrift/protocol/binary_protocol.rb

Constant Summary collapse

VERSION_MASK = 
0xffff0000
VERSION_1 = 
0x80010000
TYPE_MASK = 
0x000000ff

Instance Attribute Summary collapse

Attributes inherited from BaseProtocol

#trans

Instance Method Summary collapse

Methods inherited from BaseProtocol

#native?, #read_field_end, #read_list_end, #read_map_end, #read_message_end, #read_set_end, #read_struct_end, #read_type, #skip, #write_field, #write_field_end, #write_list_end, #write_map_end, #write_message_end, #write_set_end, #write_struct_end, #write_type

Constructor Details

#initialize(trans, strict_read = true, strict_write = true) ⇒ BinaryProtocol

Returns a new instance of BinaryProtocol.



20
21
22
23
24
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 20

def initialize(trans, strict_read=true, strict_write=true)
  super(trans)
  @strict_read = strict_read
  @strict_write = strict_write
end

Instance Attribute Details

#strict_read ⇒ Object (readonly)

Returns the value of attribute strict_read.



18
19
20
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 18

def strict_read
  @strict_read
end

#strict_write ⇒ Object (readonly)

Returns the value of attribute strict_write.



18
19
20
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 18

def strict_write
  @strict_write
end

Instance Method Details

#read_bool ⇒ Object 



148
149
150
151
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 148

def read_bool
  byte = read_byte
  byte != 0
end

#read_byte ⇒ Object 



153
154
155
156
157
158
159
160
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 153

def read_byte
  dat = trans.read_all(1)
  val = dat[0]
  if (val > 0x7f)
    val = 0 - ((val - 1) ^ 0xff)
  end
  val
end

#read_double ⇒ Object 



192
193
194
195
196
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 192

def read_double
  dat = trans.read_all(8)
  val = dat.unpack('G').first
  val
end

#read_field_begin ⇒ Object 



119
120
121
122
123
124
125
126
127
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 119

def read_field_begin
  type = read_byte
  if (type == Types::STOP)
    [nil, type, 0]
  else
    id = read_i16
    [nil, type, id]
  end
end

#read_i16 ⇒ Object 



162
163
164
165
166
167
168
169
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 162

def read_i16
  dat = trans.read_all(2)
  val, = dat.unpack('n')
  if (val > 0x7fff)
    val = 0 - ((val - 1) ^ 0xffff)
  end
  val
end

#read_i32 ⇒ Object 



171
172
173
174
175
176
177
178
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 171

def read_i32
  dat = trans.read_all(4)
  val, = dat.unpack('N')
  if (val > 0x7fffffff)
    val = 0 - ((val - 1) ^ 0xffffffff)
  end
  val
end

#read_i64 ⇒ Object 



180
181
182
183
184
185
186
187
188
189
190
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 180

def read_i64
  dat = trans.read_all(8)
  hi, lo = dat.unpack('N2')
  if (hi > 0x7fffffff)
    hi ^= 0xffffffff
    lo ^= 0xffffffff
    0 - (hi << 32) - lo - 1
  else
    (hi << 32) + lo
  end
end

#read_list_begin ⇒ Object 



136
137
138
139
140
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 136

def read_list_begin
  etype = read_byte
  size = read_i32
  [etype, size]
end

#read_map_begin ⇒ Object 



129
130
131
132
133
134
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 129

def read_map_begin
  ktype = read_byte
  vtype = read_byte
  size = read_i32
  [ktype, vtype, size]
end

#read_message_begin ⇒ Object 



98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 98

def read_message_begin
  version = read_i32
  if version < 0
    if (version & VERSION_MASK != VERSION_1)
      raise ProtocolException.new(ProtocolException::BAD_VERSION, 'Missing version identifier')
    end
    type = version & TYPE_MASK
    name = read_string
    seqid = read_i32
    [name, type, seqid]
  else
    if strict_read
      raise ProtocolException.new(ProtocolException::BAD_VERSION, 'No version identifier, old protocol client?')
    end
    name = trans.read_all(version)
    type = read_byte
    seqid = read_i32
    [name, type, seqid]
  end
end

#read_set_begin ⇒ Object 



142
143
144
145
146
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 142

def read_set_begin
  etype = read_byte
  size = read_i32
  [etype, size]
end

#read_string ⇒ Object 



198
199
200
201
202
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 198

def read_string
  sz = read_i32
  dat = trans.read_all(sz)
  dat
end

#read_struct_begin ⇒ Object 



131
 
# File 'lib/thrift/protocol/binary_protocol.rb', line 131

def read_struct_begin; nil; end

#write_bool(bool) ⇒ Object 



66
67
68
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 66

def write_bool(bool)
  write_byte(bool ? 1 : 0)
end

#write_byte(byte) ⇒ Object

Raises:

  • (RangeError) 


70
71
72
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 70

def write_byte(byte)
  trans.write([byte].pack('c'))
end

#write_double(dub) ⇒ Object 



89
90
91
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 89

def write_double(dub)
  trans.write([dub].pack('G'))
end

#write_field_begin(name, type, id) ⇒ Object 



41
42
43
44
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 41

def write_field_begin(name, type, id)
  write_byte(type)
  write_i16(id)
end

#write_field_stop ⇒ Object 



46
47
48
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 46

def write_field_stop
  write_byte(Thrift::Types::STOP)
end

#write_i16(i16) ⇒ Object 



74
75
76
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 74

def write_i16(i16)
  trans.write([i16].pack('n'))
end

#write_i32(i32) ⇒ Object

Raises:

  • (RangeError) 


78
79
80
81
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 78

def write_i32(i32)
  raise RangeError if i32 < -2**31 || i32 >= 2**31
  trans.write([i32].pack('N'))
end

#write_i64(i64) ⇒ Object

Raises:

  • (RangeError) 


83
84
85
86
87
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 83

def write_i64(i64)
  hi = i64 >> 32
  lo = i64 & 0xffffffff
  trans.write([hi, lo].pack('N2'))
end

#write_list_begin(etype, size) ⇒ Object 



56
57
58
59
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 56

def write_list_begin(etype, size)
  write_byte(etype)
  write_i32(size)
end

#write_map_begin(ktype, vtype, size) ⇒ Object 



50
51
52
53
54
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 50

def write_map_begin(ktype, vtype, size)
  write_byte(ktype)
  write_byte(vtype)
  write_i32(size)
end

#write_message_begin(name, type, seqid) ⇒ Object 



26
27
28
29
30
31
32
33
34
35
36
37
38
39
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 26

def write_message_begin(name, type, seqid)
  # this is necessary because we added (needed) bounds checking to 
  # write_i32, and 0x80010000 is too big for that.
  if strict_write
    write_i16(VERSION_1 >> 16)
    write_i16(type)
    write_string(name)
    write_i32(seqid)
  else
    write_string(name)
    write_byte(type)
    write_i32(seqid)
  end
end

#write_set_begin(etype, size) ⇒ Object 



61
62
63
64
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 61

def write_set_begin(etype, size)
  write_byte(etype)
  write_i32(size)
end

#write_string(str) ⇒ Object 



93
94
95
96
 
# File 'lib/thrift/protocol/binaryprotocol.rb', line 93

def write_string(str)
  write_i32(str.length)
  trans.write(str)
end

#write_struct_begin(name) ⇒ Object 



49
 
# File 'lib/thrift/protocol/binary_protocol.rb', line 49

def write_struct_begin(name); nil; end