summaryrefslogtreecommitdiffstats
path: root/lib/puppet/indirector/rest.rb
blob: 2d0799286117700d43b33c60e8d55026c951f12b (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
51
52
53
54
55
56
57
58
59
60
61
62
63
64
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
require 'net/http'
require 'uri'

require 'puppet/network/http_pool'

# Access objects via REST
class Puppet::Indirector::REST < Puppet::Indirector::Terminus

    class << self
        attr_reader :server_setting, :port_setting
    end

    # Specify the setting that we should use to get the server name.
    def self.use_server_setting(setting)
        @server_setting = setting
    end

    def self.server
        return Puppet.settings[server_setting || :server]
    end

    # Specify the setting that we should use to get the port.
    def self.use_port_setting(setting)
        @port_setting = setting
    end

    def self.port
        return Puppet.settings[port_setting || :masterport].to_i
    end

    # Figure out the content type, turn that into a format, and use the format
    # to extract the body of the response.
    def deserialize(response, multiple = false)
        case response.code
        when "404"
            return nil
        when /^2/
            unless response['content-type']
                raise "No content type in http response; cannot parse"
            end

            # Convert the response to a deserialized object.
            if multiple
                model.convert_from_multiple(response['content-type'], response.body)
            else
                model.convert_from(response['content-type'], response.body)
            end
        else
            # Raise the http error if we didn't get a 'success' of some kind.
            message = "Server returned %s: %s" % [response.code, response.message]
            raise Net::HTTPError.new(message, response)
        end
    end

    # Provide appropriate headers.
    def headers
        {"Accept" => model.supported_formats.join(", ")}
    end
  
    def network(request)
        Puppet::Network::HttpPool.http_instance(request.server || self.class.server, request.port || self.class.port)
    end

    def find(request)
        deserialize network(request).get("/#{indirection.name}/#{request.key}#{query_string(request)}", headers)
    end
    
    def search(request)
        if request.key
            path = "/#{indirection.name}s/#{request.key}#{query_string(request)}"
        else
            path = "/#{indirection.name}s#{query_string(request)}"
        end
        unless result = deserialize(network(request).get(path, headers), true)
            return []
        end
        return result
    end
    
    def destroy(request)
        raise ArgumentError, "DELETE does not accept options" unless request.options.empty?
        deserialize network(request).delete("/#{indirection.name}/#{request.key}", headers)
    end
    
    def save(request)
        raise ArgumentError, "PUT does not accept options" unless request.options.empty?
        deserialize network(request).put("/#{indirection.name}/", request.instance.render, headers)
    end

    # Create the query string, if options are present.
    def query_string(request)
        return "" unless request.options and ! request.options.empty?
        "?" + request.options.collect do |key, value|
            case value
            when nil; next
            when true, false; value = value.to_s
            when String; value = URI.escape(value)
            when Symbol; value = URI.escape(value.to_s)
            when Array; value = URI.escape(YAML.dump(value))
            else
                raise ArgumentError, "HTTP REST queries cannot handle values of type '%s'" % value.class
            end

            "%s=%s" % [key, value]
        end.join("&")
    end
end