@Retention(value=RUNTIME) @Target(value=TYPE) @Inherited @Repeatable(value=ResourceDependencies.class) public @interface ResourceDependency
Instances of UIComponent
or 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 UIComponent
or
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 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(java.lang.String)
.
Call setRendererType
on the UIOutput
instance, passing the renderer-type.
Obtain the Map
of attributes from the UIOutput
component by calling
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
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 | Required Element and Description |
---|---|
java.lang.String |
name
The resourceName of the resource pointed to by this |
Modifier and Type | Optional Element and Description |
---|---|
java.lang.String |
library
The libraryName in which the resource pointed to by this |
java.lang.String |
target
The value given for this attribute will be passed as the "target" argument to
|
public abstract java.lang.String name
The resourceName of the resource pointed to by this ResourceDependency
. It is valid to have
Jakarta Expression Language Expressions in the value of this attribute, as long as the expression resolves to an
instance of the expected type.
public abstract java.lang.String library
The libraryName in which the resource pointed to by this ResourceDependency
resides. If not
specified, defaults to the empty string. It is valid to have Jakarta Expression Language Expressions in the value of
this attribute, as long as the expression resolves to an instance of the expected type.
public abstract java.lang.String target
The value given for this attribute will be passed as the "target" argument to
UIViewRoot.addComponentResource(jakarta.faces.context.FacesContext, jakarta.faces.component.UIComponent, java.lang.String)
.
If this attribute is specified,
UIViewRoot.addComponentResource(jakarta.faces.context.FacesContext,jakarta.faces.component.UIComponent)
must be called instead, as described above. It is valid to have Jakarta Expression Language Expressions in the value
of this attribute, as long as the expression resolves to an instance of the expected type.