Class: OsCtld::Generic::Server

Inherits:
Object
  • Object
show all
Defined in:
lib/osctld/generic/server.rb

Overview

Generic socket server

A thread is spawned for every connected client. An instance of ClientHandler or its subclass is created to handle the connection.

Instance Method Summary collapse

Constructor Details

#initialize(socket, client_handler, opts = {}) ⇒ Server

Returns a new instance of Server.

Parameters:

  • socket (BasicSocket) —

    server socket

  • client_handler (Generic::ClientHandler) —

    name of a class that will be instantiated for every client

  • opts (Hash) (defaults to: {}) —

    options

Options Hash (opts):

  • opts (Hash) —

    options passed to the client handler

  • thread_group (Symbol) —

    group used by ThreadReaper



15
16
17
18
19
20
 
# File 'lib/osctld/generic/server.rb', line 15

def initialize(socket, client_handler, opts = {})
  @socket = socket
  @client_handler = client_handler
  @opts = opts
  @thread_group = opts[:thread_group] || ThreadReaper::DEFAULT_GROUP
end

Instance Method Details

#handle_client(socket) ⇒ Object (protected) 



38
39
40
41
42
 
# File 'lib/osctld/generic/server.rb', line 38

def handle_client(socket)
  c = @client_handler.new(socket, @opts[:opts] || {})
  t = Thread.new { c.communicate }
  ThreadReaper.add(t, c, group: @thread_group)
end

#start ⇒ Object 



22
23
24
25
26
27
28
29
30
 
# File 'lib/osctld/generic/server.rb', line 22

def start
  loop do
    c = @socket.accept
  rescue IOError
    return
  else
    handle_client(c)
  end
end

#stop ⇒ Object 



32
33
34
 
# File 'lib/osctld/generic/server.rb', line 32

def stop
  @socket.close
end