SPR-6423, conversation object

Micha Kiener · Micha Kiener · commit 21e9bfd0eb33 · 2010-01-07T07:37:29.000Z
diff --git a/org.springframework.context/src/main/java/org/springframework/conversation/Conversation.java b/org.springframework.context/src/main/java/org/springframework/conversation/Conversation.java
@@ -54,6 +54,16 @@ public interface Conversation {
 	 */
 	void end(ConversationEndingType endingType);
 
+	/**
+	 * If this is a switched conversation (was created through
+	 * {@link JoinMode#SWITCHED}, this method might be used to make this
+	 * conversation the active one. If there is a current one active which is
+	 * not switched, it is ended, if the current one is also a switched one, it
+	 * is deactivated, but not ended. Invoking this method has the same effect
+	 * as {@link ConversationManager#switchConversation(String)}.
+	 */
+	void switchTo();
+
 	/**
 	 * Stores the given value in this conversation using the specified name. If
 	 * this state already contains a value attached to the given name, it is
@@ -167,6 +177,17 @@ public interface Conversation {
 	 */
 	boolean isNested();
 
+	/**
+	 * Returns <code>true</code>, if this is a switched conversation. A switched
+	 * conversation must be ended explicitly as it is not ended implicitly by
+	 * creating a new one for instance, however, if there is a timeout being
+	 * specified and a switched conversation is not used, it is ended
+	 * implicitly, otherwise you have to end a switched conversation manually.
+	 * 
+	 * @return <code>true</code>, if this is a switched conversation
+	 */
+	boolean isSwtiched();
+
 	/**
 	 * Returns <code>true</code>, if this is a nested, isolated conversation so
 	 * that it does not inherit the state from its parent but rather has its own
diff --git a/org.springframework.context/src/main/java/org/springframework/conversation/manager/ConversationImpl.java b/org.springframework.context/src/main/java/org/springframework/conversation/manager/ConversationImpl.java
@@ -69,6 +69,9 @@ public class ConversationImpl extends DestructionAwareAttributeMap implements Mu
 	 */
 	private boolean isolated;
 
+	/** Flag, indicating whether this is a switched conversation. */
+	private boolean switched;
+
 	/**
 	 * The join count which is increased on the joining method and decreased on
 	 * the end method.
@@ -164,6 +167,13 @@ public void begin() {
 		temporary = false;
 	}
 
+	/**
+	 * @see org.springframework.conversation.Conversation#switchTo()
+	 */
+	public void switchTo() {
+		manager.switchConversation(getId());
+	}
+
 	/**
 	 * Is just delegated to
 	 * {@link ConversationManager#endConversation(Conversation, ConversationEndingType)}
@@ -336,6 +346,13 @@ public boolean isIsolated() {
 		return isolated;
 	}
 
+	/**
+	 * @see org.springframework.conversation.Conversation#isSwtiched()
+	 */
+	public boolean isSwtiched() {
+		return switched;
+	}
+
 	/**
 	 * @see org.springframework.conversation.Conversation#isEnded()
 	 */
