summaryrefslogtreecommitdiffstats
path: root/lib/puppet/network/handler.rb
blob: 3cad3872f8b926683743881fe2d5cca503bd8d63 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
require 'puppet/util/docs'
require 'puppet/util/subclass_loader'

module Puppet::Network
  # The base class for the different handlers.  The handlers are each responsible
  # for separate xmlrpc namespaces.
  class Handler
    extend Puppet::Util::Docs

    # This is so that the handlers can subclass just 'Handler', rather
    # then having to specify the full class path.
    Handler = self
    attr_accessor :server, :local

    extend Puppet::Util::SubclassLoader
    extend Puppet::Util

    handle_subclasses :handler, "puppet/network/handler"

    # Return the xmlrpc interface.
    def self.interface
      if defined?(@interface)
        return @interface
      else
        raise Puppet::DevError, "Handler #{self} has no defined interface"
      end
    end

    # Set/Determine whether we're a client- or server-side handler.
    def self.side(side = nil)
      if side
        side = side.intern if side.is_a?(String)
        raise ArgumentError, "Invalid side registration '#{side}' for #{self.name}" unless [:client, :server].include?(side)
        @side = side
      else
        @side ||= :server
        return @side
      end
    end

    # Create an empty init method with the same signature.
    def initialize(hash = {})
    end

    def local?
      self.local
    end
  end
end