Class: McProtocolE::Frame3e::Response

Inherits:
Object
  • Object
show all
Defined in:
lib/mc_protocol_e/frame_3e/response.rb

Overview

This class shows a responce of MC protocol.

Defined Under Namespace

Classes: InvalidResponseError, ReadTimeoutError

Constant Summary collapse

DEFAULT_READ_TIMEOUT = 
3
SUB_HEADER = 
"\xD0\x00".b
MAX_RECV_LEN = 
1024 * 1024
SUCCEED_CODE = 
0

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(raw_res) ⇒ Response

Constructor.

Parameters:

  • raw_res (String) —

    binary string of response



22
23
24
25
26
27
28
 
# File 'lib/mc_protocol_e/frame_3e/response.rb', line 22

def initialize(raw_res)
  @sub_header = raw_res[0..1]
  @access_route = raw_res[2..6]
  @response_len = raw_res[7..8]
  @code = raw_res[9..10]&.unpack1("v")
  @data = raw_res[11..-1] || ""
end

Instance Attribute Details

#code ⇒ Object (readonly)

Returns the value of attribute code.



18
19
20
 
# File 'lib/mc_protocol_e/frame_3e/response.rb', line 18

def code
  @code
end

#data ⇒ Object (readonly)

Returns the value of attribute data.



18
19
20
 
# File 'lib/mc_protocol_e/frame_3e/response.rb', line 18

def data
  @data
end

Class Method Details

.recv(socket, read_timeout = DEFAULT_READ_TIMEOUT) ⇒ Responce

Receives responce and returns.

Parameters:

  • socket (IO) —

    TCP socket

  • read_timeout (Integer) (defaults to: DEFAULT_READ_TIMEOUT) —

    read timeout second

Returns:

  • (Responce) —

    received a response

Raises:



36
37
38
39
40
41
42
43
44
 
# File 'lib/mc_protocol_e/frame_3e/response.rb', line 36

def self.recv(socket, read_timeout = DEFAULT_READ_TIMEOUT)
  selected = IO.select([socket], nil, nil, read_timeout)
  raise ReadTimeoutError unless selected

  raw_res = socket.recv(MAX_RECV_LEN)
  res = new(raw_res)
  raise InvalidResponseError if res.code.nil?
  res
end

Instance Method Details

#failed? ⇒ Boolean

Returns true if a command failed.

Returns:

  • (Boolean) 


52
53
54
 
# File 'lib/mc_protocol_e/frame_3e/response.rb', line 52

def failed?
  !succeed?
end

#succeed? ⇒ Boolean

Returns true if a command succeed.

Returns:

  • (Boolean) 


47
48
49
 
# File 'lib/mc_protocol_e/frame_3e/response.rb', line 47

def succeed?
  code == SUCCEED_CODE
end