blob: 1bba9659158c2bce5b19f35ea8fcd44210e1bc17 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!--
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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.
-->
<ui:composition template="/main.xhtml"
xmlns="http://www.w3.org/1999/xhtml"
xmlns:tc="http://myfaces.apache.org/tobago/component"
xmlns:ui="http://xmlns.jcp.org/jsf/facelets">
<tc:badge markup="warning"
value="Warning: This example is turned off, because its not suppored in Quarkus!"/><br/>
<p>This page show a simple example for the <code>@ConversationScoped</code> annotation.
The <b>Conversationscope</b> is needed for situations when the controller must live longer than a single request,
but don't need to live the whole session.</p>
<p>A <code>@Inject Conversation conversation;</code> must be injected.
After that a conversation can be started with <code>conversation.begin()</code> and stopped with
<code>conversation.end()</code>.</p>
<tc:box label="Example">
<p>Counting up greater than '1' is only possible when a conversation is started.</p>
<tc:out label="Conversation" value="#{conversationController.conversationStatus}"/>
<tc:button label="Start Conversation" action="#{conversationController.beginConversation}"
rendered="#{conversationController.conversationStatus == 'stopped'}"/>
<tc:button label="Stop Conversation" action="#{conversationController.endConversation}"
rendered="#{conversationController.conversationStatus == 'started'}"/>
<tc:separator/>
<tc:out label="Count" value="#{conversationController.count}"/>
<tc:button label="Count Up" action="#{conversationController.countUp}"/>
</tc:box>
</ui:composition>