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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
/*
* Copyright (C) 2014 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package android.net;
import static com.android.internal.util.Protocol.BASE_CONNECTIVITY_SERVICE;
/**
* Describes the Internal protocols used to communicate with ConnectivityService.
* @hide
*/
public class ConnectivityServiceProtocol {
private static final int BASE = BASE_CONNECTIVITY_SERVICE;
private ConnectivityServiceProtocol() {}
/**
* This is a contract between ConnectivityService and various bearers.
* A NetworkFactory is an abstract entity that creates NetworkAgent objects.
* The bearers register with ConnectivityService using
* ConnectivityManager.registerNetworkFactory, where they pass in a Messenger
* to be used to deliver the following Messages.
*/
public static class NetworkFactoryProtocol {
private NetworkFactoryProtocol() {}
/**
* Pass a network request to the bearer. If the bearer believes it can
* satisfy the request it should connect to the network and create a
* NetworkAgent. Once the NetworkAgent is fully functional it will
* register itself with ConnectivityService using registerNetworkAgent.
* If the bearer cannot immediately satisfy the request (no network,
* user disabled the radio, lower-scored network) it should remember
* any NetworkRequests it may be able to satisfy in the future. It may
* disregard any that it will never be able to service, for example
* those requiring a different bearer.
* msg.obj = NetworkRequest
* msg.arg1 = score - the score of the any network currently satisfying this
* request. If this bearer knows in advance it cannot
* exceed this score it should not try to connect, holding the request
* for the future.
* Note that subsequent events may give a different (lower
* or higher) score for this request, transmitted to each
* NetworkFactory through additional CMD_REQUEST_NETWORK msgs
* with the same NetworkRequest but an updated score.
* Also, network conditions may change for this bearer
* allowing for a better score in the future.
*/
public static final int CMD_REQUEST_NETWORK = BASE;
/**
* Cancel a network request
* msg.obj = NetworkRequest
*/
public static final int CMD_CANCEL_REQUEST = BASE + 1;
}
/**
* TODO - move to NetworkMonitor and document
*/
public static class NetworkMonitorProtocol {
private NetworkMonitorProtocol() {}
/**
* Inform NetworkMonitor that their network is connected.
* Initiates Network Validation.
*/
public static final int CMD_NETWORK_CONNECTED = BASE + 200;
/**
* Inform ConnectivityService that the network is validated.
* obj = NetworkAgent
*/
public static final int EVENT_NETWORK_VALIDATED = BASE + 201;
/**
* Inform NetworkMonitor to linger a network. The Monitor should
* start a timer and/or start watching for zero live connections while
* moving towards LINGER_COMPLETE. After the Linger period expires
* (or other events mark the end of the linger state) the LINGER_COMPLETE
* event should be sent to ConnectivityService and ConnectivityService
* will shut down the network, telling the corresponding NetworkAgent
* to disconnect. If a CMD_NETWORK_CONNECTED happens before the LINGER completes
* it indicates further desire to keep the network alive and so
* the LINGER is aborted.
* TODO - figure out who manages/does this simple state machine
*/
public static final int CMD_NETWORK_LINGER = BASE + 202;
/**
* Inform ConnectivityService that the network LINGER period has
* expired.
* obj = NetworkAgent
*/
public static final int EVENT_NETWORK_LINGER_COMPLETE = BASE + 203;
}
}
|
