15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2011 The Chromium Authors. All rights reserved.
25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be
35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file.
45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// This class is called by the WebResourceService in a sandboxed process
65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// to unpack data retrieved from a web resource feed.  Right now, it
75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// takes a string of data in JSON format, parses it, and hands it back
85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// to the WebResourceService as a list of items.  In the future
95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// it will be set up to unpack and verify image data in addition to
105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// just parsing a JSON feed.
115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
127dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch#ifndef CHROME_UTILITY_WEB_RESOURCE_UNPACKER_H_
137dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch#define CHROME_UTILITY_WEB_RESOURCE_UNPACKER_H_
145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <string>
165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/basictypes.h"
185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/memory/scoped_ptr.h"
195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace base {
215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class DictionaryValue;
225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}
235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class WebResourceUnpacker {
255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public:
265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  static const char* kInvalidDataTypeError;
275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  static const char* kUnexpectedJSONFormatError;
285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  explicit WebResourceUnpacker(const std::string &resource_data);
305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  ~WebResourceUnpacker();
315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  // This does the actual parsing.  In case of an error, error_message_
335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  // is set to an appropriate value.
345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  bool Run();
355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  // Returns the last error message set by Run().
375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  const std::string& error_message() { return error_message_; }
385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  // Gets data which has been parsed by Run().
405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  base::DictionaryValue* parsed_json() {
415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)    return parsed_json_.get();
425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  }
435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private:
455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  // Holds the string which is to be parsed.
465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  std::string resource_data_;
475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  // Holds the result of JSON parsing of resource_data_.
495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  scoped_ptr<base::DictionaryValue> parsed_json_;
505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  // Holds the last error message produced by Run().
525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  std::string error_message_;
535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  DISALLOW_COPY_AND_ASSIGN(WebResourceUnpacker);
555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)};
565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
577dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch#endif  // CHROME_UTILITY_WEB_RESOURCE_UNPACKER_H_
58