/* * Copyright (C) 2010 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 com.android.connectivitymanagertest; import android.net.NetworkInfo.State; import android.util.Log; import java.util.List; import java.util.ArrayList; public class NetworkState { public static final int TO_DISCONNECTION = 0; // transition to disconnection public static final int TO_CONNECTION = 1; // transition to connection public static final int DO_NOTHING = -1; // no state change private final String LOG_TAG = "NetworkState"; private List mStateDepository; private State mTransitionTarget; private int mTransitionDirection; private String mReason = null; // record mReason of state transition failure public NetworkState() { mStateDepository = new ArrayList(); mTransitionDirection = DO_NOTHING; mTransitionTarget = State.UNKNOWN; } public NetworkState(State currentState) { mStateDepository = new ArrayList(); mStateDepository.add(currentState); mTransitionDirection = DO_NOTHING; mTransitionTarget = State.UNKNOWN; } // Reinitialize the network state public void resetNetworkState() { mStateDepository.clear(); mTransitionDirection = DO_NOTHING; mTransitionTarget = State.UNKNOWN; } // set the transition criteria, transitionDir could be: // DO_NOTHING, TO_CONNECTION, TO_DISCONNECTION public void setStateTransitionCriteria(State initState, int transitionDir, State targetState) { if (!mStateDepository.isEmpty()) { mStateDepository.clear(); } mStateDepository.add(initState); mTransitionDirection = transitionDir; mTransitionTarget = targetState; Log.v(LOG_TAG, "setStateTransitionCriteria: " + printStates()); } public void recordState(State currentState) { mStateDepository.add(currentState); } // Verify state transition public boolean validateStateTransition() { Log.v(LOG_TAG, "print state depository: " + printStates()); if (mTransitionDirection == DO_NOTHING) { if (mStateDepository.isEmpty()) { Log.v(LOG_TAG, "no state is recorded"); mReason = "no state is recorded."; return false; } else if (mStateDepository.size() > 1) { for (int i = 0; i < mStateDepository.size(); i++) { if (mStateDepository.get(i) != mTransitionTarget) { Log.v(LOG_TAG, "state changed."); mReason = "Unexpected state change"; return false; } } } else if (mStateDepository.get(0) != mTransitionTarget) { Log.v(LOG_TAG, mTransitionTarget + " is expected, but it is " + mStateDepository.get(0)); mReason = mTransitionTarget + " is expected, but it is " + mStateDepository.get(0); return false; } return true; } else if (mTransitionDirection == TO_CONNECTION) { Log.v(LOG_TAG, "transition to CONNECTED"); return transitToConnection(); } else { Log.v(LOG_TAG, "transition to DISCONNECTED"); return transitToDisconnection(); } } /* * Transition from CONNECTED -> DISCONNECTED: * CONNECTED->DISCONNECTING->DISCONNECTED * return false if any state transition is not valid and save a message in mReason */ public boolean transitToDisconnection () { mReason = "states: " + printStates(); if (mStateDepository.get(0) != State.CONNECTED) { mReason += " initial state should be CONNECTED, but it is " + mStateDepository.get(0) + "."; return false; } State lastState = mStateDepository.get(mStateDepository.size() - 1); if ( lastState != mTransitionTarget) { mReason += " the last state should be DISCONNECTED, but it is " + lastState; return false; } for (int i = 1; i < mStateDepository.size() - 1; i++) { State preState = mStateDepository.get(i-1); State curState = mStateDepository.get(i); if ((preState == State.CONNECTED) && ((curState == State.DISCONNECTING) || (curState == State.DISCONNECTED))) { continue; } else if ((preState == State.DISCONNECTING) && (curState == State.DISCONNECTED)) { continue; } else if ((preState == State.DISCONNECTED) && (curState == State.DISCONNECTED)) { continue; } else { mReason += " Transition state from " + preState.toString() + " to " + curState.toString() + " is not valid."; return false; } } return true; } // DISCONNECTED->CONNECTING->CONNECTED public boolean transitToConnection() { mReason = "states: " + printStates(); if (mStateDepository.get(0) != State.DISCONNECTED) { mReason += " initial state should be DISCONNECTED, but it is " + mStateDepository.get(0) + "."; return false; } State lastState = mStateDepository.get(mStateDepository.size() - 1); if ( lastState != mTransitionTarget) { mReason += "The last state should be " + mTransitionTarget + ", but it is " + lastState; return false; } for (int i = 1; i < mStateDepository.size(); i++) { State preState = mStateDepository.get(i-1); State curState = mStateDepository.get(i); if ((preState == State.DISCONNECTED) && ((curState == State.CONNECTING) || (curState == State.CONNECTED) || (curState == State.DISCONNECTED))) { continue; } else if ((preState == State.CONNECTING) && (curState == State.CONNECTED)) { continue; } else if ((preState == State.CONNECTED) && (curState == State.CONNECTED)) { continue; } else { mReason += " Transition state from " + preState.toString() + " to " + curState.toString() + " is not valid."; return false; } } return true; } public List getTransitionStates() { return mStateDepository; } // return state failure mReason public String getReason() { return mReason; } public String printStates() { StringBuilder stateBuilder = new StringBuilder(""); for (int i = 0; i < mStateDepository.size(); i++) { stateBuilder.append(" ").append(mStateDepository.get(i).toString()).append("->"); } return stateBuilder.toString(); } @Override public String toString() { StringBuilder builder = new StringBuilder(" "); builder.append("mTransitionDirection: ").append(Integer.toString(mTransitionDirection)). append("; ").append("states:"). append(printStates()).append("; "); return builder.toString(); } }