summaryrefslogtreecommitdiffstats
path: root/netwerk/base/ProtocolHandlerInfo.h
blob: 337dbddcfc8b9eb6579504ae945bf483bca395d3 (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
/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim: set ts=8 sts=2 et sw=2 tw=80: */
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this file,
 * You can obtain one at http://mozilla.org/MPL/2.0/. */

#ifndef mozilla_net_ProtocolHandlerInfo_h
#define mozilla_net_ProtocolHandlerInfo_h

#include "mozilla/Variant.h"
#include "nsProxyRelease.h"
#include "nsIProtocolHandler.h"

namespace mozilla {
namespace xpcom {
struct StaticProtocolHandler;
}

namespace net {

struct RuntimeProtocolHandler {
  nsMainThreadPtrHandle<nsIProtocolHandler> mHandler;
  uint32_t mProtocolFlags;
  int32_t mDefaultPort;
};

// Information about a specific protocol handler.
class ProtocolHandlerInfo {
 public:
  explicit ProtocolHandlerInfo(const xpcom::StaticProtocolHandler& aStatic)
      : mInner(AsVariant(&aStatic)) {}
  explicit ProtocolHandlerInfo(RuntimeProtocolHandler aDynamic)
      : mInner(AsVariant(std::move(aDynamic))) {}

  // Returns the statically known protocol-specific flags.
  // See `nsIProtocolHandler` for valid values.
  uint32_t StaticProtocolFlags() const;

  // The port that this protocol normally uses.
  // If a port does not make sense for the protocol (e.g., "about:") then -1
  // will be returned.
  int32_t DefaultPort() const;

  // If true, `DynamicProtocolFlags()` may return a different value than
  // `StaticProtocolFlags()` for flags in `DYNAMIC_URI_FLAGS`, due to a
  // `nsIProtocolHandlerWithDynamicFlags` implementation.
  bool HasDynamicFlags() const;

  // Like `StaticProtocolFlags()` but also checks
  // `nsIProtocolHandlerWithDynamicFlags` for uri-specific flags.
  //
  // NOTE: Only safe to call from the main thread.
  nsresult DynamicProtocolFlags(nsIURI* aURI, uint32_t* aFlags) const
      MOZ_REQUIRES(sMainThreadCapability);

  // Get the main-thread-only nsIProtocolHandler instance.
  already_AddRefed<nsIProtocolHandler> Handler() const
      MOZ_REQUIRES(sMainThreadCapability);

 private:
  Variant<const xpcom::StaticProtocolHandler*, RuntimeProtocolHandler> mInner;
};

}  // namespace net
}  // namespace mozilla

#endif  // mozilla_net_ProtocolHandlerInfo_h