Class RegistrationBean

java.lang.Object
org.springframework.boot.web.servlet.RegistrationBean
All Implemented Interfaces:
ServletContextInitializer, org.springframework.core.Ordered
Direct Known Subclasses:
DynamicRegistrationBean, ServletListenerRegistrationBean

public abstract class RegistrationBean extends Object implements ServletContextInitializer, org.springframework.core.Ordered
Base class for Servlet 3.0+ based registration beans.
Since:
1.4.0
See Also:
  • Field Summary

    Fields inherited from interface org.springframework.core.Ordered

    HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE
  • Constructor Summary

    Constructors
    Constructor
    Description
     
  • Method Summary

    Modifier and Type
    Method
    Description
    protected abstract String
    Return a description of the registration.
    int
    Get the order of the registration bean.
    boolean
    Return if the registration is enabled.
    final void
    onStartup(jakarta.servlet.ServletContext servletContext)
    Configure the given ServletContext with any servlets, filters, listeners context-params and attributes necessary for initialization.
    protected abstract void
    register(String description, jakarta.servlet.ServletContext servletContext)
    Register this bean with the servlet context.
    void
    setEnabled(boolean enabled)
    Flag to indicate that the registration is enabled.
    void
    setOrder(int order)
    Set the order of the registration bean.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Constructor Details

    • RegistrationBean

      public RegistrationBean()
  • Method Details

    • onStartup

      public final void onStartup(jakarta.servlet.ServletContext servletContext) throws jakarta.servlet.ServletException
      Description copied from interface: ServletContextInitializer
      Configure the given ServletContext with any servlets, filters, listeners context-params and attributes necessary for initialization.
      Specified by:
      onStartup in interface ServletContextInitializer
      Parameters:
      servletContext - the ServletContext to initialize
      Throws:
      jakarta.servlet.ServletException - if any call against the given ServletContext throws a ServletException
    • getDescription

      protected abstract String getDescription()
      Return a description of the registration. For example "Servlet resourceServlet"
      Returns:
      a description of the registration
    • register

      protected abstract void register(String description, jakarta.servlet.ServletContext servletContext)
      Register this bean with the servlet context.
      Parameters:
      description - a description of the item being registered
      servletContext - the servlet context
    • setEnabled

      public void setEnabled(boolean enabled)
      Flag to indicate that the registration is enabled.
      Parameters:
      enabled - the enabled to set
    • isEnabled

      public boolean isEnabled()
      Return if the registration is enabled.
      Returns:
      if enabled (default true)
    • setOrder

      public void setOrder(int order)
      Set the order of the registration bean.
      Parameters:
      order - the order
    • getOrder

      public int getOrder()
      Get the order of the registration bean.
      Specified by:
      getOrder in interface org.springframework.core.Ordered
      Returns:
      the order