Class ServletWrappingController

java.lang.Object
org.springframework.context.support.ApplicationObjectSupport
org.springframework.web.context.support.WebApplicationObjectSupport
org.springframework.web.servlet.support.WebContentGenerator
org.springframework.web.servlet.mvc.AbstractController
org.springframework.web.servlet.mvc.ServletWrappingController
All Implemented Interfaces:
org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanNameAware, org.springframework.beans.factory.DisposableBean, org.springframework.beans.factory.InitializingBean, org.springframework.context.ApplicationContextAware, org.springframework.web.context.ServletContextAware, Controller
public class ServletWrappingController extends AbstractController implements org.springframework.beans.factory.BeanNameAware, org.springframework.beans.factory.InitializingBean, org.springframework.beans.factory.DisposableBean
Spring Controller implementation that wraps a servlet instance which it manages internally. Such a wrapped servlet is not known outside this controller; its entire lifecycle is covered here (in contrast to ServletForwardingController).

Useful to invoke an existing servlet via Spring's dispatching infrastructure, for example to apply Spring HandlerInterceptors to its requests.

Note that Struts has a special requirement in that it parses web.xml to find its servlet mapping. Therefore, you need to specify the DispatcherServlet's servlet name as "servletName" on this controller, so that Struts finds the DispatcherServlet's mapping (thinking that it refers to the ActionServlet).

Example: a DispatcherServlet XML context, forwarding "*.do" to the Struts ActionServlet wrapped by a ServletWrappingController. All such requests will go through the configured HandlerInterceptor chain (for example, an OpenSessionInViewInterceptor). From the Struts point of view, everything will work as usual. 

<bean id="urlMapping" class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
  <property name="interceptors">
    <list>
      <ref bean="openSessionInViewInterceptor"/>
    </list>
  </property>
  <property name="mappings">
    <props>
      <prop key="*.do">strutsWrappingController</prop>
    </props>
  </property>
</bean>

<bean id="strutsWrappingController" class="org.springframework.web.servlet.mvc.ServletWrappingController">
  <property name="servletClass">
    <value>org.apache.struts.action.ActionServlet</value>
  </property>
  <property name="servletName">
    <value>action</value>
  </property>
  <property name="initParameters">
    <props>
      <prop key="config">/WEB-INF/struts-config.xml</prop>
    </props>
  </property>
</bean>
Since:
1.1.1
Author:
Juergen Hoeller
See Also:

  • Constructor Details

    • ServletWrappingController

      public ServletWrappingController()

  • Method Details

    • setServletClass

      public void setServletClass(Class<? extends jakarta.servlet.Servlet> servletClass)
      Set the class of the servlet to wrap. Needs to implement jakarta.servlet.Servlet.
      See Also:
      • Servlet

    • setServletName

      public void setServletName(String servletName)
      Set the name of the servlet to wrap. Default is the bean name of this controller.

    • setInitParameters

      public void setInitParameters(Properties initParameters)
      Specify init parameters for the servlet to wrap, as name-value pairs.

    • setBeanName

      public void setBeanName(String name)
      Specified by:
      setBeanName in interface org.springframework.beans.factory.BeanNameAware

    • afterPropertiesSet

      public void afterPropertiesSet() throws Exception
      Initialize the wrapped Servlet instance.
      Specified by:
      afterPropertiesSet in interface org.springframework.beans.factory.InitializingBean
      Throws:
      Exception
      See Also:
      • Servlet.init(jakarta.servlet.ServletConfig)

    • handleRequestInternal

      protected @Nullable ModelAndView handleRequestInternal(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response) throws Exception
      Invoke the wrapped Servlet instance.
      Specified by:
      handleRequestInternal in class AbstractController
      Throws:
      Exception
      See Also:
      • Servlet.service(jakarta.servlet.ServletRequest, jakarta.servlet.ServletResponse)

    • destroy

      public void destroy()
      Destroy the wrapped Servlet instance.
      Specified by:
      destroy in interface org.springframework.beans.factory.DisposableBean
      See Also:
      • Servlet.destroy()