OLD | NEW |
---|---|
1 // Copyright 2013 The Chromium Authors. All rights reserved. | 1 // Copyright 2013 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef NET_LOG_NET_LOG_LOGGER_H_ | 5 #ifndef NET_LOG_NET_LOG_LOGGER_H_ |
eroman
2015/04/14 20:06:12
Please update this to match the new filepath
| |
6 #define NET_LOG_NET_LOG_LOGGER_H_ | 6 #define NET_LOG_NET_LOG_LOGGER_H_ |
7 | 7 |
8 #include <stdio.h> | 8 #include <stdio.h> |
9 | 9 |
10 #include "base/files/scoped_file.h" | 10 #include "base/files/scoped_file.h" |
11 #include "base/macros.h" | 11 #include "base/macros.h" |
12 #include "base/memory/ref_counted.h" | 12 #include "base/memory/ref_counted.h" |
13 #include "net/log/net_log.h" | 13 #include "net/log/net_log.h" |
14 | 14 |
15 namespace base { | 15 namespace base { |
16 class DictionaryValue; | 16 class DictionaryValue; |
17 class FilePath; | 17 class FilePath; |
18 class Value; | 18 class Value; |
19 } | 19 } |
20 | 20 |
21 namespace net { | 21 namespace net { |
22 | 22 |
23 class URLRequestContext; | 23 class URLRequestContext; |
24 | 24 |
25 // NetLogLogger watches the NetLog event stream, and sends all entries to | 25 // WriteToFileNetLogObserver watches the NetLog event stream, and sends all |
26 // entries to | |
eroman
2015/04/14 20:06:12
Join the previous line to here to match new wrappi
| |
26 // a file specified on creation. | 27 // a file specified on creation. |
27 // | 28 // |
28 // The text file will contain a single JSON object. | 29 // The text file will contain a single JSON object. |
29 class NET_EXPORT NetLogLogger : public NetLog::ThreadSafeObserver { | 30 class NET_EXPORT WriteToFileNetLogObserver : public NetLog::ThreadSafeObserver { |
30 public: | 31 public: |
31 NetLogLogger(); | 32 WriteToFileNetLogObserver(); |
32 ~NetLogLogger() override; | 33 ~WriteToFileNetLogObserver() override; |
33 | 34 |
34 // Sets the log level to log at. Must be called before StartObserving. | 35 // Sets the log level to log at. Must be called before StartObserving. |
35 void set_log_level(NetLog::LogLevel log_level); | 36 void set_log_level(NetLog::LogLevel log_level); |
36 | 37 |
37 // Starts observing |net_log| and writes output to |file|. Must not already | 38 // Starts observing |net_log| and writes output to |file|. Must not already |
38 // be watching a NetLog. Separate from constructor to enforce thread safety. | 39 // be watching a NetLog. Separate from constructor to enforce thread safety. |
39 // | 40 // |
40 // |file| must be a non-NULL empty file that's open for writing. | 41 // |file| must be a non-NULL empty file that's open for writing. |
41 // | 42 // |
42 // |constants| is an optional legend for decoding constant values used in the | 43 // |constants| is an optional legend for decoding constant values used in the |
43 // log. It should generally be a modified version of GetNetConstants(). If | 44 // log. It should generally be a modified version of GetNetConstants(). If |
44 // not present, the output of GetNetConstants() will be used. | 45 // not present, the output of GetNetConstants() will be used. |
45 // | 46 // |
46 // |url_request_context| is an optional URLRequestContext that will be used to | 47 // |url_request_context| is an optional URLRequestContext that will be used to |
47 // pre-populate the log with information about in-progress events. | 48 // pre-populate the log with information about in-progress events. |
48 // If the context is non-NULL, this must be called on the context's thread. | 49 // If the context is non-NULL, this must be called on the context's thread. |
49 void StartObserving(NetLog* net_log, | 50 void StartObserving(NetLog* net_log, |
50 base::ScopedFILE file, | 51 base::ScopedFILE file, |
51 base::Value* constants, | 52 base::Value* constants, |
52 net::URLRequestContext* url_request_context); | 53 net::URLRequestContext* url_request_context); |
53 | 54 |
54 // Stops observing net_log(). Must already be watching. Must be called | 55 // Stops observing net_log(). Must already be watching. Must be called |
55 // before destruction of the NetLogLogger and the NetLog. | 56 // before destruction of the WriteToFileNetLogObserver and the NetLog. |
56 // | 57 // |
57 // |url_request_context| is an optional argument used to added additional | 58 // |url_request_context| is an optional argument used to added additional |
58 // network stack state to the log. If the context is non-NULL, this must be | 59 // network stack state to the log. If the context is non-NULL, this must be |
59 // called on the context's thread. | 60 // called on the context's thread. |
60 void StopObserving(net::URLRequestContext* url_request_context); | 61 void StopObserving(net::URLRequestContext* url_request_context); |
61 | 62 |
62 // net::NetLog::ThreadSafeObserver implementation: | 63 // net::NetLog::ThreadSafeObserver implementation: |
63 void OnAddEntry(const NetLog::Entry& entry) override; | 64 void OnAddEntry(const NetLog::Entry& entry) override; |
64 | 65 |
65 private: | 66 private: |
66 base::ScopedFILE file_; | 67 base::ScopedFILE file_; |
67 | 68 |
68 // The LogLevel to log at. | 69 // The LogLevel to log at. |
69 NetLog::LogLevel log_level_; | 70 NetLog::LogLevel log_level_; |
70 | 71 |
71 // True if OnAddEntry() has been called at least once. | 72 // True if OnAddEntry() has been called at least once. |
72 bool added_events_; | 73 bool added_events_; |
73 | 74 |
74 DISALLOW_COPY_AND_ASSIGN(NetLogLogger); | 75 DISALLOW_COPY_AND_ASSIGN(WriteToFileNetLogObserver); |
75 }; | 76 }; |
76 | 77 |
77 } // namespace net | 78 } // namespace net |
78 | 79 |
79 #endif // NET_LOG_NET_LOG_LOGGER_H_ | 80 #endif // NET_LOG_NET_LOG_LOGGER_H_ |
OLD | NEW |