Examples of org.springframework.webflow.engine.Flow

Package org.springframework.webflow.engine

Examples of org.springframework.webflow.engine.Flow

org.springframework.webflow.engine.Flow
A single flow definition. A Flow definition is a reusable, self-contained controller module that provides the blue print for a user dialog or conversation. Flows typically drive controlled navigations within web applications to guide users through fulfillment of a business process/goal that takes place over a series of steps, modeled as states.
A simple Flow definition could do nothing more than execute an action and display a view all in one request. A more elaborate Flow definition may be long-lived and execute across a series of requests, invoking many possible paths, actions, and subflows.
Especially in Intranet applications there are often "controlled navigations" where the user is not free to do what he or she wants but must follow the guidelines provided by the system to complete a process that is transactional in nature (the quintessential example would be a 'checkout' flow of a shopping cart application). This is a typical use case appropriate to model as a flow.
Structurally a Flow is composed of a set of states. A {@link State} is a point in a flow where a behavior isexecuted; for example, showing a view, executing an action, spawning a subflow, or terminating the flow. Different types of states execute different behaviors in a polymorphic fashion.
Each {@link TransitionableState} type has one or more transitions that when executed move a flow to another state.These transitions define the supported paths through the flow.
A state transition is triggered by the occurrence of an event. An event is something that happens the flow should respond to, for example a user input event like ("submit") or an action execution result event like ("success"). When an event occurs in a state of a Flow that event drives a state transition that decides what to do next.
Each Flow has exactly one start state. A start state is simply a marker noting the state executions of this Flow definition should start in. The first state added to the flow will become the start state by default.
Flow definitions may have one or more flow exception handlers. A {@link FlowExecutionExceptionHandler} can executecustom behavior in response to a specific exception (or set of exceptions) that occur in a state of one of this flow's executions.
Instances of this class are typically built by {@link org.springframework.webflow.engine.builder.FlowBuilder}implementations but may also be directly instantiated.
This class and the rest of the Spring Web Flow (SWF) engine have been designed with minimal dependencies on other libraries. Spring Web Flow is usable in a standalone fashion. The engine system is fully usable outside an HTTP servlet environment, for example in portlets, tests, or standalone applications. One of the major architectural benefits of Spring Web Flow is the ability to design reusable, high-level controller modules that may be executed in any environment.
Note: flows are singleton definition objects so they should be thread-safe. You can think a flow definition as analogous to a Java class, defining all the behavior of an application module. The core behaviors {@link #start(RequestControlContext,MutableAttributeMap) start}, {@link #resume(RequestControlContext)}, {@link #handleEvent(RequestControlContext) on event}, {@link #end(RequestControlContext,String,MutableAttributeMap) end}, and {@link #handleException(FlowExecutionException,RequestControlContext)}. Each method accepts a {@link RequestContext request context} that allows for this flow to access execution state in a thread safe manner. A flow execution iswhat models a running instance of this flow definition, somewhat analogous to a java object that is an instance of a class. @see org.springframework.webflow.engine.State @see org.springframework.webflow.engine.ActionState @see org.springframework.webflow.engine.ViewState @see org.springframework.webflow.engine.SubflowState @see org.springframework.webflow.engine.EndState @see org.springframework.webflow.engine.DecisionState @see org.springframework.webflow.engine.Transition @see org.springframework.webflow.engine.FlowExecutionExceptionHandler @author Keith Donald @author Erwin Vervaet @author Colin Sampaleanu @author Jeremy Grelle

    assertTrue(execution.hasEnded());
    assertNotNull(execution.getFlashScope().get("messagesMemento"));
  }


  public void testStartAndPause() {
    Flow flow = new Flow("flow");
    new State(flow, "state") {
      protected void doEnter(RequestControlContext context) throws FlowExecutionException {
        // no op
      }
    };

View Full Code Here

    assertTrue(execution.isActive());
    assertEquals(1, mockListener.getPausedCount());
  }


  public void testStartWithNullInputMap() {
    Flow flow = new Flow("flow");
    new State(flow, "state") {
      protected void doEnter(RequestControlContext context) throws FlowExecutionException {
        // no op
      }
    };

View Full Code Here

    assertTrue(execution.isActive());
    assertEquals(1, mockListener.getPausedCount());
  }


  public void testStartExceptionThrownBeforeFirstSessionCreated() {
    Flow flow = new Flow("flow");
    flow.getExceptionHandlerSet().add(new FlowExecutionExceptionHandler() {
      public boolean canHandle(FlowExecutionException exception) {
        return true;
      }


      public void handle(FlowExecutionException exception, RequestControlContext context) {
        throw new UnsupportedOperationException("Should not be called");
      }


    });
    new EndState(flow, "end");
    FlowExecutionListener mockListener = new FlowExecutionListenerAdapter() {
      public void sessionCreating(RequestContext context, FlowDefinition definition) {
        assertFalse(context.getFlowExecutionContext().isActive());
        throw new IllegalStateException("Oops");
      }
    };
    FlowExecutionListener[] listeners = new FlowExecutionListener[] { mockListener };
    FlowExecutionImpl execution = new FlowExecutionImpl(flow);
    execution.setListeners(listeners);
    MockExternalContext context = new MockExternalContext();
    assertFalse(execution.hasStarted());
    try {
      execution.start(null, context);
      fail("Should have failed");
    } catch (FlowExecutionException e) {
      assertEquals(flow.getId(), e.getFlowId());
      assertNull(e.getStateId());
      assertTrue(e.getCause() instanceof IllegalStateException);
      e.printStackTrace();
      assertTrue(e.getCause().getMessage().equals("Oops"));
    }

View Full Code Here

      assertTrue(e.getCause().getMessage().equals("Oops"));
    }
  }


  public void testStartExceptionThrownByState() {
    Flow flow = new Flow("flow");
    State state = new State(flow, "state") {
      protected void doEnter(RequestControlContext context) throws FlowExecutionException {
        throw new IllegalStateException("Oops");
      }
    };
    FlowExecutionImpl execution = new FlowExecutionImpl(flow);
    MockExternalContext context = new MockExternalContext();
    assertFalse(execution.hasStarted());
    try {
      execution.start(null, context);
      fail("Should have failed");
    } catch (FlowExecutionException e) {
      assertEquals(flow.getId(), e.getFlowId());
      assertEquals(state.getId(), e.getStateId());
    }
  }

View Full Code Here

      assertEquals(state.getId(), e.getStateId());
    }
  }


  public void testStartFlowExecutionExceptionThrownByState() {
    Flow flow = new Flow("flow");
    final FlowExecutionException e = new FlowExecutionException("flow", "state", "Oops");
    new State(flow, "state") {
      protected void doEnter(RequestControlContext context) throws FlowExecutionException {
        throw e;
      }

View Full Code Here

      assertSame(e, ex);
    }
  }


  public void testStartExceptionThrownByStateHandledByFlowExceptionHandler() {
    Flow flow = new Flow("flow");
    StubFlowExecutionExceptionHandler exceptionHandler = new StubFlowExecutionExceptionHandler();
    flow.getExceptionHandlerSet().add(exceptionHandler);
    final FlowExecutionException e = new FlowExecutionException("flow", "state", "Oops");
    new State(flow, "state") {
      protected void doEnter(RequestControlContext context) throws FlowExecutionException {
        throw e;
      }

View Full Code Here

    execution.start(null, context);
    assertTrue(exceptionHandler.getHandled());
  }


  public void testStartExceptionThrownByStateHandledByStateExceptionHandler() {
    Flow flow = new Flow("flow");
    flow.getExceptionHandlerSet().add(new StubFlowExecutionExceptionHandler());
    final FlowExecutionException e = new FlowExecutionException("flow", "state", "Oops");
    State s = new State(flow, "state") {
      protected void doEnter(RequestControlContext context) throws FlowExecutionException {
        throw e;
      }

View Full Code Here

    execution.start(null, context);
    assertTrue(exceptionHandler.getHandled());
  }


  public void testExceptionHandledByNestedExceptionHandler() {
    Flow flow = new Flow("flow");
    ExceptionThrowingExceptionHandler exceptionHandler = new ExceptionThrowingExceptionHandler(true);
    flow.getExceptionHandlerSet().add(exceptionHandler);
    new State(flow, "state") {
      protected void doEnter(RequestControlContext context) throws FlowExecutionException {
        throw new FlowExecutionException("flow", "state", "Oops");
      }
    };

View Full Code Here

    execution.start(null, context);
    assertEquals(2, exceptionHandler.getHandleCount());
  }


  public void testStartCannotCallTwice() {
    Flow flow = new Flow("flow");
    new EndState(flow, "end");
    FlowExecutionImpl execution = new FlowExecutionImpl(flow);
    MockExternalContext context = new MockExternalContext();
    execution.start(null, context);
    try {

View Full Code Here


    }
  }


  public void testResume() {
    Flow flow = new Flow("flow");
    new ViewState(flow, "view", new StubViewFactory());
    MockFlowExecutionListener mockListener = new MockFlowExecutionListener();
    FlowExecutionListener[] listeners = new FlowExecutionListener[] { mockListener };
    FlowExecutionImpl execution = new FlowExecutionImpl(flow);
    execution.setListeners(listeners);

View Full Code Here

0 1 2 3 4 5 6 7 8 9

TOP

Related Classes of org.springframework.webflow.engine.Flow

com.example.bookstore.web.controller.CreateOrderTest

org.jasig.cas.web.flow.CasFlowExecutionKeyFactoryTests

org.springframework.binding.mapping.MappingResults

org.springframework.core.style.ToStringCreator

org.springframework.faces.webflow.FlowActionListenerTests$MockViewState

org.springframework.webflow.config.FlowExecutorFactoryBeanTests

org.springframework.webflow.engine.builder.FlowAssemblerTests

org.springframework.webflow.engine.builder.model.FlowModelFlowBuilder

org.springframework.webflow.engine.builder.model.FlowModelFlowBuilderTests

org.springframework.webflow.engine.builder.support.TextToTransitionCriteriaTests

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.