author | Eugene Ostroukhov <eugeneo@symbian.org> |
Mon, 07 Jun 2010 13:48:20 -0700 | |
changeset 351 | e317b108976d |
parent 52 | f577ea64429e |
permissions | -rw-r--r-- |
2 | 1 |
// Copyright (c) 2009 The Chromium Authors. All rights reserved. |
2 |
// Use of this source code is governed by a BSD-style license that can be |
|
3 |
// found in the LICENSE file. |
|
4 |
||
5 |
package org.chromium.sdk; |
|
6 |
||
7 |
import java.io.Writer; |
|
8 |
||
9 |
/** |
|
10 |
* Logger facility for the Chromium debugger connection. It can eavesdrop both |
|
11 |
* incoming and outgoing streams and log them somewhere. To make other code |
|
12 |
* less dependent on this interface, it works by wrapping reader/writer and is |
|
13 |
* only visible at start-up time. This approach has its disadvantages, because |
|
14 |
* it works with raw data streams, which are not perfectly formatted for human |
|
15 |
* reading. E.g. adjacent requests or responses are not separated even |
|
16 |
* by EOL. |
|
17 |
*/ |
|
18 |
public interface ConnectionLogger { |
|
19 |
/** |
|
20 |
* @return new writer that should pass all data to {@code streamWriter} and |
|
21 |
* silently copy it elsewhere (without additional exceptions). |
|
22 |
*/ |
|
52
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
23 |
LoggableWriter wrapWriter(LoggableWriter streamWriter); |
2 | 24 |
|
25 |
/** |
|
26 |
* @return new reader that should give access to all data |
|
27 |
* from {@code streamReader} and silently copy it elsewhere (without |
|
28 |
* additional exceptions). |
|
29 |
*/ |
|
52
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
30 |
LoggableReader wrapReader(LoggableReader streamReader); |
2 | 31 |
|
32 |
/** |
|
33 |
* Connection may allow the logger to close it. It is nice for UI, where |
|
34 |
* user sees logger and the corresponding stop button. |
|
35 |
* TODO(peter.rybin): consider removing it out of logging. |
|
36 |
*/ |
|
37 |
void setConnectionCloser(ConnectionCloser connectionCloser); |
|
38 |
||
39 |
/** |
|
40 |
* Interface that gives you control over underlying connection. |
|
41 |
*/ |
|
42 |
interface ConnectionCloser { |
|
43 |
void closeConnection(); |
|
44 |
} |
|
45 |
||
46 |
/** |
|
47 |
* Notifies logger that actual transmission is starting. After this {@link #handleEos()} |
|
48 |
* is guaranteed to be called. |
|
49 |
*/ |
|
50 |
void start(); |
|
51 |
||
52 |
/** |
|
53 |
* Notifies logger that EOS has been received from remote. Technically some |
|
54 |
* traffic still may go through writer (i.e. be sent to remote) after this. |
|
55 |
*/ |
|
56 |
void handleEos(); |
|
57 |
||
58 |
/** |
|
59 |
* Factory for connection logger. ConnectionLogger is NOT reconnectable. |
|
60 |
*/ |
|
61 |
interface Factory { |
|
62 |
/** |
|
63 |
* Creates new instance of {@link ConnectionLogger}. |
|
64 |
*/ |
|
65 |
ConnectionLogger newConnectionLogger(); |
|
66 |
} |
|
52
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
67 |
|
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
68 |
/** |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
69 |
* Reader that allows client to add marks to stream. These marks may become visible in log |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
70 |
* console. |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
71 |
*/ |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
72 |
interface LoggableReader { |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
73 |
LineReader getReader(); |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
74 |
|
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
75 |
/** |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
76 |
* Add log mark at current reader's position. |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
77 |
*/ |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
78 |
void markSeparatorForLog(); |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
79 |
} |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
80 |
|
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
81 |
/** |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
82 |
* Writer that allows client to add marks to stream. These marks may become visible in log |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
83 |
* console. |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
84 |
*/ |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
85 |
interface LoggableWriter { |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
86 |
Writer getWriter(); |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
87 |
|
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
88 |
/** |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
89 |
* Add log mark at current writer's position. |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
90 |
*/ |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
91 |
void markSeparatorForLog(); |
f577ea64429e
Migrated to unmodified Chromium Development Tools version
Eugene Ostroukhov <eugeneo@symbian.org>
parents:
2
diff
changeset
|
92 |
} |
2 | 93 |
} |