安卓StateMachine分析举例---WifiStateMachine

WifiStateMachine创建：

创建在构造方法WifiStateMachine(Context context, String wlanInterface) 中实施：

public WifiStateMachine(Context context, String wlanInterface) {
/*调用stateMachine类的构造方法完成状态机的构造，名字为WifiStateMachine*/
super("WifiStateMachine");
/*添加状态*/
addState(mDefaultState);
addState(mInitialState, mDefaultState);
addState(mSupplicantStartingState, mDefaultState);
addState(mSupplicantStartedState, mDefaultState);
addState(mDriverStartingState, mSupplicantStartedState);
addState(mDriverStartedState, mSupplicantStartedState);
addState(mScanModeState, mDriverStartedState);
addState(mConnectModeState, mDriverStartedState);
addState(mL2ConnectedState, mConnectModeState);
addState(mObtainingIpState, mL2ConnectedState);
addState(mVerifyingLinkState, mL2ConnectedState);
addState(mCaptivePortalCheckState, mL2ConnectedState);
addState(mConnectedState, mL2ConnectedState);
addState(mDisconnectingState, mConnectModeState);
addState(mDisconnectedState, mConnectModeState);
addState(mWpsRunningState, mConnectModeState);
addState(mWaitForP2pDisableState, mSupplicantStartedState);
addState(mDriverStoppingState, mSupplicantStartedState);
addState(mDriverStoppedState, mSupplicantStartedState);
addState(mSupplicantStoppingState, mDefaultState);
addState(mSoftApStartingState, mDefaultState);
addState(mSoftApStartedState, mDefaultState);
addState(mTetheringState, mSoftApStartedState);
addState(mTetheredState, mSoftApStartedState);
addState(mUntetheringState, mSoftApStartedState);

/*设置初始状态*/
setInitialState(mInitialState);

/*设置状态日志记录*/
setLogRecSize(2000);
setLogOnlyTransitions(false);

/*开始状态机*/
start();

}

在start方法中，调用completeConstruction方法完成构造，这个方法之前已经分析过，主要是完成状态机棧的搭建，并发送启动完成的消息，将状态机运行起来。状态机起来后，分别运行mDefaultState和mInitialState的状态的enter方法，在mDefaultState的方法中do nothing，在mInitialState的enter方法中，进行了wifi相关的初始化，这里不做关注：

public void enter() {
mWifiNative.unloadDriver();
if (mWifiP2pChannel == null) {
mWifiP2pChannel = new AsyncChannel();
mWifiP2pChannel.connect(mContext, getHandler(), mWifiP2pManager.getMessenger());
}

if (mWifiApConfigChannel == null) {
mWifiApConfigChannel = new AsyncChannel();
WifiApConfigStore wifiApConfigStore = WifiApConfigStore.makeWifiApConfigStore(
mContext, getHandler());
wifiApConfigStore.loadApConfiguration();
mWifiApConfigChannel.connectSync(mContext, getHandler(),wifiApConfigStore.getMessenger());
}
}

至此WifiStateMachine创建成功，运行在InitialState状态，罗列一下各个状态之间的关系：

WifiStateMachine状态切换举例–开启AP：

调用setHostApRunning方法，开启AP功能，此方法发送CMD_START_AP消息

状态机启动后处于InitialState状态，收到CMD_START_AP消息后：

public boolean processMessage(Message message) {
switch (message.what) {
/*省略代码*/
case CMD_START_AP:
if (mWifiNative.loadDriver()) {
/*设置AP状态*/
setWifiApState(WIFI_AP_STATE_ENABLING);
/*状态切换mSoftApStartingState*/
transitionTo(mSoftApStartingState);
} else {
loge("Failed to load driver for softap");
}
/*省略代码*/
}
}

此消息处理函数处理完后，跳转到mSoftApStartingState

进入mSoftApStartingState的enter方法：

public void enter() {
final Message message = getCurrentMessage();
if (message.what == CMD_START_AP) {
final WifiConfiguration config = (WifiConfiguration) message.obj;

if (config == null) {
mWifiApConfigChannel.sendMessage(CMD_REQUEST_AP_CONFIG);
} else {
mWifiApConfigChannel.sendMessage(CMD_SET_AP_CONFIG, config);
/*开启AP*/
startSoftApWithConfig(config);
}
} else {
throw new RuntimeException("Illegal transition to SoftApStartingState: " + message);
}
}

startSoftApWithConfig开启AP成功后，会发送CMD_START_AP_SUCCESS消息，

SoftApStartingState状态下，处理此消息：

public boolean processMessage(Message message) {
switch(message.what) {
//
case CMD_START_AP_SUCCESS:
/*设置AP状态*/
setWifiApState(WIFI_AP_STATE_ENABLED);
/*跳转到mSoftApStartedState*/
transitionTo(mSoftApStartedState);
break;
}
}

CMD_START_AP_SUCCESS消息处理完后，跳转到mSoftApStartedState状态，执行该状态的enter方法。此状态下受到CMD_TETHER_STATE_CHANGE消息后处理：

public boolean processMessage(Message message) {
switch(message.what) {
//
case CMD_TETHER_STATE_CHANGE:
TetherStateChange stateChange = (TetherStateChange) message.obj;
/*开启tethering*/
if (startTethering(stateChange.available)) {
transitionTo(mTetheringState);
}
break;
}
}

开启startTethering成功后，跳转到mTetheringState状态，执行其enter方法：

public void enter() {
/*发送延时消息，超时时间5s*/
sendMessageDelayed(obtainMessage(CMD_TETHER_NOTIFICATION_TIMED_OUT,
++mTetherToken, 0), TETHER_NOTIFICATION_TIME_OUT_MSECS);
}

处于mTetheringState状态下，收到CMD_TETHER_NOTIFICATION_TIMED_OUT超时消息，则启动tether失败，一步步切换，退回到init状态。如果在超时消息之前收到CMD_TETHER_STATE_CHANGE消息，则走如下 处理：

public boolean processMessage(Message message) {

switch(message.what) {
/*省略代码*/
case CMD_TETHER_STATE_CHANGE:
TetherStateChange stateChange = (TetherStateChange) message.obj;
if (isWifiTethered(stateChange.active)) {
transitionTo(mTetheredState);
}
return HANDLED;
/*省略代码*/
}

如果isWifiTethered返回成功则跳转到mTetheredState状态，并执行其enter方法。否则，超时消息到达后关闭ap。

至此整个状态机的状态历经如下切换，稳定在mThertheredState

mInitialState->mSoftApStartingState->mSoftApStartedState->mThetheringState->mThertheredState

若在mThertheredState状态下关闭AP，则按照如下流程切换

mThertheredState->mUntetheringState->mSoftApStartedState->mInitialState

这个流程中用到了deferMessage来实现相同消息的反复发送。在StateMachine章节已论述。

根据源码分析，弄清一个状态机代码流程的关键点是根据源码画出状态关系图，再根据状态逐个进行推演。如果是定位问题，可以重点使用dump功能，将状态迁徙的过程dump出来，再结合logcat进行分析。