Package org.springframework.boot.web.servlet

Annotation Interface ServletComponentScan

@Target(TYPE) @Retention(RUNTIME) @Documented @Import(org.springframework.boot.web.servlet.ServletComponentScanRegistrar.class) public @interface ServletComponentScan
Enables scanning for Servlet components (filters, servlets, and listeners). Scanning is only performed when using an embedded web server.

Typically, one of value, basePackages, or basePackageClasses should be specified to control the packages to be scanned for components. In their absence, scanning will be performed from the package of the class with the annotation.

Since:
1.3.0
See Also:
  • WebServlet
  • WebFilter
  • WebListener

  • Element Details

    • value

      @AliasFor("basePackages") String[] value
      Alias for the basePackages() attribute. Allows for more concise annotation declarations e.g.: @ServletComponentScan("org.my.pkg") instead of @ServletComponentScan(basePackages="org.my.pkg").
      Returns:
      the base packages to scan
      Default:
      {}

    • basePackages

      @AliasFor("value") String[] basePackages
      Base packages to scan for annotated servlet components. value() is an alias for (and mutually exclusive with) this attribute.

      Use basePackageClasses() for a type-safe alternative to String-based package names.

      Returns:
      the base packages to scan
      Default:
      {}

    • basePackageClasses

      Class<?>[] basePackageClasses
      Type-safe alternative to basePackages() for specifying the packages to scan for annotated servlet components. The package of each class specified will be scanned.
      Returns:
      classes from the base packages to scan
      Default:
      {}