J2EE - (Web) Resources

> Procedural Languages > Java

1 - About

(Web) Resources are any software artifacts that the web application requires for proper rendering, including:

  • images,
  • script files,
  • and any user-created component libraries.

A Resource may be a javascript file, a css file or a graphic file.

Resources can be considered as a library location. Any artifact, such as a composite component or a template that is stored in the resources directory, becomes accessible to the other application components, which can use it to create a resource instance.

3 - Location

All ressources are located in the standard resource folder called “resources”.

Resources must be collected in a standard location, which can be one of the following.

  • A resource packaged in the web application root must be in a subdirectory of a resources directory at the web application root: resources/resource-identifier.
  • A resource packaged in the web application’s classpath must be in a subdirectory of the META-INF/resources directory within a web application: META-INF/resources/resource-identifier.

You can use this file structure to package resources in a JAR file bundled in the web application.

JSF implementation looks for a directory named resources, either under META-INF or at the root of the WAR file. Then it looks for a subdirectory called css under the resources directory and then for the specified CSS style sheet under that directory.

Advertising

4 - Identifier

Resource identifiers are unique strings that conform to the following format:

[locale-prefix/][library-name/][library-version/]resource-name[/resource-version]

Elements of the resource identifier in brackets ([]) are optional, indicating that only a resource-name, which is usually a file name, is a required element.

4.1 - Example

4.1.1 - Facelet

  • Library Notation
<h:outputStylesheet library="css" name="default.css"/>

This tag specifies that the default.css style sheet is in the directory web/resources/css.

  • Relative Notation
<h:graphicImage value="#{resource['images:myImage.gif']}"/>

This tag specifies that the image named myImage.gif is in the directory web/resources/images.

5 - Documentation / Reference

Advertising
lang/java/web_resource.txt · Last modified: 2017/02/12 21:05 by gerardnico