You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@wicket.apache.org by eh...@apache.org on 2007/06/03 04:43:00 UTC

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

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 {@link #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
-	 *            {@link 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
+	 *            {@link 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);
 }