Class WeldConfiguration

java.lang.Object
org.jboss.weld.config.WeldConfiguration
All Implemented Interfaces:
org.jboss.weld.bootstrap.api.Service

public class WeldConfiguration extends Object implements org.jboss.weld.bootstrap.api.Service
Represents an immutable per-deployment Weld configuration.

Each property may be set in three different sources (by priority in descending order):

  1. In a properties file named `weld.properties`
  2. As a system property
  3. By a bootstrap configuration provided by an integrator

For backwards compatibility there are some obsolete sources:

  • properties files org.jboss.weld.executor.properties and org.jboss.weld.bootstrap.properties are also loaded for some configuration keys,
  • some system properties with obsolete keys are considered

If a configuration key is set in multiple sources (e.g. as a system property and in a weld.properties file), the value from the source with higher priority is taken, other values are ignored.

If a configuration key is set multiple times in the same source (e.g. different weld.properties files) and the values are different, the container automatically detects the problem and treats it as a deployment problem.

Unsupported configuration keys are ignored. If an invalid value is set, the container automatically detects the problem and treats it as a deployment problem.

Author:
Martin Kouba
See Also:
  • Field Details

  • Constructor Details

    • WeldConfiguration

      public WeldConfiguration(org.jboss.weld.bootstrap.api.ServiceRegistry services, org.jboss.weld.bootstrap.spi.Deployment deployment)
      Parameters:
      services -
      deployment -
  • Method Details

    • getStringProperty

      public String getStringProperty(ConfigurationKey key)
      Parameters:
      key -
      Returns:
      the property for the given key
      Throws:
      IllegalStateException - If the property type does not match the required type
    • getBooleanProperty

      public Boolean getBooleanProperty(ConfigurationKey key)
      Parameters:
      key -
      Returns:
      the property for the given key
      Throws:
      IllegalStateException - If the property type does not match the required type
    • getLongProperty

      public Long getLongProperty(ConfigurationKey key)
      Parameters:
      key -
      Returns:
      the property for the given key
      Throws:
      IllegalStateException - If the property type does not match the required type
    • getIntegerProperty

      public Integer getIntegerProperty(ConfigurationKey key)
      Parameters:
      key -
      Returns:
      the property for the given key
      Throws:
      IllegalStateException - If the property type does not match the required type
    • getProxyDumpFilePath

      public File getProxyDumpFilePath()
      Returns:
      the path or null if the generated bytecode should not be dumped
      See Also:
    • isFinalMethodIgnored

      public boolean isFinalMethodIgnored(String className)
      Parameters:
      className -
      Returns:
      true if the final methods declared on the given type should be ignored, false otherwise
      See Also:
    • cleanup

      public void cleanup()
      Specified by:
      cleanup in interface org.jboss.weld.bootstrap.api.Service