base/net_module.h

// Copyright 2011 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef NET_BASE_NET_MODULE_H__
#define NET_BASE_NET_MODULE_H__

#include "base/memory/scoped_refptr.h"
#include "net/base/net_export.h"

namespace base {
class RefCountedMemory;
}

namespace net {

// Defines global initializers and associated methods for the net module.
//
// The network module does not have direct access to the way application
// resources are stored and fetched by the embedding application (e.g., it
// cannot see the ResourceBundle class used by Chrome), so it uses this API to
// get access to such resources.
//
class NET_EXPORT NetModule {
 public:
  typedef scoped_refptr<base::RefCountedMemory> (*ResourceProvider)(int key);

  NetModule() = delete;
  NetModule(const NetModule&) = delete;
  NetModule& operator=(const NetModule&) = delete;

  // Set the function to call when the net module needs resources
  static void SetResourceProvider(ResourceProvider func);

  // Call the resource provider (if one exists) to get the specified resource.
  // Returns nullptr if the resource does not exist or if there is no resource
  // provider.
  static scoped_refptr<base::RefCountedMemory> GetResource(int key);
};

}  // namespace net

#endif  // NET_BASE_NET_MODULE_H__