35 lines
1.2 KiB
Plaintext
35 lines
1.2 KiB
Plaintext
[[using-shell-components-flow]]
|
|
= Flow
|
|
|
|
ifndef::snippets[:snippets: ../../test/java/org/springframework/shell/docs]
|
|
|
|
When you use xref:using-shell-components-ui.adoc[Flow Components] to build something that involves
|
|
use of a multiple components, your implementation may become a bit cluttered.
|
|
To ease these use cases, we added a
|
|
`ComponentFlow` that can hook multiple component executions together
|
|
as a "`flow`".
|
|
|
|
The following listings show examples of flows and their output in a shell:
|
|
|
|
[source, java, indent=0]
|
|
----
|
|
include::{snippets}/FlowComponentSnippets.java[tag=snippet1]
|
|
----
|
|
|
|
image::component-flow-showcase-1.svg[text input]
|
|
|
|
Normal execution order of a components is same as defined with a builder. It's
|
|
possible to conditionally choose where to jump in a flow by using a `next`
|
|
function and returning target _component id_. If this returned id is aither _null_
|
|
or doesn't exist flow is essentially stopped right there.
|
|
|
|
[source, java, indent=0]
|
|
----
|
|
include::{snippets}/FlowComponentSnippets.java[tag=snippet2]
|
|
----
|
|
|
|
image::component-flow-conditional-1.svg[text input]
|
|
|
|
TIP: The result from running a flow returns `ComponentFlowResult`, which you can
|
|
use to do further actions.
|