Top Description Methods
javax.portlet.annotations

public @Interface HeaderMethod

extends Annotation
Annotations
@Retention:RUNTIME
@Target:METHOD
Static Imports
java.lang.annotation.ElementType.METHOD, .RetentionPolicy.RUNTIME

Designates a method corresponding to the renderHeaders method of the HeaderPortlet interface. The annotated method must have one of the following signatures: where the method name can be freely selected.

The method declaration may contain a throws clause. Exceptions declared in the throws clause should be of type javax.portlet.PortletException or java.io.IOException. Checked exceptions of any other type will be caught, wrapped with a PortletException, and rethrown.

The header method can be used to set properties such as cookies, header values, and XML elements for the HEAD section of the aggregated portal document.

Valid HEAD section markup written to the HeaderResponse output stream or writer will be added to the aggregated portal document HEAD section subject to portlet container-imposed restrictions.

Since
3.0
See Also
the add and set properties methods of PortletResponse, MimeResponse#MARKUP_HEAD_ELEMENT, javax.portlet.HeaderPortlet

Method Summary

Modifier and TypeMethod and Description
public String

Returns:

The content type
contentType
()

Sets the content type, or the MIME type, of content generated by the method.
public String

Returns:

The resource to be included
include
()

Specifies a resource, such as a JSP, an HTML file, or a servlet to be included.
public int

Returns:

The ordinal number
ordinal
()

The ordinal number for this annotated method.
public String

Returns:

The portlet mode
portletMode
()

The portlet mode rendered by the annotated method.
public String[]

Returns:

The portlet names
portletNames
()

The portlet names for which the header method applies.
Inherited from java.lang.annotation.Annotation:
annotationTypeequalshashCodetoString

Method Detail

contentTypeback to summary
public String contentType()

Sets the content type, or the MIME type, of content generated by the method. The content type will be set before the annotated method body is executed.

If this field is empty or set to the wildcard, no content type will be set. The portlet can then set the content type using the portlet API HeaderResponse#setContentType method.

Returns:String

The content type

See Also
HeaderResponse#setContentType
includeback to summary
public String include()

Specifies a resource, such as a JSP, an HTML file, or a servlet to be included.

The resource will be included using the PortletRequestDispatcher#include method after the method body has been executed.

If this field is empty, no resource will be included.

Returns:String

The resource to be included

See Also
javax.portlet.PortletRequestDispatcher, PortletRequestDispatcher#include
ordinalback to summary
public int ordinal()

The ordinal number for this annotated method.

The ordinal number determines the order of execution if multiple methods are annotated. Annotated methods with a lower ordinal number are executed before methods with a higher ordinal number.

Returns:int

The ordinal number

portletModeback to summary
public String portletMode()

The portlet mode rendered by the annotated method.

If an portlet mode is specified, the bean enabler will dispatch Header requests with matching portlet mode values to this method.

If this field is empty, the method will be executed for all Header requests not dispatched by portlet mode to other HeaderMethods.

Returns:String

The portlet mode

portletNamesback to summary
public String[] portletNames()

The portlet names for which the header method applies.

The annotated method can apply to multiple portlets within the portlet application. The names of the portlets to which the resources apply must be specified in this field.

A wildcard character '*' can be specified in the first portletName array element to indicate that the resource declarations are to apply to all portlets in the portlet application. If specified, the wildcard character must appear alone in the first array element.

Returns:String[]

The portlet names