Auto-Configuration

/**
 * Auto-configuration for CAS themes support
 */
@EnableConfigurationProperties({CasConfigurationProperties.class, ThymeleafProperties.class, WebProperties.class})
@AutoConfigureOrder(Ordered.LOWEST_PRECEDENCE)
@ConditionalOnFeatureEnabled(feature = CasFeatureModule.FeatureCatalog.Thymeleaf)
@AutoConfiguration
public class CasThemesAutoConfiguration {
    
    /**
     * Creates theme source bean based on configuration
     * @param casProperties CAS configuration properties
     * @return ThemeSource implementation (DefaultCasThemeSource or AggregateCasThemeSource)
     */
    @Bean
    @ConditionalOnMissingBean(name = "casThemeSource")
    @RefreshScope(proxyMode = ScopedProxyMode.DEFAULT)
    public ThemeSource themeSource(CasConfigurationProperties casProperties);
    
    /**
     * Creates chaining theme resolver with multiple resolution strategies
     * @param casProperties CAS configuration properties provider
     * @param authenticationRequestServiceSelectionStrategies Service selection strategies
     * @param servicesManager Services manager for service-based theme resolution
     * @return Configured ChainingThemeResolver
     */
    @Bean  
    @ConditionalOnMissingBean(name = "casThemeResolver")
    @RefreshScope(proxyMode = ScopedProxyMode.DEFAULT)
    public ThemeResolver themeResolver(
        ObjectProvider<CasConfigurationProperties> casProperties,
        ObjectProvider<AuthenticationServiceSelectionPlan> authenticationRequestServiceSelectionStrategies,
        ObjectProvider<ServicesManager> servicesManager);
    
    /**
     * Configures static resource handling for themes
     * @param casProperties CAS configuration properties
     * @param webProperties Spring web properties
     * @param thymeleafProperties Thymeleaf template engine properties
     * @return WebMvcConfigurer for theme resources
     */
    @Bean
    @ConditionalOnMissingBean(name = "themesStaticResourcesWebMvcConfigurer")  
    public WebMvcConfigurer themesStaticResourcesWebMvcConfigurer(
        CasConfigurationProperties casProperties,
        WebProperties webProperties,
        ThymeleafProperties thymeleafProperties);
}

// Auto-configuration is automatically activated when CAS themes support is on the classpath
// No explicit configuration needed - beans are created automatically

// Optional: Access auto-configured beans in your application
@Autowired
@Qualifier("casThemeSource") 
private ThemeSource themeSource;

@Autowired
@Qualifier("casThemeResolver")
private ThemeResolver themeResolver;

// Use theme resolution in controller or service
String resolvedTheme = themeResolver.resolveThemeName(request);
Theme theme = themeSource.getTheme(resolvedTheme);

# application.yml
cas:
  theme:
    default-theme-name: "cas-theme-default"  # Default theme name
    param-name: "theme"                      # HTTP parameter name for theme switching
  view:
    theme-source-type: AGGREGATE             # DEFAULT or AGGREGATE
    template-prefixes:
      - "file:/etc/cas/themes/"             # External theme directory
      - "classpath:/themes/"               # Classpath theme resources
  tgc:
    domain: ".example.com"                  # Cookie domain for theme persistence
    secure: true                           # HTTPS-only cookies
    http-only: true                        # Prevent XSS access to cookies
    path: "/cas"                           # Cookie path
    max-age: "P30D"                        # 30 day cookie expiration

# application.properties
cas.theme.default-theme-name=cas-theme-default
cas.theme.param-name=theme
cas.view.theme-source-type=AGGREGATE
cas.view.template-prefixes[0]=file:/etc/cas/themes/
cas.view.template-prefixes[1]=classpath:/themes/

// Configuration determines which theme source implementation to use
public enum ThemeSourceTypes {
    DEFAULT,    // Creates DefaultCasThemeSource
    AGGREGATE   // Creates AggregateCasThemeSource  
}

// Example resource locations served:
// /themes/default/css/cas.css
// /themes/custom/images/logo.png
// /themes/bootstrap/js/theme.js

class CasConfigurationProperties {
    ThemeProperties getTheme();
    ViewProperties getView();
    TgcProperties getTgc();  // For cookie configuration
}

class ThemeProperties {
    String getDefaultThemeName();    // Default: "cas"
    String getParamName();          // Default: "theme"
}

class ViewProperties {
    List<String> getTemplatePrefixes();
    ThemeSourceTypes getThemeSourceType();
    
    enum ThemeSourceTypes {
        DEFAULT, AGGREGATE
    }
}