org.springframework.test.context
Class ContextConfigurationAttributes

java.lang.Object
  extended by org.springframework.test.context.ContextConfigurationAttributes

public class ContextConfigurationAttributes
extends Object

ContextConfigurationAttributes encapsulates the context configuration attributes declared on a test class via @ContextConfiguration.

Since:
3.1
Author:
Sam Brannen
See Also:
ContextConfiguration, SmartContextLoader.processContextConfiguration(ContextConfigurationAttributes), MergedContextConfiguration

Constructor Summary
ContextConfigurationAttributes(Class<?> declaringClass, ContextConfiguration contextConfiguration)
          Construct a new ContextConfigurationAttributes instance for the supplied @ContextConfiguration annotation and the test class that declared it.
ContextConfigurationAttributes(Class<?> declaringClass, String[] locations, Class<?>[] classes, boolean inheritLocations, Class<? extends ContextLoader> contextLoaderClass)
          Construct a new ContextConfigurationAttributes instance for the test class that declared the @ContextConfiguration annotation and its corresponding attributes.
 
Method Summary
 Class<?>[] getClasses()
          Get the configuration classes that were declared via @ContextConfiguration.
 Class<? extends ContextLoader> getContextLoaderClass()
          Get the ContextLoader class that was declared via @ContextConfiguration.
 Class<?> getDeclaringClass()
          Get the class that declared the @ContextConfiguration annotation.
 String[] getLocations()
          Get the resource locations that were declared via @ContextConfiguration.
 boolean hasClasses()
          Determine if this ContextConfigurationAttributes instance has class-based resources.
 boolean hasLocations()
          Determine if this ContextConfigurationAttributes instance has path-based resource locations.
 boolean hasResources()
          Determine if this ContextConfigurationAttributes instance has either path-based resource locations or class-based resources.
 boolean isInheritLocations()
          Get the inheritLocations flag that was declared via @ContextConfiguration.
 void setClasses(Class<?>[] classes)
          Set the processed configuration classes, effectively overriding the original value declared via @ContextConfiguration.
 void setLocations(String[] locations)
          Set the processed resource locations, effectively overriding the original value declared via @ContextConfiguration.
 String toString()
          Provide a String representation of the context configuration attributes and declaring class.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

ContextConfigurationAttributes

public ContextConfigurationAttributes(Class<?> declaringClass,
                                      ContextConfiguration contextConfiguration)
Construct a new ContextConfigurationAttributes instance for the supplied @ContextConfiguration annotation and the test class that declared it.

Parameters:
declaringClass - the test class that declared @ContextConfiguration
contextConfiguration - the annotation from which to retrieve the attributes

ContextConfigurationAttributes

public ContextConfigurationAttributes(Class<?> declaringClass,
                                      String[] locations,
                                      Class<?>[] classes,
                                      boolean inheritLocations,
                                      Class<? extends ContextLoader> contextLoaderClass)
Construct a new ContextConfigurationAttributes instance for the test class that declared the @ContextConfiguration annotation and its corresponding attributes.

Parameters:
declaringClass - the test class that declared @ContextConfiguration
locations - the resource locations declared via @ContextConfiguration
classes - the configuration classes declared via @ContextConfiguration
inheritLocations - the inheritLocations flag declared via @ContextConfiguration
contextLoaderClass - the ContextLoader class declared via @ContextConfiguration
Throws:
IllegalArgumentException - if the declaringClass or contextLoaderClass is null, or if the locations and classes are both non-empty
Method Detail

getDeclaringClass

public Class<?> getDeclaringClass()
Get the class that declared the @ContextConfiguration annotation.

Returns:
the declaring class; never null

getLocations

public String[] getLocations()
Get the resource locations that were declared via @ContextConfiguration.

Note: this is a mutable property. The returned value may therefore represent a processed value that does not match the original value declared via @ContextConfiguration.

Returns:
the resource locations; potentially null or empty
See Also:
ContextConfiguration.value(), ContextConfiguration.locations(), #setLocations()

setLocations

public void setLocations(String[] locations)
Set the processed resource locations, effectively overriding the original value declared via @ContextConfiguration.

See Also:
getLocations()

getClasses

public Class<?>[] getClasses()
Get the configuration classes that were declared via @ContextConfiguration.

Note: this is a mutable property. The returned value may therefore represent a processed value that does not match the original value declared via @ContextConfiguration.

Returns:
the configuration classes; potentially null or empty
See Also:
ContextConfiguration.classes(), #setClasses()

setClasses

public void setClasses(Class<?>[] classes)
Set the processed configuration classes, effectively overriding the original value declared via @ContextConfiguration.

See Also:
getClasses()

hasLocations

public boolean hasLocations()
Determine if this ContextConfigurationAttributes instance has path-based resource locations.

Returns:
true if the locations array is not empty
See Also:
hasResources(), hasClasses()

hasClasses

public boolean hasClasses()
Determine if this ContextConfigurationAttributes instance has class-based resources.

Returns:
true if the classes array is not empty
See Also:
hasResources(), hasLocations()

hasResources

public boolean hasResources()
Determine if this ContextConfigurationAttributes instance has either path-based resource locations or class-based resources.

Returns:
true if either the locations or the classes array is not empty
See Also:
hasLocations(), hasClasses()

isInheritLocations

public boolean isInheritLocations()
Get the inheritLocations flag that was declared via @ContextConfiguration.

Returns:
the inheritLocations flag
See Also:
ContextConfiguration.inheritLocations()

getContextLoaderClass

public Class<? extends ContextLoader> getContextLoaderClass()
Get the ContextLoader class that was declared via @ContextConfiguration.

Returns:
the ContextLoader class
See Also:
ContextConfiguration.loader()

toString

public String toString()
Provide a String representation of the context configuration attributes and declaring class.

Overrides:
toString in class Object