Author: ehillenius
Date: Sat Jun  2 19:42:59 2007
New Revision: 543830

URL: http://svn.apache.org/viewvc?view=rev&rev=543830
Log:
javadoc

Modified:
    
incubator/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/resource/locator/IResourceStreamLocator.java

Modified: 
incubator/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/resource/locator/IResourceStreamLocator.java
URL: 
http://svn.apache.org/viewvc/incubator/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/resource/locator/IResourceStreamLocator.java?view=diff&rev=543830&r1=543829&r2=543830
==============================================================================
--- 
incubator/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/resource/locator/IResourceStreamLocator.java
 (original)
+++ 
incubator/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/resource/locator/IResourceStreamLocator.java
 Sat Jun  2 19:42:59 2007
@@ -29,24 +29,22 @@
 public interface IResourceStreamLocator
 {
        /**
-        * Loads a resource, given a path, style, locale and extension.
+        * Loads a resource, given a path and class. Typically this method is 
either
+        * called by external clients if they are not interested in a lookup 
that
+        * takes the style and locale into account, or it is called by the
+        * implementation of [EMAIL PROTECTED] #locate(Class, String, String, 
Locale, String)}
+        * where the latter just takes care of trying out the different 
combinations
+        * for the provided style and locale and uses this method to actually 
load
+        * the resource stream.
         * 
         * @param clazz
         *            The class loader for delegating the loading of the 
resource
         * @param path
         *            The path of the resource
-        * @param style
-        *            Any resource style, such as a skin style (see
-        *            [EMAIL PROTECTED] org.apache.wicket.Session})
-        * @param locale
-        *            The locale of the resource to load
-        * @param extension
-        *            The extension of the resource
         * 
-        * @return The resource
+        * @return The resource or null
         */
-       public IResourceStream locate(Class clazz, String path, String style, 
Locale locale,
-                       String extension);
+       public IResourceStream locate(Class clazz, String path);
 
        /**
         * Loads a resource, given a path, style, locale and extension.
@@ -55,8 +53,16 @@
         *            The class loader for delegating the loading of the 
resource
         * @param path
         *            The path of the resource
+        * @param style
+        *            Any resource style, such as a skin style (see
+        *            [EMAIL PROTECTED] org.apache.wicket.Session})
+        * @param locale
+        *            The locale of the resource to load
+        * @param extension
+        *            The extension of the resource
         * 
-        * @return The resource
+        * @return The resource or null
         */
-       public IResourceStream locate(Class clazz, String path);
+       public IResourceStream locate(Class clazz, String path, String style, 
Locale locale,
+                       String extension);
 }


Reply via email to