org.zkoss.web.util.resource.dir"

From Documentation
Line 23: Line 23:
  
 
Then, you can place <tt>zk.wpd</tt> and required JavaScript files under the <tt>WEB-INF/cwr/js/foo/great</tt> directory.
 
Then, you can place <tt>zk.wpd</tt> and required JavaScript files under the <tt>WEB-INF/cwr/js/foo/great</tt> directory.
 +
 +
 +
== more details ==
 +
 +
For a normal scenario ,  maybe overwriting default Textbox behavior with allowkeys or change some behavior,
 +
in this case you just want to update Textbox js file in package zul.inp ,so you need not to overwrite all the files. 
 +
 +
you just setup the config .
 +
<source lang="xml">
 +
<library-property>
 +
<name>org.zkoss.web.util.resource.dir</name>
 +
<value>/WEB-INF/cwr</value>
 +
</library-property>
 +
</source>
 +
 +
And then place the modified version of Textbox.js  in  /WEB-INF/cwr/js/zul/inp/Textbox.js .
 +
 +
You need not to overwrite the wpd  and the other files in zul.inp  , ZK will find the old files and work correctly.
 +
 +
As same as before, only if you want to change the wpd script list , you need to overwrite the wpd files.
  
 
  {{ZKConfigurationReferencePageFooter}}
 
  {{ZKConfigurationReferencePageFooter}}

Revision as of 23:49, 20 January 2011


org.zkoss.web.util.resource.dir


Property:

 org.zkoss.web.util.resource.dir
Default: none
[Since 5.0.0]

It specifies a directory, where ZK will load the so-called Class-Web Resources (CWR), in addition to the class path. CWR includes JavaScript files, CSS files, and other resources that are specified in the form of ~./xxx.

By default, ZK only searches the class path for the required CWR. By specifying a directory here, ZK will search the directory first and then the class path. It implies a developer can override the default behavior by providing a file with the same name.

Notice: don't put security sensitive files in the directory specified here, since they can be accessed externally.

For example, assume we have a JavaScript package called foo.great and we want to put it to WEB-INF/cwr. Then, we have to specify the following in WEB-INF/zk.xml:

	<library-property>
		<name>org.zkoss.web.util.resource.dir</name>
		<value>/WEB-INF/cwr</value>
	</library-property>

Then, you can place zk.wpd and required JavaScript files under the WEB-INF/cwr/js/foo/great directory.


more details

For a normal scenario , maybe overwriting default Textbox behavior with allowkeys or change some behavior, in this case you just want to update Textbox js file in package zul.inp ,so you need not to overwrite all the files.

you just setup the config .

	<library-property>
		<name>org.zkoss.web.util.resource.dir</name>
		<value>/WEB-INF/cwr</value>
	</library-property>

And then place the modified version of Textbox.js in /WEB-INF/cwr/js/zul/inp/Textbox.js .

You need not to overwrite the wpd and the other files in zul.inp , ZK will find the old files and work correctly.

As same as before, only if you want to change the wpd script list , you need to overwrite the wpd files.



Last Update : 2011/01/20

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