Examples of org.apache.wicket.resource.loader.ComponentStringResourceLoader

Package org.apache.wicket.resource.loader

Examples of org.apache.wicket.resource.loader.ComponentStringResourceLoader

org.apache.wicket.resource.loader.ComponentStringResourceLoader
This is one of Wicket's default string resource loaders.
The component based string resource loader attempts to find the resource from a bundle that corresponds to the supplied component object or one of its parent containers.
The search order for resources is built around the containers that hold the component (if it is not a page). Consider a Page that contains a Panel that contains a Label. If we pass the Label as the component then resource loading will first look for the resource against the page, then against the panel and finally against the label.
The above search order may seem slightly odd at first, but can be explained thus: Team A writes a new component X and packages it as a reusable Wicket component along with all required resources. Team B then creates a new container component Y that holds a instance of an X. However, Team B wishes the text to be different to that which was provided with X so rather than needing to change X, they include override values in the resources for Y. Finally, Team C makes use of component Y in a page they are writing. Initially they are happy with the text for Y so they do not include any override values in the resources for the page. However, after demonstrating to the customer, the customer requests the text for Y to be different. Team C need only provide override values against their page and thus do not need to change Y.
This implementation is fully aware of both locale and style values when trying to obtain the appropriate resources.
In addition to the above search order, each key will be pre-pended with the relative path of the current component related to the component that is being searched. E.g. assume a component hierarchy like page1.form1.input1 and your are requesting a key named 'Required'. Wicket will search the property in the following order:
```
 page1.properties => form1.input1.Required page1.properties => Required form1.properties => input1.Required form1.properties => Required input1.properties => Required myApplication.properties => page1.form1.input1.Required myApplication.properties => Required 
```
Note that the latter two property files are only checked if the ClassStringResourceLoader has been registered with Application as well, which is the default.
In addition to the above search order, each component that is being searched for a resource also includes the resources from any parent classes that it inherits from. For example, PageA extends CommonBasePage which in turn extends WebPage When a resource lookup is requested on PageA, the resource bundle for PageA is first checked. If the resource is not found in this bundle then the resource bundle for CommonBasePage is checked. This allows designers of base pages and components to define default sets of string resources and then developers implementing subclasses to either override or extend these in their own resource bundle.
This implementation can be subclassed to implement modified behavior. The new implementation must be registered with the Application (ResourceSettings) though.
You may enable log debug messages for this class to fully understand the search order. @author Chris Turner @author Juergen Donnerstag

   * 
   * @return The loader instance to test
   */
  protected IStringResourceLoader createLoader()
  {
    return new ComponentStringResourceLoader();
  }

View Full Code Here

    {
      private static final long serialVersionUID = 1L;
    };
    DummyPage page = new DummyPage();
    page.add(c);
    IStringResourceLoader loader = new ComponentStringResourceLoader();
    Assert.assertNull("Missing resource should return null", loader.loadStringResource(c
        .getClass(), "test.string.bad", Locale.getDefault(), null));
  }

View Full Code Here

    DummyPage p = new DummyPage();
    Panel panel = new Panel("panel");
    p.add(panel);
    DummyComponent c = new DummyComponent("hello", application);
    panel.add(c);
    IStringResourceLoader loader = new ComponentStringResourceLoader();
    Assert.assertEquals("Valid resourse string should be found", "Component string", loader
        .loadStringResource(c.getClass(), "component.string", Locale.getDefault(), null));
  }

View Full Code Here

   * 
   */
  public void testLoadDirectFromPage()
  {
    DummyPage p = new DummyPage();
    IStringResourceLoader loader = new ComponentStringResourceLoader();
    Assert
        .assertEquals("Valid resourse string should be found", "Another string", loader
            .loadStringResource(p.getClass(), "another.test.string", Locale
                .getDefault(), null));
  }

View Full Code Here

   * 
   */
  public void testSearchClassHierarchyFromPage()
  {
    DummySubClassPage p = new DummySubClassPage();
    IStringResourceLoader loader = new ComponentStringResourceLoader();
    Assert.assertEquals("Valid resource string should be found", "SubClass Test String",
        loader.loadStringResource(p.getClass(), "subclass.test.string",
            Locale.getDefault(), null));
    Assert
        .assertEquals("Valid resource string should be found", "Another string", loader
            .loadStringResource(p.getClass(), "another.test.string", Locale
                .getDefault(), null));
  }

View Full Code Here

  {
    Settings settings = new Settings(new MockApplication());
    settings.getStringResourceLoaders().clear();
    settings.addStringResourceLoader(new BundleStringResourceLoader(
      "org.apache.wicket.resource.DummyResources"));
    settings.addStringResourceLoader(new ComponentStringResourceLoader());
    List<IStringResourceLoader> loaders = settings.getStringResourceLoaders();
    Assert.assertEquals("There should be 2 overridden loaders", 2, loaders.size());
    Assert.assertTrue("First loader one should be the bundle one",
      loaders.get(0) instanceof BundleStringResourceLoader);
    Assert.assertTrue("Second loader should be the component one",

View Full Code Here

   * @param application
   *            The application that these settings are for
   */
  public Settings(final Object application)
  {
    stringResourceLoaders.add(new ComponentStringResourceLoader());
    stringResourceLoaders.add(new PackageStringResourceLoader());
    stringResourceLoaders.add(new ClassStringResourceLoader(application.getClass()));
    stringResourceLoaders.add(new ValidatorStringResourceLoader());
  }

View Full Code Here

   * @return The loader instance to test
   */
  @Override
  protected IStringResourceLoader createLoader()
  {
    return new ComponentStringResourceLoader();
  }

View Full Code Here

    {
      private static final long serialVersionUID = 1L;
    };
    DummyPage page = new DummyPage();
    page.add(c);
    IStringResourceLoader loader = new ComponentStringResourceLoader();
    Assert.assertNull("Missing resource should return null", loader.loadStringResource(
      c.getClass(), "test.string.bad", Locale.getDefault(), null, null));
  }

View Full Code Here

    DummyPage p = new DummyPage();
    Panel panel = new EmptyPanel("panel");
    p.add(panel);
    DummyComponent c = new DummyComponent("hello", tester.getApplication());
    panel.add(c);
    IStringResourceLoader loader = new ComponentStringResourceLoader();
    Assert.assertEquals("Valid resourse string should be found", "Component string",
      loader.loadStringResource(c.getClass(), "component.string", Locale.getDefault(), null,
        null));
  }

View Full Code Here

0 1 2 3 4 5 6 7 8 9

TOP

Related Classes of org.apache.wicket.resource.loader.ComponentStringResourceLoader

org.apache.wicket.ApplicationSettingsTest

org.apache.wicket.Component

org.apache.wicket.core.util.resource.locator.IResourceNameIterator

org.apache.wicket.core.util.resource.locator.ResourceNameIterator

org.apache.wicket.LocalizerTest

org.apache.wicket.MarkupContainer

org.apache.wicket.resource.ComponentStringResourceLoaderTest

org.apache.wicket.resource.IPropertiesFactory

org.apache.wicket.resource.Properties

org.apache.wicket.settings.def.ResourceSettings

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.