Module com.aoapps.servlet.util

Package com.aoapps.servlet.jsp.tagext

Class JspTagUtils

java.lang.Object

com.aoapps.servlet.jsp.tagext.JspTagUtils

public final class JspTagUtils
extends Object

Static utilities for JSP taglibs.

Author:

AO Industries, Inc.

Method Summary

Modifier and Type	Method	Description
static <T> Optional<T>	findAncestor(JspTag from, Class<? extends T> ancestorClass)	Finds the first parent tag of the provided class (or subclass) or implementing the provided interface.
static <T, Ex extends Throwable> T	requireAncestor(LocalizedSupplier<Ex> exceptionSupplier, JspTag from, Class<? extends T> ancestorClass)	Deprecated. Please provide tag names to requireAncestor(java.lang.String, jakarta.servlet.jsp.tagext.JspTag, java.lang.String, java.lang.Class).
static <T, Ex extends Throwable> T	requireAncestor(LocalizedSupplier<Ex> exceptionSupplier, String fromName, JspTag from, String ancestorName, Class<? extends T> ancestorClass)	Finds the first parent tag of the provided class (or subclass) or implementing the provided interface.
static <T> T	requireAncestor(JspTag from, Class<? extends T> ancestorClass)	Deprecated. Please provide tag names to requireAncestor(java.lang.String, jakarta.servlet.jsp.tagext.JspTag, java.lang.String, java.lang.Class).
static <T> T	requireAncestor(String fromName, JspTag from, String ancestorName, Class<? extends T> ancestorClass)	Finds the first parent tag of the provided class (or subclass) or implementing the provided interface.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

findAncestor

public static <T> Optional<T> findAncestor(JspTag from,
 Class<? extends T> ancestorClass)

Finds the first parent tag of the provided class (or subclass) or implementing the provided interface.

Returns:

the parent tag when found

See Also:

• SimpleTagSupport.findAncestorWithClass(jakarta.servlet.jsp.tagext.JspTag, java.lang.Class)

requireAncestor

public static <T,
Ex extends Throwable> T requireAncestor(LocalizedSupplier<Ex> exceptionSupplier,
 String fromName,
 JspTag from,
 String ancestorName,
 Class<? extends T> ancestorClass)
                                                   throws Ex

Finds the first parent tag of the provided class (or subclass) or implementing the provided interface.

Parameters:

fromName - The name of the tag searching from, used in generating the exception message, will typically be in the form "<prefix:name>" or "<name>".

ancestorName - The name of the tag searching for, used in generating the exception message, will typically be in the form "<prefix:name>" or "<name>".

Returns:

the parent tag, never null

Throws:

Ex - if parent not found

See Also:

• SimpleTagSupport.findAncestorWithClass(jakarta.servlet.jsp.tagext.JspTag, java.lang.Class)

requireAncestor

public static <T> T requireAncestor(String fromName,
 JspTag from,
 String ancestorName,
 Class<? extends T> ancestorClass)
                             throws JspTagException

Finds the first parent tag of the provided class (or subclass) or implementing the provided interface.

Parameters:

fromName - The name of the tag searching from, used in generating the exception message, will typically be in the form "<prefix:name>" or "<name>".

ancestorName - The name of the tag searching for, used in generating the exception message, will typically be in the form "<prefix:name>" or "<name>".

Returns:

the parent tag, never null

Throws:

JspTagException - if parent not found

See Also:

• SimpleTagSupport.findAncestorWithClass(jakarta.servlet.jsp.tagext.JspTag, java.lang.Class)

requireAncestor

@Deprecated
public static <T,
Ex extends Throwable> T requireAncestor(LocalizedSupplier<Ex> exceptionSupplier,
 JspTag from,
 Class<? extends T> ancestorClass)
                                                   throws Ex

Deprecated.

Please provide tag names to requireAncestor(java.lang.String, jakarta.servlet.jsp.tagext.JspTag, java.lang.String, java.lang.Class).

Finds the first parent tag of the provided class (or subclass) or implementing the provided interface.

Returns:

the parent tag, never null

Throws:

Ex - if parent not found

See Also:

• SimpleTagSupport.findAncestorWithClass(jakarta.servlet.jsp.tagext.JspTag, java.lang.Class)

requireAncestor

@Deprecated
public static <T> T requireAncestor(JspTag from,
 Class<? extends T> ancestorClass)
                             throws JspTagException

Deprecated.

Please provide tag names to requireAncestor(java.lang.String, jakarta.servlet.jsp.tagext.JspTag, java.lang.String, java.lang.Class).

Finds the first parent tag of the provided class (or subclass) or implementing the provided interface.

Returns:

the parent tag, never null

Throws:

JspTagException - if parent not found

See Also:

• SimpleTagSupport.findAncestorWithClass(jakarta.servlet.jsp.tagext.JspTag, java.lang.Class)