org.springframework.statemachine.state.JunctionPseudoState.java Source code

Introduction

Here is the source code for org.springframework.statemachine.state.JunctionPseudoState.java

Source

/*
 * Copyright 2016-2017 the original author or authors.
 *
 * 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
 *
 * https://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 org.springframework.statemachine.state;

import java.util.Collection;
import java.util.List;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.springframework.statemachine.StateContext;
import org.springframework.statemachine.action.Action;
import org.springframework.statemachine.guard.Guard;
import org.springframework.util.Assert;

/**
 * Junction implementation of a {@link PseudoState}.
 *
 * @author Janne Valkealahti
 *
 * @param <S> the type of state
 * @param <E> the type of event
 */
public class JunctionPseudoState<S, E> implements PseudoState<S, E> {

    private final static Log log = LogFactory.getLog(JunctionPseudoState.class);
    private final List<JunctionStateData<S, E>> junctions;

    /**
     * Instantiates a new junction pseudo state.
     *
     * @param junctions the junctions
     */
    public JunctionPseudoState(List<JunctionStateData<S, E>> junctions) {
        this.junctions = junctions;
    }

    @Override
    public PseudoStateKind getKind() {
        return PseudoStateKind.JUNCTION;
    }

    @Override
    public State<S, E> entry(StateContext<S, E> context) {
        State<S, E> s = null;
        JunctionStateData<S, E> jsd = null;
        for (JunctionStateData<S, E> j : junctions) {
            jsd = j;
            if (j.guard != null && evaluateInternal(j.guard, context)) {
                break;
            }
        }
        if (jsd != null) {
            s = jsd.getState();
            executeActions(jsd.getActions(), context);
        }
        return s;
    }

    @Override
    public void exit(StateContext<S, E> context) {
    }

    @Override
    public void addPseudoStateListener(PseudoStateListener<S, E> listener) {
    }

    @Override
    public void setPseudoStateListeners(List<PseudoStateListener<S, E>> listeners) {
    }

    private boolean evaluateInternal(Guard<S, E> guard, StateContext<S, E> context) {
        try {
            return guard.evaluate(context);
        } catch (Throwable t) {
            log.warn("Deny guard due to throw as GUARD should not error", t);
            return false;
        }
    }

    private void executeActions(Collection<Action<S, E>> actions, StateContext<S, E> context) {
        if (actions == null) {
            return;
        }
        for (Action<S, E> action : actions) {
            try {
                action.execute(context);
            } catch (Throwable t) {
                log.warn("Action execution resulted error", t);
            }
        }
    }

    /**
     * Data class wrapping choice {@link State} and {@link Guard}
     * together.
     *
     * @param <S> the type of state
     * @param <E> the type of event
     */
    public static class JunctionStateData<S, E> {
        private final StateHolder<S, E> state;
        private final Guard<S, E> guard;
        private final Collection<Action<S, E>> actions;

        /**
         * Instantiates a new junction state data.
         *
         * @param state the state holder
         * @param guard the guard
         * @param actions the actions
         */
        public JunctionStateData(StateHolder<S, E> state, Guard<S, E> guard, Collection<Action<S, E>> actions) {
            Assert.notNull(state, "Holder must be set");
            this.state = state;
            this.guard = guard;
            this.actions = actions;
        }

        /**
         * Gets the state holder.
         *
         * @return the state holder
         */
        public StateHolder<S, E> getStateHolder() {
            return state;
        }

        /**
         * Gets the state.
         *
         * @return the state
         */
        public State<S, E> getState() {
            return state.getState();
        }

        /**
         * Gets the guard.
         *
         * @return the guard
         */
        public Guard<S, E> getGuard() {
            return guard;
        }

        /**
         * Gets the actions.
         *
         * @return the actions
         */
        public Collection<Action<S, E>> getActions() {
            return actions;
        }
    }
}