org.zkoss.util.resource

Interface XMLResourcesLocator

All Superinterfaces:

Locator

All Known Implementing Classes:

ClassLocator

public interface XMLResourcesLocator
extends Locator

Represents a locator used to locate XML resources.

Since:

6.0.0

Author:

tomyeh

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	XMLResourcesLocator.Resource An item of the list returned by getDependentXMLResources(java.lang.String, java.lang.String, java.lang.String).

Method Summary

Modifier and Type	Method and Description
List<XMLResourcesLocator.Resource>	getDependentXMLResources(String name, String elName, String elDepends) Returns a list of resources (XMLResourcesLocator.Resource) after resolving the dependence.
Enumeration<URL>	getResources(String name) Returns an enumeration of resources.

Methods inherited from interface org.zkoss.util.resource.Locator

getDirectory, getResource, getResourceAsStream

Method Detail

getResources

Enumeration<URL> getResources(String name)
                       throws IOException

Returns an enumeration of resources. Unlike getDependentXMLResources(java.lang.String, java.lang.String, java.lang.String), it doesn't resolve the dependence among the resources.

Parameters:

name - the resource name, such as "metainfo/config.xml".

Throws:

IOException

getDependentXMLResources

List<XMLResourcesLocator.Resource> getDependentXMLResources(String name,
                                                            String elName,
                                                            String elDepends)
                                                     throws IOException

Returns a list of resources (XMLResourcesLocator.Resource) after resolving the dependence. The resource is returned in the format of XMLResourcesLocator.Resource

To resolve the dependence, it assumes each resource has two element whose name is identified by elName and elDepends. The elName element specifies the unique name of each resource. The elDepends element specifies a list of names of resources that this resource depends on. If not found, it assumes it could be loaded first.

Parameters:

name - the resource name, such as "metainfo/config.xml".

elName - the element used to specify the name.

elDepends - the element used to specify the dependence.

Returns:

a list of XMLResourcesLocator.Resource of the specified name.

Throws:

IOException