UI Factory"

From Documentation
m (remove empty version history (via JWB))
 
(4 intermediate revisions by 2 users not shown)
Line 3: Line 3:
 
<javadoc type="interface">org.zkoss.zk.ui.sys.UiFactory</javadoc> is used to instantiate all UI objects, such as session, desktop, and components, and to load ZUML documents. You could customize it to provide the functionality you want.
 
<javadoc type="interface">org.zkoss.zk.ui.sys.UiFactory</javadoc> is used to instantiate all UI objects, such as session, desktop, and components, and to load ZUML documents. You could customize it to provide the functionality you want.
  
For example, <javadoc>org.zkoss.zk.ui.http.SerializableUiFactory</javadoc> is the factory used to instantiate sessions that are serializable<ref>Then, the application is able to run in a clustering environment. Fore more information, please refer to the [[ZK Developer's Reference/Clustering/ZK Configuration|Clustering section]]</ref>, while <javadoc>org.zkoss.zk.ui.http.SimpleUiFactory</javadoc>, the default factory, instantiates non-serializable sessions.
+
For example, <javadoc>org.zkoss.zk.ui.http.SerializableUiFactory</javadoc> is the factory used to instantiate sessions that are serializable<ref>Then, the application is able to run in a clustering environment. For more information, please refer to the [[ZK Developer's Reference/Clustering/ZK Configuration|Clustering section]]</ref>, while <javadoc>org.zkoss.zk.ui.http.SimpleUiFactory</javadoc>, the default factory, instantiates non-serializable sessions.
  
 
Here are a list of customization you could do with UI Factory:
 
Here are a list of customization you could do with UI Factory:
Line 43: Line 43:
 
</source>
 
</source>
  
where we assume you implemented <tt>loadFromDatabase</tt> to load the ZUML document from a database.
+
where we assume you implemented <code>loadFromDatabase</code> to load the ZUML document from a database.
In addition, you have to implement <tt>getFromCache</tt> and <tt>setCache</tt> to cache the result in order to improve the performance of retrieving the document from the database.
+
In addition, you have to implement <code>getFromCache</code> and <code>setCache</code> to cache the result in order to improve the performance of retrieving the document from the database.
  
 
On the other hand, the parsing of the ZUML document can be done easily by calling <javadoc method="getPageDefinitionDirectly(org.zkoss.zk.ui.sys.RequestInfo, java.lang.String, java.lang.String)">org.zkoss.zk.ui.impl.AbstractUiFactory</javadoc>.
 
On the other hand, the parsing of the ZUML document can be done easily by calling <javadoc method="getPageDefinitionDirectly(org.zkoss.zk.ui.sys.RequestInfo, java.lang.String, java.lang.String)">org.zkoss.zk.ui.impl.AbstractUiFactory</javadoc>.
  
=Version History=
+
 
{{LastUpdated}}
 
{| border='1px' | width="100%"
 
! Version !! Date !! Content
 
|-
 
| &nbsp;
 
| &nbsp;
 
| &nbsp;
 
|}
 
  
 
{{ZKDevelopersReferencePageFooter}}
 
{{ZKDevelopersReferencePageFooter}}

Latest revision as of 04:33, 5 February 2024

UiFactory is used to instantiate all UI objects, such as session, desktop, and components, and to load ZUML documents. You could customize it to provide the functionality you want.

For example, SerializableUiFactory is the factory used to instantiate sessions that are serializable[1], while SimpleUiFactory, the default factory, instantiates non-serializable sessions.

Here are a list of customization you could do with UI Factory:

Notice that it is suggested to extend from either SerializableUiFactory or SimpleUiFactory, rather than to implement UiFactory from scratch.


  1. Then, the application is able to run in a clustering environment. For more information, please refer to the Clustering section

Load ZUML from Database

The default implementation of AbstractUiFactory.getPageDefinition(RequestInfo, String) loads the ZUML document from the Web application's resources (i.e., the files found in a Web application). If you prefer to load from other sources, such as a database, you could override it.

The pseudo code will look like the following:

public class MyUiFactory extends SimpleUiFactory {
    @Override
    public PageDefinition getPageDefinition(RequestInfo ri, String path) {
        PageDefinition pgdef = getFromCache(path); //your cache implementation
        if (pgdef == null) {
            String content = loadFromDatabase(path); //your resource loading
            pgdef = getPageDefinition(ri, content, "zul"); //delegate to SimpleUiFactory
            setCache(path, pgdef); //cache the result
        }
        return pgdef;
    }
}

where we assume you implemented loadFromDatabase to load the ZUML document from a database. In addition, you have to implement getFromCache and setCache to cache the result in order to improve the performance of retrieving the document from the database.

On the other hand, the parsing of the ZUML document can be done easily by calling AbstractUiFactory.getPageDefinitionDirectly(RequestInfo, String, String).




Last Update : 2024/02/05

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