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: TimeoutError

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



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

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

#codeObject (readonly)

Returns the value of attribute code.



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

def code
  @code
end

#dataObject (readonly)

Returns the value of attribute data.



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

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:



33
34
35
36
37
38
39
# File 'lib/mc_protocol_e/frame_3e/response.rb', line 33

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

  raw_res = socket.recv(MAX_RECV_LEN)
  new(raw_res)
end

Instance Method Details

#failed?Boolean

Returns true if a command failed.

Returns:

  • (Boolean)


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

def failed?
  !succeed?
end

#succeed?Boolean

Returns true if a command succeed.

Returns:

  • (Boolean)


42
43
44
# File 'lib/mc_protocol_e/frame_3e/response.rb', line 42

def succeed?
  code == SUCCEED_CODE
end