1d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu/* 2d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * Copyright (C) 2015 The Android Open Source Project 3d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * 4d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * Licensed under the Apache License, Version 2.0 (the "License"); 5d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * you may not use this file except in compliance with the License. 6d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * You may obtain a copy of the License at 7d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * 8d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * http://www.apache.org/licenses/LICENSE-2.0 9d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * 10d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * Unless required by applicable law or agreed to in writing, software 11d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * distributed under the License is distributed on an "AS IS" BASIS, 12d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * See the License for the specific language governing permissions and 14d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * limitations under the License. 15d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu */ 16d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu 17d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hupackage com.android.camera.captureintent.stateful; 18d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu 19d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Huimport javax.annotation.Nonnull; 20d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu 21d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu/** 22d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * Defines a state machine interface that any implementation of this interface 23d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * is able to transition among different {@link State} and process various 24d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * {@link Event}. 25d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu */ 26d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hupublic interface StateMachine { 27d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu /** 28d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * Obtains the current state. 29d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * 30d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * @return A {@link State} object that represents the current state. 31d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu */ 32d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu public State getCurrentState(); 33d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu 34d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu /** 35d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * Sets the initial state of the state machine. 36d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * 37d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * @param initialState An initial {@link State}. 38d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * @return True if the operation is succeeded. 39d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu */ 40d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu public boolean setInitialState(@Nonnull State initialState); 41d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu 42d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu /** 43d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * Process a specified {@link Event} and potentially change the current 44d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * state. 45d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * 46d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * This method is thread-safe so it could be called on different threads. 47d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * Only one event could be processed at a time. 48d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * 49d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu * @param event An {@link Event} to be processed. 50d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu */ 51d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu public void processEvent(Event event); 52d2d86155337a7dd9fd285a25c93e27dc05200ed1Senpo Hu} 53