Polish Javadoc for @IfProfileValue
This commit is contained in:
@@ -27,21 +27,22 @@ import java.lang.annotation.Target;
|
|||||||
* <p>
|
* <p>
|
||||||
* Test annotation to indicate that a test is enabled for a specific testing
|
* Test annotation to indicate that a test is enabled for a specific testing
|
||||||
* profile or environment. If the configured {@link ProfileValueSource} returns
|
* profile or environment. If the configured {@link ProfileValueSource} returns
|
||||||
* a matching {@link #value() value} for the provided {@link #name() name}, the
|
* a matching {@link #value} for the provided {@link #name}, the test will be
|
||||||
* test will be enabled.
|
* enabled.
|
||||||
* </p>
|
* </p>
|
||||||
* <p>
|
* <p>
|
||||||
* Note: {@code @IfProfileValue} can be applied at the class level,
|
* Note: {@code @IfProfileValue} can be applied at the class level, the method
|
||||||
* the method level, or both. {@code @IfProfileValue} at the class
|
* level, or both. {@code @IfProfileValue} at the class level overrides
|
||||||
* level overrides method-level usage of {@code @IfProfileValue} for
|
* method-level usage of {@code @IfProfileValue} for any methods within that
|
||||||
* any methods within that class.
|
* class.
|
||||||
* </p>
|
|
||||||
* <p>
|
|
||||||
* Examples: when using {@link SystemProfileValueSource} as the
|
|
||||||
* {@link ProfileValueSource} implementation, you can configure a test method to
|
|
||||||
* run only on Java VMs from Sun Microsystems as follows:
|
|
||||||
* </p>
|
* </p>
|
||||||
*
|
*
|
||||||
|
* <h3>Examples</h3>
|
||||||
|
* <p>
|
||||||
|
* When using {@link SystemProfileValueSource} as the {@link ProfileValueSource}
|
||||||
|
* implementation, you can configure a test method to run only on Java VMs from
|
||||||
|
* Sun Microsystems as follows:
|
||||||
|
* </p>
|
||||||
* <pre class="code">
|
* <pre class="code">
|
||||||
* @IfProfileValue(name = "java.vendor", value = "Sun Microsystems Inc.")
|
* @IfProfileValue(name = "java.vendor", value = "Sun Microsystems Inc.")
|
||||||
* public void testSomething() {
|
* public void testSomething() {
|
||||||
@@ -49,10 +50,10 @@ import java.lang.annotation.Target;
|
|||||||
* }
|
* }
|
||||||
* </pre>
|
* </pre>
|
||||||
* <p>
|
* <p>
|
||||||
* You can alternatively configure {@code @IfProfileValue} with
|
* You can alternatively configure {@code @IfProfileValue} with <em>OR</em>
|
||||||
* <em>OR</em> semantics for multiple {@link #values() values} as follows
|
* semantics for multiple {@link #values() values} as follows (assuming a
|
||||||
* (assuming a {@link ProfileValueSource} has been appropriately configured for
|
* {@link ProfileValueSource} has been appropriately configured for the
|
||||||
* the "test-groups" name):
|
* "test-groups" name):
|
||||||
* </p>
|
* </p>
|
||||||
*
|
*
|
||||||
* <pre class="code">
|
* <pre class="code">
|
||||||
|
|||||||
Reference in New Issue
Block a user