Instances of jakarta.faces.component.UIComponent or jakarta.faces.render.Renderer that have this
annotation (or ResourceDependencies attached at the class level will automatically have a resource dependency
added so that the named resource will be present in user agent's view of the UIViewRoot in which this
component or renderer is used.
The default implementation must support attaching this annotation to jakarta.faces.component.UIComponent or
jakarta.faces.render.Renderer classes. In both cases, the event that precipitates the processing of this
annotation is the insertion of a UIComponent instance into the view hierarchy on an initial request for
a view. When that event happens, the following action must be taken.
If this annotation is not present on the class in question, no action must be taken.
Create a jakarta.faces.component.UIOutput instance by passing jakarta.faces.Output. to
Application#createComponent(java.lang.String).
Get the annotation instance from the class and obtain the values of the name, library, and target attributes.
If library is the empty string, let library be null.
If target is the empty string, let target be null.
Obtain the renderer-type for the resource name by passing name to
ResourceHandler#getRendererTypeForResourceName.
Call setRendererType on the UIOutput instance, passing the renderer-type.
Obtain the Map of attributes from the UIOutput component by calling
jakarta.faces.component.UIComponent#getAttributes.
Store the name into the attributes Map under the key "name".
If library is non-null, store it under the key "library".
If target is non-null, store it under the key "target".
Otherwise, if target is null, call
jakarta.faces.component.UIViewRoot#addComponentResource(jakarta.faces.context.FacesContext, jakarta.faces.component.UIComponent),
passing the UIOutput instance as the second argument.
Example:
@ResourceDependency(library="corporate", name="colorAndMedia.css"),
| Modifier and Type | Method and Description |
|---|---|
| public String | Returns: the library.
The libraryName in which the resource pointed to by this |
| public String | |
| public String | Returns: the target.
The value given for this attribute will be passed as the "target" argument to
|
| library | back to summary |
|---|---|
| public String library()
The libraryName in which the resource pointed to by this
| |
| name | back to summary |
|---|---|
| public String name()
The resourceName of the resource pointed to by this
| |
| target | back to summary |
|---|---|
| public String target()
The value given for this attribute will be passed as the "target" argument to
| |