A web service API class specifies the methods that will be available for invocation for an API. It also contains metadata such as the method type signature hints.

It is not intended to be instantiated.

It is attached to web service implementation classes like ActionWebService::Base and ActionController::Base derivatives by using ClassMethods#web_service_api.

Methods
Public Class methods
api_method(name, options={})

API methods have a name, which must be the Ruby method name to use when performing the invocation on the web service object.

The signatures for the method input parameters and return value can by specified in options.

A signature is an array of one or more parameter specifiers. A parameter specifier can be one of the following:

  • A symbol or string of representing one of the Action Web Service base types. See ActionWebService::Signature for a canonical list of the base types.
  • The Class object of the parameter type
  • A single-element Array containing one of the two preceding items. This will cause Action Web Service to treat the parameter at that position as an array containing only values of the given type.
  • A Hash containing as key the name of the parameter, and as value one of the three preceding items

If no method input parameter or method return value signatures are given, the method is assumed to take no parameters and/or return no values of interest, and any values that are received by the server will be discarded and ignored.

Valid options:

:expects
Signature for the method input parameters
:returns
Signature for the method return value
:expects_and_returns
Signature for both input parameters and return value

[ show source ]

    # File vendor/rails/actionwebservice/lib/action_web_service/api/base.rb, line 58
58:         def api_method(name, options={})
59:           validate_options([:expects, :returns, :expects_and_returns], options.keys)
60:           if options[:expects_and_returns]
61:             expects = options[:expects_and_returns]
62:             returns = options[:expects_and_returns]
63:           else
64:             expects = options[:expects]
65:             returns = options[:returns]
66:           end
67:           expects = canonical_signature(expects)
68:           returns = canonical_signature(returns)
69:           if expects
70:             expects.each do |param|
71:               klass = WS::BaseTypes.canonical_param_type_class(param)
72:               klass = klass[0] if klass.is_a?(Array)
73:               if klass.ancestors.include?(ActiveRecord::Base) && !allow_active_record_expects
74:                 raise(ActionWebServiceError, "ActiveRecord model classes not allowed in :expects")
75:               end
76:             end
77:           end
78:           name = name.to_sym
79:           public_name = public_api_method_name(name)
80:           info = { :expects => expects, :returns => returns }
81:           write_inheritable_hash("api_methods", name => info)
82:           write_inheritable_hash("api_public_method_names", public_name => name)
83:         end
api_method_name(public_name)

The corresponding service method name for the given public method name

[ show source ]

     # File vendor/rails/actionwebservice/lib/action_web_service/api/base.rb, line 106
106:         def api_method_name(public_name)
107:           api_public_method_names[public_name]
108:         end
api_methods()

A Hash containing all service methods on this API, and their associated metadata.

[ show source ]

     # File vendor/rails/actionwebservice/lib/action_web_service/api/base.rb, line 112
112:         def api_methods
113:           read_inheritable_attribute("api_methods") || {}
114:         end
has_api_method?(name)

Whether the given method name is a service method on this API

[ show source ]

    # File vendor/rails/actionwebservice/lib/action_web_service/api/base.rb, line 86
86:         def has_api_method?(name)
87:           api_methods.has_key?(name)
88:         end
has_public_api_method?(public_name)

Whether the given public method name has a corresponding service method on this API

[ show source ]

    # File vendor/rails/actionwebservice/lib/action_web_service/api/base.rb, line 92
92:         def has_public_api_method?(public_name)
93:           api_public_method_names.has_key?(public_name)
94:         end
public_api_method_name(name)

The corresponding public method name for the given service method name

[ show source ]

     # File vendor/rails/actionwebservice/lib/action_web_service/api/base.rb, line 97
 97:         def public_api_method_name(name)
 98:           if inflect_names
 99:             name.to_s.camelize
100:           else
101:             name.to_s
102:           end
103:         end