Class: GRPC::RpcDesc

Inherits:
Struct
  • Object
show all
Includes:
Core::StatusCodes
Defined in:
lib/grpc/generic/rpc_desc.rb

Overview

RpcDesc is a Descriptor of an RPC method.

Defined Under Namespace

Classes: Stream

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#inputObject

Returns the value of attribute input

Returns:

  • (Object)

    the current value of input



35
36
37
# File 'lib/grpc/generic/rpc_desc.rb', line 35

def input
  @input
end

#marshal_methodObject

Returns the value of attribute marshal_method

Returns:

  • (Object)

    the current value of marshal_method



35
36
37
# File 'lib/grpc/generic/rpc_desc.rb', line 35

def marshal_method
  @marshal_method
end

#nameObject

Returns the value of attribute name

Returns:

  • (Object)

    the current value of name



35
36
37
# File 'lib/grpc/generic/rpc_desc.rb', line 35

def name
  @name
end

#outputObject

Returns the value of attribute output

Returns:

  • (Object)

    the current value of output



35
36
37
# File 'lib/grpc/generic/rpc_desc.rb', line 35

def output
  @output
end

#unmarshal_methodObject

Returns the value of attribute unmarshal_method

Returns:

  • (Object)

    the current value of unmarshal_method



35
36
37
# File 'lib/grpc/generic/rpc_desc.rb', line 35

def unmarshal_method
  @unmarshal_method
end

Instance Method Details

#arity_error(mth, want, msg) ⇒ Object



138
139
140
# File 'lib/grpc/generic/rpc_desc.rb', line 138

def arity_error(mth, want, msg)
  "##{mth.name}: bad arg count; got:#{mth.arity}, want:#{want}, #{msg}"
end

#assert_arity_matches(mth) ⇒ Object



110
111
112
113
114
115
116
117
118
119
120
# File 'lib/grpc/generic/rpc_desc.rb', line 110

def assert_arity_matches(mth)
  if request_response? || server_streamer?
    if mth.arity != 2
      fail arity_error(mth, 2, "should be #{mth.name}(req, call)")
    end
  else
    if mth.arity != 1
      fail arity_error(mth, 1, "should be #{mth.name}(call)")
    end
  end
end

#bidi_streamer?Boolean

Returns:

  • (Boolean)


134
135
136
# File 'lib/grpc/generic/rpc_desc.rb', line 134

def bidi_streamer?
  input.is_a?(Stream) && output.is_a?(Stream)
end

#client_streamer?Boolean

Returns:

  • (Boolean)


126
127
128
# File 'lib/grpc/generic/rpc_desc.rb', line 126

def client_streamer?
  input.is_a?(Stream) && !output.is_a?(Stream)
end

#marshal_procProc

Returns { |instance| marshalled(instance) }.

Returns:

  • (Proc)

    { |instance| marshalled(instance) }



49
50
51
# File 'lib/grpc/generic/rpc_desc.rb', line 49

def marshal_proc
  proc { |o| o.class.method(marshal_method).call(o).to_s }
end

#request_response?Boolean

Returns:

  • (Boolean)


122
123
124
# File 'lib/grpc/generic/rpc_desc.rb', line 122

def request_response?
  !input.is_a?(Stream) && !output.is_a?(Stream)
end

#run_server_method(active_call, mth) ⇒ Object



65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
# File 'lib/grpc/generic/rpc_desc.rb', line 65

def run_server_method(active_call, mth)
  # While a server method is running, it might be cancelled, its deadline
  # might be reached, the handler could throw an unknown error, or a
  # well-behaved handler could throw a StatusError.
  if request_response?
    req = active_call.remote_read
    resp = mth.call(req, active_call.single_req_view)
    active_call.remote_send(resp)
  elsif client_streamer?
    resp = mth.call(active_call.multi_req_view)
    active_call.remote_send(resp)
  elsif server_streamer?
    req = active_call.remote_read
    replys = mth.call(req, active_call.single_req_view)
    replys.each { |r| active_call.remote_send(r) }
  else  # is a bidi_stream
    active_call.run_server_bidi(mth)
  end
  send_status(active_call, OK, 'OK')
rescue BadStatus => e
  # this is raised by handlers that want GRPC to send an application
  # error code and detail message.
  logger.debug("app err: #{active_call}, status:#{e.code}:#{e.details}")
  send_status(active_call, e.code, e.details)
rescue Core::CallError => e
  # This is raised by GRPC internals but should rarely, if ever happen.
  # Log it, but don't notify the other endpoint..
  logger.warn("failed call: #{active_call}\n#{e}")
rescue OutOfTime
  # This is raised when active_call#method.call exceeeds the deadline
  # event.  Send a status of deadline exceeded
  logger.warn("late call: #{active_call}")
  send_status(active_call, DEADLINE_EXCEEDED, 'late')
rescue Core::EventError => e
  # This is raised by GRPC internals but should rarely, if ever happen.
  # Log it, but don't notify the other endpoint..
  logger.warn("failed call: #{active_call}\n#{e}")
rescue StandardError => e
  # This will usuaally be an unhandled error in the handling code.
  # Send back a UNKNOWN status to the client
  logger.warn("failed handler: #{active_call}; sending status:UNKNOWN")
  logger.warn(e)
  send_status(active_call, UNKNOWN, 'no reason given')
end

#send_status(active_client, code, details) ⇒ Object



142
143
144
145
146
147
148
# File 'lib/grpc/generic/rpc_desc.rb', line 142

def send_status(active_client, code, details)
  details = 'Not sure why' if details.nil?
  active_client.send_status(code, details)
rescue StandardError => e
  logger.warn("Could not send status #{code}:#{details}")
  logger.warn(e)
end

#server_streamer?Boolean

Returns:

  • (Boolean)


130
131
132
# File 'lib/grpc/generic/rpc_desc.rb', line 130

def server_streamer?
  !input.is_a?(Stream) && output.is_a?(Stream)
end

#unmarshal_proc(target) ⇒ Proc

Returns An unmarshal proc { |marshalled(instance)| instance }.

Parameters:

  • target (:input, :output)

    determines whether to produce the an unmarshal Proc for the rpc input parameter or its output parameter

Returns:

  • (Proc)

    An unmarshal proc { |marshalled(instance)| instance }



58
59
60
61
62
63
# File 'lib/grpc/generic/rpc_desc.rb', line 58

def unmarshal_proc(target)
  fail ArgumentError unless [:input, :output].include?(target)
  unmarshal_class = method(target).call
  unmarshal_class = unmarshal_class.type if unmarshal_class.is_a? Stream
  proc { |o| unmarshal_class.method(unmarshal_method).call(o) }
end