aboutsummaryrefslogblamecommitdiffstats
path: root/actionpack/lib/action_dispatch/middleware/params_parser.rb
blob: c2a4f46e675f2da8e74c1f1dd909754e5f220d4e (plain) (tree)
1
2
3
4
5
6
7
8
9
                                      
 
                     




                                                                                     
                    

                                                                          
                                    
 

















                                                                                                                  

         
 



                                                                              
                                   
                                                                                                         
         
       
     
   
require 'action_dispatch/http/request'

module ActionDispatch
  # ActionDispatch::ParamsParser works for all the requests having any Content-Length
  # (like POST). It takes raw data from the request and puts it through the parser
  # that is picked based on Content-Type header.
  #
  # In case of any error while parsing data ParamsParser::ParseError is raised.
  class ParamsParser
    # Raised when raw data from the request cannot be parsed by the parser
    # defined for request's content mime type.
    class ParseError < StandardError

      def initialize(message = nil, original_exception = nil)
        if message
          ActiveSupport::Deprecation.warn("Passing #message is deprecated and has no effect. " \
                                          "#{self.class} will automatically capture the message " \
                                          "of the original exception.", caller)
        end

        if original_exception
          ActiveSupport::Deprecation.warn("Passing #original_exception is deprecated and has no effect. " \
                                          "Exceptions will automatically capture the original exception.", caller)
        end

        super($!.message)
      end

      def original_exception
        ActiveSupport::Deprecation.warn("#original_exception is deprecated. Use #cause instead.", caller)
        cause
      end
    end

    # Create a new +ParamsParser+ middleware instance.
    #
    # The +parsers+ argument can take Hash of parsers where key is identifying
    # content mime type, and value is a lambda that is going to process data.
    def self.new(app, parsers = {})
      ActionDispatch::Request.parameter_parsers = ActionDispatch::Request::DEFAULT_PARSERS.merge(parsers)
      app
    end
  end
end