Inter-Desktop Communication"

From Documentation
m ((via JWB))
m (remove empty version history (via JWB))
 
(One intermediate revision by one other user not shown)
Line 9: Line 9:
 
* Use HTML IFRAME or FRAMESET to integrate multiple ZUML pages
 
* Use HTML IFRAME or FRAMESET to integrate multiple ZUML pages
 
* Use a portal server to integrate multiple ZK portlets
 
* Use a portal server to integrate multiple ZK portlets
* Assembly multiple ZUML pages at the client, such as the templating technology described in [[ZK Developer's Reference/Integration/Use ZK as Fragment in Foreign Templating Framework|this section]]
+
* Assemble multiple ZUML pages at the client, such as the templating technology described in [[ZK Developer's Reference/Integration/Use ZK as Fragment in Foreign Templating Framework|this section]]
  
In this case, you could communicate among desktops by the use of an event queue with the group scope (<javadoc method="DESKTOP">org.zkoss.zk.ui.event.EventQueues</javadoc>).
+
In this case, you could communicate among desktops by the use of an event queue with the group scope (<javadoc method="GROUP">org.zkoss.zk.ui.event.EventQueues</javadoc>).
  
 
<source lang="java" highlight="1">
 
<source lang="java" highlight="1">
Line 87: Line 87:
 
</source>
 
</source>
  
=Version History=
 
  
{| class='wikitable' | width="100%"
 
! Version !! Date !! Content
 
|-
 
| &nbsp;
 
| &nbsp;
 
| &nbsp;
 
|}
 
  
 
{{ZKDevelopersReferencePageFooter}}
 
{{ZKDevelopersReferencePageFooter}}

Latest revision as of 05:54, 6 February 2024


Inter-Desktop Communication


Unlike pages, you cannot access two desktops at the same time. You cannot send or post an event from one desktop to another directly either. Rather, we have to use an event queue with a proper scope, such as group, session or application -- depending on where the other desktop is located.

Desktops in the Same Browser Window

In most cases, each browser window has at most one desktop. However, it is still possible to have multiple desktops in one browser window:

  • Use HTML IFRAME or FRAMESET to integrate multiple ZUML pages
  • Use a portal server to integrate multiple ZK portlets
  • Assemble multiple ZUML pages at the client, such as the templating technology described in this section

In this case, you could communicate among desktops by the use of an event queue with the group scope (EventQueues.GROUP).

EventQueue que = EventQueues.lookup("groupTest", EventQueues.GROUP, true);
que.subscribe(new EventListener() {
	public void onEvent(Event evt) {
		//receive event from this event queue (within the same group of desktops)
	}
});

Notice that the desktop-scoped event queue does not require Server Push, so there is no performance impact at all.

Here is a dumb example: chat among iframes.

<!-- main -->
<window title="main" border="normal" onOK="publish()">
	<zscript>
	EventQueue que = EventQueues.lookup("groupTest", "group", true);
	que.subscribe(new EventListener() {
		public void onEvent(Event evt) {
			o.setValue(o.getValue() + evt.getData() + "\n");
		}
	});
	void publish() {
		String text = i.getValue();
		if (text.length() > 0) {
			i.setValue("");
			que.publish(new Event("onGroupTest", null, text));
		}
	}
	</zscript>
	Please enter:
	<textbox id="i" onChange="publish()"/>		
	<textbox id="o" rows="6"/>
	<separator/>
	<iframe src="includee.zul" height="500px" width="30%"/>
	<iframe src="includee.zul" height="500px" width="30%"/>
	<iframe src="includee.zul" height="500px" width="30%"/>
</window>

And, this is the ZUML page being referenced (by iframe).

<!-- includee.zul -->
<window title="frame2" border="normal" onOK="publish()">
	<zscript>
		EventQueue que = EventQueues.lookup("groupTest", "group", true);
		que.subscribe(new EventListener() {
			public void onEvent(Event evt) {
				o.setValue(o.getValue() + evt.getData() + "\n");
			}
		});
		void publish() {
			String text = i.getValue();
			if (text.length() > 0) {
				i.setValue("");
				que.publish(new Event("onGroupTest", null, text));
			}
		}
	</zscript>
	<textbox id="i" onChange="publish()"/>		
	<textbox id="o" rows="6"/>
</window>

Desktop in Different Sessions

Similarly, we could use an event queue to communicate among desktops belonging to different sessions. The only difference is to specify EventQueues.APPLICATION as the scope.

EventQueue que = EventQueues.lookup("groupTest", EventQueues.APPLICATION, true);




Last Update : 2024/02/06

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.