The disable-event-thread Element"

From Documentation
m
 
(5 intermediate revisions by 3 users not shown)
Line 2: Line 2:
  
 
'''Syntax:'''
 
'''Syntax:'''
−
  <au-decoder-class>''a_class_name''</au-decoder-class>
+
  <disable-event-thread>'''true'''|false</disable-event-thread>
  
−
[Default: null (using the default JSON-based format)]
+
{{deprecatedSince| 7.0.0}}
−
[since 5.0.4]
+
Deprecated to enable the event thread according to Java Servlet Specification that may prohibit the creation of new threads
  
−
It specifies which class used to implement the AU decoder.  The AU decoder is used to decode the AU requests. The class must implement <javadoc type="interface">org.zkoss.zk.au.AuDecoder</javadoc>.
+
{{versionSince|3.0.0}}
 +
  [Default: false]
 +
{{versionSince|5.0.0}}
 +
[Default: true](disabled)
  
−
By default, the AU request is sent in the JSON format. If you prefer to use another format, you could provide an implementation as follows.
+
It specifies whether to disable the use of the event processing thread. If disabled, no event processing thread will be used at all. In other words, all events are processed in the same thread that serves HTTP requests (so-called Servlet thread) directly.
  
−
#Implement <javadoc type="interface">org.zkoss.zk.au.AuDecoder</javadoc>
+
For better performance (and better compatibility with other frameworks), it is recommended to disable the use of the event processing thread. Please refer to [[ZK Developer's Reference/UI Patterns/Event Threads|ZK Developer's Reference: Event Threads]] for more information.
−
#Register it by specifying it with the <code>au-decoder-class</code> element in <code>WEB-INF/zk.xml</code>
 
−
#Override a JavaScript method called <javadoc directory="jsdoc" method="encode(int, zk.Event, zk.Desktop)">_global_.zAu</javadoc>  to encode to the custom format
 
  
−
=Version History=
+
Enable the event thread only if the project does not need to integrate other frameworks (such as Spring), uses <javadoc>org.zkoss.zul.Messagebox</javadoc> and modal windows a lot, and does not have a lot of concurrent users.
−
{{LastUpdated}}
 
−
{| border='1px' | width="100%"
 
−
! Version !! Date !! Content
 
−
|-
 
−
| &nbsp;
 
−
| &nbsp;
 
−
| &nbsp;
 
−
|}
 
  
 
{{ZKConfigurationReferencePageFooter}}
 
{{ZKConfigurationReferencePageFooter}}

Latest revision as of 02:33, 19 January 2024


DocumentationZK Configuration Referencezk.xmlThe system-config ElementThe disable-event-thread Element
The disable-event-thread Element


Syntax: 

<disable-event-thread>true|false</disable-event-thread>

Deprecated Since 7.0.0 

Deprecated to enable the event thread according to Java Servlet Specification that may prohibit the creation of new threads

Since 3.0.0 

[Default: false]

Since 5.0.0 

[Default: true](disabled)

It specifies whether to disable the use of the event processing thread. If disabled, no event processing thread will be used at all. In other words, all events are processed in the same thread that serves HTTP requests (so-called Servlet thread) directly.

For better performance (and better compatibility with other frameworks), it is recommended to disable the use of the event processing thread. Please refer to ZK Developer's Reference: Event Threads for more information.

Enable the event thread only if the project does not need to integrate other frameworks (such as Spring), uses Messagebox and modal windows a lot, and does not have a lot of concurrent users.



Last Update : 2024/01/19

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


Retrieved from "https://www.zkoss.org/_w/index.php?title=ZK_Configuration_Reference/zk.xml/The_system-config_Element/The_disable-event-thread_Element&oldid=56565"