incubator-isis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From danhayw...@apache.org
Subject svn commit: r1234388 [2/4] - in /incubator/isis/trunk/framework/applib/src: main/java/org/apache/isis/applib/ main/java/org/apache/isis/applib/adapters/ main/java/org/apache/isis/applib/annotation/ main/java/org/apache/isis/applib/clock/ main/java/org/...
Date Sat, 21 Jan 2012 18:30:35 GMT
Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/Mask.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/Mask.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/Mask.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/Mask.java Sat Jan 21 18:30:32 2012
@@ -31,8 +31,9 @@ import java.lang.annotation.Target;
  * A mask to apply to string attributes.
  * 
  * <p>
- * The characters that can be used are shown in the following table (adapted from masks used by Swing's MaskFormatter,
- * Java's SimpleDateFormat and also Microsoft's MaskedEdit control):
+ * The characters that can be used are shown in the following table (adapted
+ * from masks used by Swing's MaskFormatter, Java's SimpleDateFormat and also
+ * Microsoft's MaskedEdit control):
  * 
  * <table border='2'>
  * <tr>
@@ -47,37 +48,42 @@ import java.lang.annotation.Target;
  * </tr>
  * <tr>
  * <td align='center'>.</td>
- * <td align='left'>Decimal placeholder. The actual character used is the one specified as the decimal placeholder in
- * your international settings. This character is treated as a literal for masking purposes.</td>
+ * <td align='left'>Decimal placeholder. The actual character used is the one
+ * specified as the decimal placeholder in your international settings. This
+ * character is treated as a literal for masking purposes.</td>
  * <td align='left'>MS</td>
  * </tr>
  * <tr>
  * <td align='center'>,</td>
- * <td align='left'>Thousands separator. The actual character used is the one specified as the thousands separator in
- * your international settings. This character is treated as a literal for masking purposes.</td>
+ * <td align='left'>Thousands separator. The actual character used is the one
+ * specified as the thousands separator in your international settings. This
+ * character is treated as a literal for masking purposes.</td>
  * <td align='left'>MS</td>
  * </tr>
  * <tr>
  * <td align='center'>:</td>
- * <td align='left'>Time separator. This character is treated as a literal for masking purposes.</td>
+ * <td align='left'>Time separator. This character is treated as a literal for
+ * masking purposes.</td>
  * <td align='left'>MS</td>
  * </tr>
  * <tr>
  * <td align='center'>/</td>
- * <td align='left'>Date separator. This character is treated as a literal for masking purposes.</td>
+ * <td align='left'>Date separator. This character is treated as a literal for
+ * masking purposes.</td>
  * <td align='left'>MS</td>
  * </tr>
  * <tr>
  * <td align='center'>&amp;</td>
- * <td align='left'>Character placeholder. Valid values for this placeholder are ANSI characters in the following
- * ranges: 32-126 and 128-255.</td>
+ * <td align='left'>Character placeholder. Valid values for this placeholder are
+ * ANSI characters in the following ranges: 32-126 and 128-255.</td>
  * <td align='left'>MS</td>
  * </tr>
  * 
  * <tr>
  * <td align='center'>A</td>
- * <td align='left'>Alphanumeric character placeholder (<code>Character.isLetter</code> or
- * <code>Character.isDigit</code>), with entry required. For example: a ~ z, A ~ Z, or 0 ~ 9.</td>
+ * <td align='left'>Alphanumeric character placeholder (
+ * <code>Character.isLetter</code> or <code>Character.isDigit</code>), with
+ * entry required. For example: a ~ z, A ~ Z, or 0 ~ 9.</td>
  * <td align='left'>MS</td>
  * </tr>
  * 
@@ -93,29 +99,33 @@ import java.lang.annotation.Target;
  * </tr>
  * <tr>
  * <td align='center'>?</td>
- * <td align='left'>Letter placeholder (<code>Character.isLetter</code>). For example: a ~ z or A ~ Z.</td>
+ * <td align='left'>Letter placeholder (<code>Character.isLetter</code>). For
+ * example: a ~ z or A ~ Z.</td>
  * <td align='left'>MS, Swing</td>
  * </tr>
  * <tr>
  * <td align='center'>U</td>
- * <td align='left'>Any character (<code>Character.isLetter</code>). All lowercase letters are mapped to upper case.</td>
+ * <td align='left'>Any character (<code>Character.isLetter</code>). All
+ * lowercase letters are mapped to upper case.</td>
  * <td align='left'>Swing</td>
  * </tr>
  * <tr>
  * <td align='center'>L</td>
- * <td align='left'>Any character (<code>Character.isLetter</code>). All lowercase letters are mapped to lower case.</td>
+ * <td align='left'>Any character (<code>Character.isLetter</code>). All
+ * lowercase letters are mapped to lower case.</td>
  * <td align='left'>Swing</td>
  * </tr>
  * <tr>
  * <td align='center'>Literal</td>
- * <td align='left'>All other symbols are displayed as literals; that is, as themselves.</td>
+ * <td align='left'>All other symbols are displayed as literals; that is, as
+ * themselves.</td>
  * <td align='left'>MS</td>
  * </tr>
  * </table>
  * 
  * <p>
- * Can also be specified for types that are annotated as <tt>@Value</tt> types. To apply, the value must have string
- * semantics.
+ * Can also be specified for types that are annotated as <tt>@Value</tt> types.
+ * To apply, the value must have string semantics.
  * 
  * <p>
  * Not yet implemented:
@@ -127,8 +137,9 @@ import java.lang.annotation.Target;
  * </tr>
  * <tr>
  * <td align='center'>\ or '</td>
- * <td align='left'>Treat the next character in the mask string as a literal. This allows you to include the '#', '&',
- * 'A', and '?' characters in the mask. This character is treated as a literal for masking purposes.</td>
+ * <td align='left'>Treat the next character in the mask string as a literal.
+ * This allows you to include the '#', '&', 'A', and '?' characters in the mask.
+ * This character is treated as a literal for masking purposes.</td>
  * <td align='left'>MS (\), Swing (')</td>
  * </tr>
  * <tr>
@@ -148,7 +159,8 @@ import java.lang.annotation.Target;
  * </tr>
  * <tr>
  * <td align='center'>MMM</td>
- * <td align='left'>Three character representation of month, eg <i>Jul</i> for July.</td>
+ * <td align='left'>Three character representation of month, eg <i>Jul</i> for
+ * July.</td>
  * <td align='left'>DateFormat</td>
  * </tr>
  * <tr>
@@ -163,7 +175,8 @@ import java.lang.annotation.Target;
  * </tr>
  * <tr>
  * <td align='center'>HH</td>
- * <td align='left'>Two digit representation of hour in day (24 hour clock), eg 05 or 19.</td>
+ * <td align='left'>Two digit representation of hour in day (24 hour clock), eg
+ * 05 or 19.</td>
  * <td align='left'>DateFormat</td>
  * </tr>
  * <tr>

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/MaxLength.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/MaxLength.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/MaxLength.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/MaxLength.java Sat Jan 21 18:30:32 2012
@@ -29,8 +29,8 @@ import java.lang.annotation.Target;
  * The maximum entry length of a field.
  * 
  * <p>
- * Can also be specified for types that are annotated as <tt>@Value</tt> types. To apply, the value must have string
- * semantics.
+ * Can also be specified for types that are annotated as <tt>@Value</tt> types.
+ * To apply, the value must have string semantics.
  */
 @Inherited
 @Target({ ElementType.TYPE, ElementType.METHOD, ElementType.PARAMETER })

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/MultiLine.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/MultiLine.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/MultiLine.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/MultiLine.java Sat Jan 21 18:30:32 2012
@@ -26,19 +26,21 @@ import java.lang.annotation.RetentionPol
 import java.lang.annotation.Target;
 
 /**
- * Indicates that a string property may have more than one line (ie may contain carriage returns).
+ * Indicates that a string property may have more than one line (ie may contain
+ * carriage returns).
  * 
  * <p>
- * In addition you can specify the typical number of lines (defaults to 6) and whether the lines should not be wrapped
- * (by default they will not be wrapped).
+ * In addition you can specify the typical number of lines (defaults to 6) and
+ * whether the lines should not be wrapped (by default they will not be
+ * wrapped).
  * 
  * <p>
- * Can also be specified for types that are annotated as <tt>@Value</tt> types. To apply, the value must have string
- * semantics.
+ * Can also be specified for types that are annotated as <tt>@Value</tt> types.
+ * To apply, the value must have string semantics.
  * 
  * <p>
- * Note that if this annotation is applied, then any choices for the property (ie as per a <tt>choicesXxx</tt> method)
- * will be ignored.
+ * Note that if this annotation is applied, then any choices for the property
+ * (ie as per a <tt>choicesXxx</tt> method) will be ignored.
  */
 @Inherited
 @Target({ ElementType.TYPE, ElementType.METHOD, ElementType.PARAMETER })

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/MustSatisfy.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/MustSatisfy.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/MustSatisfy.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/MustSatisfy.java Sat Jan 21 18:30:32 2012
@@ -38,7 +38,8 @@ public @interface MustSatisfy {
      * The {@link Specification}(s) to be satisfied.
      * 
      * <p>
-     * If more than one is provided, then all must be satisfied (in effect &quot;AND&quot;ed together).
+     * If more than one is provided, then all must be satisfied (in effect
+     * &quot;AND&quot;ed together).
      */
     Class<? extends Specification>[] value();
 }

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/NotContributed.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/NotContributed.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/NotContributed.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/NotContributed.java Sat Jan 21 18:30:32 2012
@@ -29,8 +29,9 @@ import java.lang.annotation.Target;
  * Indicates the a (repository) action should be not be contributed.
  * 
  * <p>
- * It may still be appear in the repository menu (unless it has been annotated as {@link NotInServiceMenu}). If
- * {@link Hidden}, then also implies that the menu should not be contributed.
+ * It may still be appear in the repository menu (unless it has been annotated
+ * as {@link NotInServiceMenu}). If {@link Hidden}, then also implies that the
+ * menu should not be contributed.
  * 
  * <p>
  * Has no meanings for actions on regular entities.

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/NotInServiceMenu.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/NotInServiceMenu.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/NotInServiceMenu.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/NotInServiceMenu.java Sat Jan 21 18:30:32 2012
@@ -26,11 +26,13 @@ import java.lang.annotation.RetentionPol
 import java.lang.annotation.Target;
 
 /**
- * Indicates the a (service) action should be not be displayed in the service menu.
+ * Indicates the a (service) action should be not be displayed in the service
+ * menu.
  * 
  * <p>
- * It may still be contributed (unless it has been annotated as {@link NotContributed}). If {@link Hidden}, then also
- * implies that the menu should not appear in the service menu.
+ * It may still be contributed (unless it has been annotated as
+ * {@link NotContributed}). If {@link Hidden}, then also implies that the menu
+ * should not appear in the service menu.
  * 
  * <p>
  * Has no meanings for actions on regular entities.

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/NotPersistable.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/NotPersistable.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/NotPersistable.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/NotPersistable.java Sat Jan 21 18:30:32 2012
@@ -26,7 +26,8 @@ import java.lang.annotation.RetentionPol
 import java.lang.annotation.Target;
 
 /**
- * Indicates that an instance cannot be persisted by a user, but only programmatically.
+ * Indicates that an instance cannot be persisted by a user, but only
+ * programmatically.
  */
 @Inherited
 @Target({ ElementType.TYPE })

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/Parseable.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/Parseable.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/Parseable.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/Parseable.java Sat Jan 21 18:30:32 2012
@@ -28,8 +28,8 @@ import java.lang.annotation.Target;
 import org.apache.isis.applib.adapters.Parser;
 
 /**
- * Indicates that the class can be parsed either by delegating to an {@link Parser} or through some
- * externally-configured mechanism.
+ * Indicates that the class can be parsed either by delegating to an
+ * {@link Parser} or through some externally-configured mechanism.
  */
 @Inherited
 @Target({ ElementType.TYPE })
@@ -37,30 +37,35 @@ import org.apache.isis.applib.adapters.P
 public @interface Parseable {
 
     /**
-     * The fully qualified name of a class that implements the {@link Parser} interface.
+     * The fully qualified name of a class that implements the {@link Parser}
+     * interface.
      * 
      * <p>
-     * This is optional because some implementations may pick up parseability via a configuration file either for the
-     * framework itself, or through a viewer-specific configuration of a widget (eg a calendar view for a date), or
-     * indeed through the equivalent {@link #parserClass()}.
+     * This is optional because some implementations may pick up parseability
+     * via a configuration file either for the framework itself, or through a
+     * viewer-specific configuration of a widget (eg a calendar view for a
+     * date), or indeed through the equivalent {@link #parserClass()}.
      * 
      * <p>
-     * It is common for value classes to act as their own parsers. Note that the framework requires that the nominated
-     * class provides a <tt>public</tt> no-arg constructor on the class. It instantiates an instance in order to do the
-     * parsing, uses the result and discards the instantiated object.
+     * It is common for value classes to act as their own parsers. Note that the
+     * framework requires that the nominated class provides a <tt>public</tt>
+     * no-arg constructor on the class. It instantiates an instance in order to
+     * do the parsing, uses the result and discards the instantiated object.
      * 
      * <p>
-     * Implementation note: the default value provided here is simply the empty string because <tt>null</tt> is not a
-     * valid default.
+     * Implementation note: the default value provided here is simply the empty
+     * string because <tt>null</tt> is not a valid default.
      */
     String parserName() default "";
 
     /**
-     * As per {@link #parserName()}, but specifying a class literal rather than a fully qualified class name.
+     * As per {@link #parserName()}, but specifying a class literal rather than
+     * a fully qualified class name.
      * 
      * <p>
-     * Implementation note: the default value provided here is simply the {@link Parseable}'s own class, because
-     * <tt>null</tt> is not a valid default.
+     * Implementation note: the default value provided here is simply the
+     * {@link Parseable}'s own class, because <tt>null</tt> is not a valid
+     * default.
      */
     Class<?> parserClass() default Parseable.class;
 }

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/QueryOnly.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/QueryOnly.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/QueryOnly.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/QueryOnly.java Sat Jan 21 18:30:32 2012
@@ -26,7 +26,8 @@ import java.lang.annotation.RetentionPol
 import java.lang.annotation.Target;
 
 /**
- * Indicates that an action is query only; invoking it will not modify any domain object state.
+ * Indicates that an action is query only; invoking it will not modify any
+ * domain object state.
  */
 @Inherited
 @Target({ ElementType.METHOD })

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/RegEx.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/RegEx.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/RegEx.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/RegEx.java Sat Jan 21 18:30:32 2012
@@ -26,11 +26,12 @@ import java.lang.annotation.RetentionPol
 import java.lang.annotation.Target;
 
 /**
- * Provides a regular expression that a value entry should conform to, and can be formatted as.
+ * Provides a regular expression that a value entry should conform to, and can
+ * be formatted as.
  * 
  * <p>
- * Can also be specified for types that are annotated as <tt>@Value</tt> types. To apply, the value must have string
- * semantics.
+ * Can also be specified for types that are annotated as <tt>@Value</tt> types.
+ * To apply, the value must have string semantics.
  */
 @Inherited
 @Target({ ElementType.TYPE, ElementType.METHOD, ElementType.PARAMETER })

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/Stable.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/Stable.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/Stable.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/Stable.java Sat Jan 21 18:30:32 2012
@@ -26,13 +26,12 @@ import java.lang.annotation.RetentionPol
 import java.lang.annotation.Target;
 
 /**
- * Indicates that an entity's definition is stable, 
- * such that any changes to its structure will be
- * backwardly compatible.
+ * Indicates that an entity's definition is stable, such that any changes to its
+ * structure will be backwardly compatible.
  * 
  * <p>
- * Originally introduced to support the json-viewer's
- * RESTful support for application-defined mime types.
+ * Originally introduced to support the json-viewer's RESTful support for
+ * application-defined mime types.
  */
 @Inherited
 @Target({ ElementType.TYPE })

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/Title.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/Title.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/Title.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/Title.java Sat Jan 21 18:30:32 2012
@@ -25,27 +25,32 @@ import java.lang.annotation.RetentionPol
 import java.lang.annotation.Target;
 
 /**
- * A title annotation used to annotate methods used to construct the title of a domain object instance.
- * It is used as a marker.
+ * A title annotation used to annotate methods used to construct the title of a
+ * domain object instance. It is used as a marker.
  */
 @Retention(RetentionPolicy.RUNTIME)
 @Target(ElementType.METHOD)
 public @interface Title {
     /**
-     * The order (in Dewey decimal notation) that the property annotated with {@link Title} appears with respect to 
-     * other properties also annotated with {@link Title}.
+     * The order (in Dewey decimal notation) that the property annotated with
+     * {@link Title} appears with respect to other properties also annotated
+     * with {@link Title}.
      */
     String sequence() default "1.0";
+
     /**
-     * The string to use to separate this property from any preceding properties in the title.  
+     * The string to use to separate this property from any preceding properties
+     * in the title.
      */
     String prepend() default " ";
+
     /**
-     * The string to append to this property if non-empty.  
+     * The string to append to this property if non-empty.
      */
     String append() default "";
+
     /**
-     * The length to abbreviate this title element to.  
+     * The length to abbreviate this title element to.
      */
     int abbreviatedTo() default Integer.MAX_VALUE;
 }

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/TypicalLength.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/TypicalLength.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/TypicalLength.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/TypicalLength.java Sat Jan 21 18:30:32 2012
@@ -28,7 +28,8 @@ import java.lang.annotation.Target;
 import org.apache.isis.applib.adapters.Parser;
 
 /**
- * The typical entry length of a field, use to determine the optimum width for display
+ * The typical entry length of a field, use to determine the optimum width for
+ * display
  * 
  * @see Parser
  */

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/Value.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/Value.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/Value.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/annotation/Value.java Sat Jan 21 18:30:32 2012
@@ -32,19 +32,22 @@ import org.apache.isis.applib.adapters.V
  * Indicates that the class has value semantics.
  * 
  * <p>
- * By &quot;value semantics&quot; all we actually mean that the class is {@link Aggregated} and so therefore
- * (conceptually) is not shared between instances of classes. However, values very often have other semantics, and so
+ * By &quot;value semantics&quot; all we actually mean that the class is
+ * {@link Aggregated} and so therefore (conceptually) is not shared between
+ * instances of classes. However, values very often have other semantics, and so
  * this annotation allows these to also be specified:
  * <li>it may be parseable (as per {@link Parseable})</li>
  * <li>it may be encodeable (as per {@link Encodable})</li>
- * <li>it may be immutable (as per {@link Immutable}), and by default is presumed that it is</li>
- * <li>it may follow the equal-by-content contract (as per {@link EqualByContent}), and by default is presumed that it
- * does.</i> </ul>
+ * <li>it may be immutable (as per {@link Immutable}), and by default is
+ * presumed that it is</li>
+ * <li>it may follow the equal-by-content contract (as per
+ * {@link EqualByContent}), and by default is presumed that it does.</i> </ul>
  * 
  * <p>
- * Note also that though a value is conceptually not shared, if it is also {@link Immutable immutable} then it is in
- * fact safe to share objects (as in the flyweight pattern). In addition, the {@link EqualByContent} semantic means that
- * we needn't care whether value types are being shared or not.
+ * Note also that though a value is conceptually not shared, if it is also
+ * {@link Immutable immutable} then it is in fact safe to share objects (as in
+ * the flyweight pattern). In addition, the {@link EqualByContent} semantic
+ * means that we needn't care whether value types are being shared or not.
  * 
  * @see Aggregated
  * @see Parseable
@@ -58,31 +61,37 @@ import org.apache.isis.applib.adapters.V
 public @interface Value {
 
     /**
-     * The fully qualified name of a class that implements the {@link ValueSemanticsProvider} interface.
+     * The fully qualified name of a class that implements the
+     * {@link ValueSemanticsProvider} interface.
      * 
      * <p>
-     * This is optional because some implementations may pick up encodeability via a configuration file, or via the
-     * equivalent {@link #semanticsProviderClass()}.
+     * This is optional because some implementations may pick up encodeability
+     * via a configuration file, or via the equivalent
+     * {@link #semanticsProviderClass()}.
      * 
      * <p>
-     * It is possible for value classes to act as their own semantics providers, and may in particular implement the
-     * {@link EncoderDecoder} interface. The framework requires that the nominated class provides a <tt>public</tt>
-     * no-arg constructor on the class, and will instantiates an instance of the class to interact with it. In the case
-     * of encoding, the framework uses the result of discards the instantiated object. What that means in particular is
-     * that a self-encoding class shouldn't encode its own state, it should encode the state of the object passed to it.
+     * It is possible for value classes to act as their own semantics providers,
+     * and may in particular implement the {@link EncoderDecoder} interface. The
+     * framework requires that the nominated class provides a <tt>public</tt>
+     * no-arg constructor on the class, and will instantiates an instance of the
+     * class to interact with it. In the case of encoding, the framework uses
+     * the result of discards the instantiated object. What that means in
+     * particular is that a self-encoding class shouldn't encode its own state,
+     * it should encode the state of the object passed to it.
      * 
      * <p>
-     * Implementation note: the default value provided here is simply an empty string because <tt>null</tt> is not a
-     * valid default.
+     * Implementation note: the default value provided here is simply an empty
+     * string because <tt>null</tt> is not a valid default.
      */
     String semanticsProviderName() default "";
 
     /**
-     * As per {@link #semanticsProviderName()}, but specifying a class literal rather than a fully qualified class name.
+     * As per {@link #semanticsProviderName()}, but specifying a class literal
+     * rather than a fully qualified class name.
      * 
      * <p>
-     * Implementation note: the default value provided here is simply the {@link Value}'s own class, because
-     * <tt>null</tt> is not a valid default.
+     * Implementation note: the default value provided here is simply the
+     * {@link Value}'s own class, because <tt>null</tt> is not a valid default.
      */
     Class<?> semanticsProviderClass() default Value.class;
 

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/clock/Clock.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/clock/Clock.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/clock/Clock.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/clock/Clock.java Sat Jan 21 18:30:32 2012
@@ -22,24 +22,26 @@ package org.apache.isis.applib.clock;
 import java.util.Calendar;
 import java.util.Date;
 
-import org.joda.time.DateTime;
-
 import org.apache.isis.applib.ApplicationException;
 import org.apache.isis.applib.Defaults;
 import org.apache.isis.applib.fixtures.FixtureClock;
+import org.joda.time.DateTime;
 
 /**
  * Provides a mechanism to get (and possible to set) the current time.
  * 
  * <p>
- * The clock is used primarily by the temporal value classes, and is accessed by the NOF as a singleton. The actual
- * implementation used can be configured at startup, but once specified the clock instance cannot be changed.
+ * The clock is used primarily by the temporal value classes, and is accessed by
+ * the NOF as a singleton. The actual implementation used can be configured at
+ * startup, but once specified the clock instance cannot be changed.
  * 
  * <p>
- * Unless another {@link Clock} implementation has been installed, the first call to {@link #getInstance()} will
- * instantiate an implementation that just uses the system's own clock. Alternate implementations can be created via
- * suitable subclasses, but this must be done <b><i>before</i></b> the first call to {@link #getInstance()}. See for
- * example {@link FixtureClock#getInstance()}.
+ * Unless another {@link Clock} implementation has been installed, the first
+ * call to {@link #getInstance()} will instantiate an implementation that just
+ * uses the system's own clock. Alternate implementations can be created via
+ * suitable subclasses, but this must be done <b><i>before</i></b> the first
+ * call to {@link #getInstance()}. See for example
+ * {@link FixtureClock#getInstance()}.
  */
 public abstract class Clock {
     private static Clock instance;
@@ -49,8 +51,9 @@ public abstract class Clock {
      * Returns the (singleton) instance of {@link Clock}.
      * 
      * <p>
-     * Unless it has been otherwise created, will lazily instantiate an implementation that just delegate to the
-     * computer's own system clock (as per {@link System#currentTimeMillis()}.
+     * Unless it has been otherwise created, will lazily instantiate an
+     * implementation that just delegate to the computer's own system clock (as
+     * per {@link System#currentTimeMillis()}.
      * 
      * @return
      */
@@ -79,8 +82,9 @@ public abstract class Clock {
     }
 
     /**
-     * Convenience method returning the current {@link #getTime() time} according to this Clock as a mutable
-     * {@link Calendar}. Consider replacing with {@link #getTimeAsDateTime()
+     * Convenience method returning the current {@link #getTime() time}
+     * according to this Clock as a mutable {@link Calendar}. Consider replacing
+     * with {@link #getTimeAsDateTime()
 
      */
     @Deprecated
@@ -89,8 +93,9 @@ public abstract class Clock {
     }
 
     /**
-     * Convenience method returning the current {@link #getTime() time} according to this Clock as a (nominally
-     * im)mutable {@link Date}. You should now use {@link #getTimeAsDateTime()}
+     * Convenience method returning the current {@link #getTime() time}
+     * according to this Clock as a (nominally im)mutable {@link Date}. You
+     * should now use {@link #getTimeAsDateTime()}
      * 
      */
     @Deprecated
@@ -137,7 +142,8 @@ public abstract class Clock {
      * The current time since midnight, January 1, 1970 UTC.
      * 
      * <p>
-     * Measured in milliseconds, modeled after (and possibly implemented by) {@link System#currentTimeMillis()}.
+     * Measured in milliseconds, modeled after (and possibly implemented by)
+     * {@link System#currentTimeMillis()}.
      */
     protected abstract long time();
 

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/AccessEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/AccessEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/AccessEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/AccessEvent.java Sat Jan 21 18:30:32 2012
@@ -25,9 +25,10 @@ import org.apache.isis.applib.Identifier
  * Represents an access (reading) of a property, collection or title.
  * 
  * <p>
- * Analogous to {@link ValidityEvent} (which corresponds to modifying a property or collection etc), however the
- * {@link #getReason()} will always be <tt>null</tt>. (If access is not allowed then a vetoing {@link VisibilityEvent}
- * would have been fired).
+ * Analogous to {@link ValidityEvent} (which corresponds to modifying a property
+ * or collection etc), however the {@link #getReason()} will always be
+ * <tt>null</tt>. (If access is not allowed then a vetoing
+ * {@link VisibilityEvent} would have been fired).
  * 
  * @see UsabilityEvent
  * @see VisibilityEvent

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ActionArgumentEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ActionArgumentEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ActionArgumentEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ActionArgumentEvent.java Sat Jan 21 18:30:32 2012
@@ -22,11 +22,12 @@ package org.apache.isis.applib.events;
 import org.apache.isis.applib.Identifier;
 
 /**
- * Represents a check as to whether a particular argument for an action is valid or not.
+ * Represents a check as to whether a particular argument for an action is valid
+ * or not.
  * 
  * <p>
- * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the argument is invalid; otherwise the
- * argument is valid.
+ * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the
+ * argument is invalid; otherwise the argument is valid.
  * 
  * <p>
  * Called once per argument, and before {@link ActionInvocationEvent}.
@@ -39,8 +40,7 @@ public class ActionArgumentEvent extends
     private final int position;
     private final Object proposed;
 
-    public ActionArgumentEvent(final Object source, final Identifier actionIdentifier, final Object[] args,
-        final int position) {
+    public ActionArgumentEvent(final Object source, final Identifier actionIdentifier, final Object[] args, final int position) {
         super(source, actionIdentifier);
         this.args = args;
         this.position = position;

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ActionInvocationEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ActionInvocationEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ActionInvocationEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ActionInvocationEvent.java Sat Jan 21 18:30:32 2012
@@ -22,11 +22,12 @@ package org.apache.isis.applib.events;
 import org.apache.isis.applib.Identifier;
 
 /**
- * Represents a check as to whether a particular argument for an action is valid or not.
+ * Represents a check as to whether a particular argument for an action is valid
+ * or not.
  * 
  * <p>
- * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the set of arguments are invalid; otherwise
- * the arguments are valid.
+ * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the
+ * set of arguments are invalid; otherwise the arguments are valid.
  * 
  * <p>
  * Called after each of the {@link ActionArgumentEvent}s.

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ActionUsabilityEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ActionUsabilityEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ActionUsabilityEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ActionUsabilityEvent.java Sat Jan 21 18:30:32 2012
@@ -25,8 +25,8 @@ import org.apache.isis.applib.Identifier
  * Represents a check as to whether an action is usable or has been disabled.
  * 
  * <p>
- * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the action is disabled; otherwise action is
- * enabled.
+ * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the
+ * action is disabled; otherwise action is enabled.
  */
 public class ActionUsabilityEvent extends UsabilityEvent {
 

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ActionVisibilityEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ActionVisibilityEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ActionVisibilityEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ActionVisibilityEvent.java Sat Jan 21 18:30:32 2012
@@ -25,8 +25,8 @@ import org.apache.isis.applib.Identifier
  * Represents a check as to whether an action is visible or has been hidden.
  * 
  * <p>
- * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the action is invisible; otherwise action
- * is visible.
+ * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the
+ * action is invisible; otherwise action is visible.
  */
 public class ActionVisibilityEvent extends VisibilityEvent {
 

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionAccessEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionAccessEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionAccessEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionAccessEvent.java Sat Jan 21 18:30:32 2012
@@ -25,9 +25,10 @@ import org.apache.isis.applib.Identifier
  * Represents an access (reading) of a collection.
  * 
  * <p>
- * Analogous to {@link CollectionAddToEvent} or {@link CollectionRemoveFromEvent}, however the {@link #getReason()} will
- * always be <tt>null</tt>. (If access is not allowed then a vetoing {@link CollectionVisibilityEvent} would have been
- * fired).
+ * Analogous to {@link CollectionAddToEvent} or
+ * {@link CollectionRemoveFromEvent}, however the {@link #getReason()} will
+ * always be <tt>null</tt>. (If access is not allowed then a vetoing
+ * {@link CollectionVisibilityEvent} would have been fired).
  */
 public class CollectionAccessEvent extends AccessEvent {
 

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionAddToEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionAddToEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionAddToEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionAddToEvent.java Sat Jan 21 18:30:32 2012
@@ -22,11 +22,12 @@ package org.apache.isis.applib.events;
 import org.apache.isis.applib.Identifier;
 
 /**
- * Represents a check as to whether a particular object to be added to a collection is valid or not.
+ * Represents a check as to whether a particular object to be added to a
+ * collection is valid or not.
  * 
  * <p>
- * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the object is invalid; otherwise the object
- * is valid.
+ * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the
+ * object is invalid; otherwise the object is valid.
  * 
  * @see CollectionRemoveFromEvent
  */

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionMethodEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionMethodEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionMethodEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionMethodEvent.java Sat Jan 21 18:30:32 2012
@@ -33,8 +33,7 @@ public class CollectionMethodEvent exten
     private final Object[] args;
     private final Object returnValue;
 
-    public CollectionMethodEvent(final Object source, final Identifier collectionIdentifier, final Object domainObject,
-        final String methodName, final Object[] args, final Object returnValue) {
+    public CollectionMethodEvent(final Object source, final Identifier collectionIdentifier, final Object domainObject, final String methodName, final Object[] args, final Object returnValue) {
         super(source, collectionIdentifier);
         this.domainObject = domainObject;
         this.methodName = methodName;
@@ -43,8 +42,8 @@ public class CollectionMethodEvent exten
     }
 
     /**
-     * The collection object (an instance of a <tt>List</tt> or a <tt>Set</tt> etc) that is the originator of this
-     * event.
+     * The collection object (an instance of a <tt>List</tt> or a <tt>Set</tt>
+     * etc) that is the originator of this event.
      * 
      * <p>
      * The owning domain object is available using {@link #getDomainObject()}.
@@ -57,7 +56,8 @@ public class CollectionMethodEvent exten
     }
 
     /**
-     * The owner of the collection (an instance of <tt>Customer/tt> or <tt>Order</tt>, say).
+     * The owner of the collection (an instance of
+     * <tt>Customer/tt> or <tt>Order</tt>, say).
      * 
      * @see #getSource()
      */
@@ -66,7 +66,8 @@ public class CollectionMethodEvent exten
     }
 
     /**
-     * The name of the method invoked on this collection, for example <tt>isEmpty</tt>.
+     * The name of the method invoked on this collection, for example
+     * <tt>isEmpty</tt>.
      * 
      * @return
      */
@@ -75,7 +76,8 @@ public class CollectionMethodEvent exten
     }
 
     /**
-     * The arguments with which the collection's {@link #getMethodName() method} was invoked.
+     * The arguments with which the collection's {@link #getMethodName() method}
+     * was invoked.
      */
     public Object[] getArgs() {
         return args;

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionRemoveFromEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionRemoveFromEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionRemoveFromEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionRemoveFromEvent.java Sat Jan 21 18:30:32 2012
@@ -22,11 +22,12 @@ package org.apache.isis.applib.events;
 import org.apache.isis.applib.Identifier;
 
 /**
- * Represents a check as to whether a particular object to be removed from a collection is valid or not.
+ * Represents a check as to whether a particular object to be removed from a
+ * collection is valid or not.
  * 
  * <p>
- * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the object is invalid; otherwise the object
- * is valid.
+ * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the
+ * object is invalid; otherwise the object is valid.
  * 
  * @see CollectionAddToEvent
  */

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionUsabilityEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionUsabilityEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionUsabilityEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionUsabilityEvent.java Sat Jan 21 18:30:32 2012
@@ -25,8 +25,8 @@ import org.apache.isis.applib.Identifier
  * Represents a check as to whether a collection is usable or has been disabled.
  * 
  * <p>
- * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the collection is disabled; otherwise
- * collection is enabled.
+ * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the
+ * collection is disabled; otherwise collection is enabled.
  */
 public class CollectionUsabilityEvent extends UsabilityEvent {
 

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionVisibilityEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionVisibilityEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionVisibilityEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/CollectionVisibilityEvent.java Sat Jan 21 18:30:32 2012
@@ -25,8 +25,8 @@ import org.apache.isis.applib.Identifier
  * Represents a check as to whether a collection is visible or has been hidden.
  * 
  * <p>
- * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the collection is invisible; otherwise
- * collection is visible.
+ * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the
+ * collection is invisible; otherwise collection is visible.
  */
 public class CollectionVisibilityEvent extends VisibilityEvent {
 

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/InteractionEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/InteractionEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/InteractionEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/InteractionEvent.java Sat Jan 21 18:30:32 2012
@@ -25,12 +25,12 @@ import java.util.List;
 import org.apache.isis.applib.Identifier;
 
 /**
- * Represents an interaction with a domain object or a particular feature (property, collection, action) of a domain
- * object.
+ * Represents an interaction with a domain object or a particular feature
+ * (property, collection, action) of a domain object.
  * 
  * <p>
- * Many of the interactions are checks for {@link VisibilityEvent visibility}, {@link UsabilityEvent usability} and
- * {@link ValidityEvent validity}.
+ * Many of the interactions are checks for {@link VisibilityEvent visibility},
+ * {@link UsabilityEvent usability} and {@link ValidityEvent validity}.
  */
 public abstract class InteractionEvent extends EventObject {
 
@@ -54,11 +54,13 @@ public abstract class InteractionEvent e
     }
 
     /**
-     * The {@link Identifier} of the feature of the object being interacted with.
+     * The {@link Identifier} of the feature of the object being interacted
+     * with.
      * 
      * <p>
-     * Will be consistent with the subclass of {@link InteractionEvent}. So for example a {@link PropertyModifyEvent}
-     * will have an {@link Identifier} that identifies the property being modified.
+     * Will be consistent with the subclass of {@link InteractionEvent}. So for
+     * example a {@link PropertyModifyEvent} will have an {@link Identifier}
+     * that identifies the property being modified.
      * 
      * @return
      */
@@ -76,16 +78,17 @@ public abstract class InteractionEvent e
     }
 
     /**
-     * Convenience method that returns the {@link Identifier#getClassNaturalName() natural class name} of the {@link #getIdentifier()
-     * identifier}.
+     * Convenience method that returns the
+     * {@link Identifier#getClassNaturalName() natural class name} of the
+     * {@link #getIdentifier() identifier}.
      */
     public String getClassNaturalName() {
         return identifier.getClassNaturalName();
     }
 
     /**
-     * Convenience method that returns the {@link Identifier#getMemberName() member name} of the
-     * {@link #getIdentifier() identifier}.
+     * Convenience method that returns the {@link Identifier#getMemberName()
+     * member name} of the {@link #getIdentifier() identifier}.
      * 
      * @see #getIdentifier
      */
@@ -101,8 +104,8 @@ public abstract class InteractionEvent e
     }
 
     /**
-     * Convenience method that returns the {@link Identifier#getClassName() class name} of the {@link #getIdentifier()
-     * identifier}.
+     * Convenience method that returns the {@link Identifier#getClassName()
+     * class name} of the {@link #getIdentifier() identifier}.
      */
     public List<String> getMemberParameterNames() {
         return identifier.getMemberParameterNames();
@@ -116,10 +119,12 @@ public abstract class InteractionEvent e
     }
 
     /**
-     * The reason, if any, that this interaction may have been vetoed or otherwise disallowed.
+     * The reason, if any, that this interaction may have been vetoed or
+     * otherwise disallowed.
      * 
      * <p>
-     * Intended to be {@link #setReason(String) set} as a result of consulting one of the facets.
+     * Intended to be {@link #setReason(String) set} as a result of consulting
+     * one of the facets.
      * 
      * @return
      */
@@ -128,8 +133,9 @@ public abstract class InteractionEvent e
     }
 
     /**
-     * The class of the (first) advisor, if any, that provided the {@link #getReason() reason} that this interaction is
-     * {@link #isVeto() vetoed}.
+     * The class of the (first) advisor, if any, that provided the
+     * {@link #getReason() reason} that this interaction is {@link #isVeto()
+     * vetoed}.
      * 
      * @return
      */
@@ -138,8 +144,9 @@ public abstract class InteractionEvent e
     }
 
     /**
-     * Specify the {@link #getReason() reason} that this interaction has been vetoed and the {@link #getAdvisorClass()
-     * class of the advisor} that did the veto.
+     * Specify the {@link #getReason() reason} that this interaction has been
+     * vetoed and the {@link #getAdvisorClass() class of the advisor} that did
+     * the veto.
      */
     public void advised(final String reason, final Class<?> advisorClass) {
         this.reason = reason;
@@ -147,16 +154,20 @@ public abstract class InteractionEvent e
     }
 
     /**
-     * Whether this interaction has been vetoed (meaning that {@link #getReason()} and {@link #getAdvisorClass()} will
-     * both be non-<tt>null</tt> and the {@link #getReason() reason} non-empty.)
+     * Whether this interaction has been vetoed (meaning that
+     * {@link #getReason()} and {@link #getAdvisorClass()} will both be non-
+     * <tt>null</tt> and the {@link #getReason() reason} non-empty.)
      * 
      * <p>
      * The interpretation of this depends on the subclass:
      * <ul>
-     * <li>for {@link VisibilityEvent}, a veto means that the feature (property, collection, action) is hidden</li>
-     * <li>for {@link UsabilityEvent}, a veto means that the feature is disabled</li>
-     * <li>for {@link ValidityEvent}, a veto means that the proposed modification (property value, object added/removed,
-     * action argument) is invalid</li>
+     * <li>for {@link VisibilityEvent}, a veto means that the feature (property,
+     * collection, action) is hidden</li>
+     * <li>for {@link UsabilityEvent}, a veto means that the feature is disabled
+     * </li>
+     * <li>for {@link ValidityEvent}, a veto means that the proposed
+     * modification (property value, object added/removed, action argument) is
+     * invalid</li>
      * </ul>
      */
     public boolean isVeto() {

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ObjectTitleEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ObjectTitleEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ObjectTitleEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ObjectTitleEvent.java Sat Jan 21 18:30:32 2012
@@ -25,7 +25,8 @@ import org.apache.isis.applib.Identifier
  * Represents an access (reading) of an object's title.
  * 
  * <p>
- * The {@link #getReason()} will always be <tt>null</tt>; access is always allowed.
+ * The {@link #getReason()} will always be <tt>null</tt>; access is always
+ * allowed.
  */
 public class ObjectTitleEvent extends AccessEvent {
 

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ObjectValidityEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ObjectValidityEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ObjectValidityEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ObjectValidityEvent.java Sat Jan 21 18:30:32 2012
@@ -22,11 +22,13 @@ package org.apache.isis.applib.events;
 import org.apache.isis.applib.Identifier;
 
 /**
- * Represents a check as to whether the current values of the properties/collections of an object are valid (for
- * example, prior to saving that object).
+ * Represents a check as to whether the current values of the
+ * properties/collections of an object are valid (for example, prior to saving
+ * that object).
  * 
  * <p>
- * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the object is invalid, otherwise ok.
+ * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the
+ * object is invalid, otherwise ok.
  */
 public class ObjectValidityEvent extends ValidityEvent {
 

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ParseValueEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ParseValueEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ParseValueEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ParseValueEvent.java Sat Jan 21 18:30:32 2012
@@ -22,11 +22,12 @@ package org.apache.isis.applib.events;
 import org.apache.isis.applib.Identifier;
 
 /**
- * Represents a check as to whether the proposed values of the value type is valid.
+ * Represents a check as to whether the proposed values of the value type is
+ * valid.
  * 
  * <p>
- * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the proposed value is invalid, otherwise
- * the new value is acceptable.
+ * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the
+ * proposed value is invalid, otherwise the new value is acceptable.
  */
 public class ParseValueEvent extends ValidityEvent {
 
@@ -44,8 +45,9 @@ public class ParseValueEvent extends Val
     }
 
     /**
-     * Will be the source provided in the {@link #ParseValueEvent(Object, Identifier, String) constructor} if not null,
-     * otherwise will fallback to the proposed value.
+     * Will be the source provided in the
+     * {@link #ParseValueEvent(Object, Identifier, String) constructor} if not
+     * null, otherwise will fallback to the proposed value.
      */
     @Override
     public Object getSource() {

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/PropertyAccessEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/PropertyAccessEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/PropertyAccessEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/PropertyAccessEvent.java Sat Jan 21 18:30:32 2012
@@ -25,8 +25,9 @@ import org.apache.isis.applib.Identifier
  * Represents an access (reading) of a property.
  * 
  * <p>
- * Analogous to {@link PropertyModifyEvent}, however the {@link #getReason()} will always be <tt>null</tt>. (If access
- * is not allowed then a {@link PropertyVisibilityEvent} would have been fired).
+ * Analogous to {@link PropertyModifyEvent}, however the {@link #getReason()}
+ * will always be <tt>null</tt>. (If access is not allowed then a
+ * {@link PropertyVisibilityEvent} would have been fired).
  */
 public class PropertyAccessEvent extends AccessEvent {
 

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/PropertyModifyEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/PropertyModifyEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/PropertyModifyEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/PropertyModifyEvent.java Sat Jan 21 18:30:32 2012
@@ -22,11 +22,12 @@ package org.apache.isis.applib.events;
 import org.apache.isis.applib.Identifier;
 
 /**
- * Represents a check as to whether a particular value for a property is valid or not.
+ * Represents a check as to whether a particular value for a property is valid
+ * or not.
  * 
  * <p>
- * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the value is invalid; otherwise the value
- * is valid.
+ * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the
+ * value is invalid; otherwise the value is valid.
  */
 public class PropertyModifyEvent extends ValidityEvent {
 

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/PropertyUsabilityEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/PropertyUsabilityEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/PropertyUsabilityEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/PropertyUsabilityEvent.java Sat Jan 21 18:30:32 2012
@@ -25,8 +25,8 @@ import org.apache.isis.applib.Identifier
  * Represents a check as to whether a property is usable or has been disabled.
  * 
  * <p>
- * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the property is disabled; otherwise
- * property is enabled.
+ * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the
+ * property is disabled; otherwise property is enabled.
  */
 public class PropertyUsabilityEvent extends UsabilityEvent {
 

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/PropertyVisibilityEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/PropertyVisibilityEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/PropertyVisibilityEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/PropertyVisibilityEvent.java Sat Jan 21 18:30:32 2012
@@ -25,8 +25,8 @@ import org.apache.isis.applib.Identifier
  * Represents a check as to whether a property is visible or has been hidden.
  * 
  * <p>
- * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the property is invisible; otherwise
- * property is visible.
+ * If {@link #getReason()} is not <tt>null</tt> then provides the reason why the
+ * property is invisible; otherwise property is visible.
  */
 public class PropertyVisibilityEvent extends VisibilityEvent {
 

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ProposedHolderEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ProposedHolderEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ProposedHolderEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ProposedHolderEvent.java Sat Jan 21 18:30:32 2012
@@ -20,8 +20,9 @@
 package org.apache.isis.applib.events;
 
 /**
- * Makes it easier to process different events that hold a single proposed argument (such as
- * {@link CollectionAddToEvent} and {@link PropertyModifyEvent}).
+ * Makes it easier to process different events that hold a single proposed
+ * argument (such as {@link CollectionAddToEvent} and
+ * {@link PropertyModifyEvent}).
  */
 public interface ProposedHolderEvent {
 

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/UsabilityEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/UsabilityEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/UsabilityEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/UsabilityEvent.java Sat Jan 21 18:30:32 2012
@@ -22,10 +22,12 @@ package org.apache.isis.applib.events;
 import org.apache.isis.applib.Identifier;
 
 /**
- * Represents a check to determine whether a member of an object is usable or has been disabled.
+ * Represents a check to determine whether a member of an object is usable or
+ * has been disabled.
  * 
  * <p>
- * If {@link #getReason()} is <tt>null</tt>, then is usable; otherwise is disabled.
+ * If {@link #getReason()} is <tt>null</tt>, then is usable; otherwise is
+ * disabled.
  * 
  * @see AccessEvent
  * @see VisibilityEvent

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ValidityEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ValidityEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ValidityEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/ValidityEvent.java Sat Jan 21 18:30:32 2012
@@ -35,7 +35,8 @@ import org.apache.isis.applib.Identifier
  * </ul>
  * 
  * <p>
- * If {@link #getReason()} is <tt>null</tt>, then is usable; otherwise is disabled.
+ * If {@link #getReason()} is <tt>null</tt>, then is usable; otherwise is
+ * disabled.
  * 
  * @see AccessEvent
  * @see VisibilityEvent

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/VisibilityEvent.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/VisibilityEvent.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/VisibilityEvent.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/events/VisibilityEvent.java Sat Jan 21 18:30:32 2012
@@ -22,10 +22,12 @@ package org.apache.isis.applib.events;
 import org.apache.isis.applib.Identifier;
 
 /**
- * Represents a check to determine whether a member of an object is visible or has been hidden.
+ * Represents a check to determine whether a member of an object is visible or
+ * has been hidden.
  * 
  * <p>
- * If {@link #getReason()} is <tt>null</tt>, then is usable; otherwise is invisible.
+ * If {@link #getReason()} is <tt>null</tt>, then is usable; otherwise is
+ * invisible.
  * 
  * @see AccessEvent
  * @see UsabilityEvent

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/filter/Filter.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/filter/Filter.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/filter/Filter.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/filter/Filter.java Sat Jan 21 18:30:32 2012
@@ -20,14 +20,16 @@
 package org.apache.isis.applib.filter;
 
 /**
- * For use by repository implementations to allow a set of objects returned by a back-end objectstore to be filtered
- * before being returned to the caller.
+ * For use by repository implementations to allow a set of objects returned by a
+ * back-end objectstore to be filtered before being returned to the caller.
  * 
  * <p>
- * Note that this is different from the pattern or criteria object accepted by some repositories' <tt>findXxx</tt>
- * methods. Such criteria objects are implementation-specific to the configured objectstore and allow it to return an
- * already-filtered set of rows. (For example, a Hibernate-based ObjectStore would accept a representation of a HQL
- * query; an XML-based objectstore might accept an XPath query, etc.)
+ * Note that this is different from the pattern or criteria object accepted by
+ * some repositories' <tt>findXxx</tt> methods. Such criteria objects are
+ * implementation-specific to the configured objectstore and allow it to return
+ * an already-filtered set of rows. (For example, a Hibernate-based ObjectStore
+ * would accept a representation of a HQL query; an XML-based objectstore might
+ * accept an XPath query, etc.)
  */
 public interface Filter<T> {
 
@@ -35,7 +37,8 @@ public interface Filter<T> {
      * Whether or not the supplied pojo meets this criteria.
      * 
      * @param pojo
-     * @return <tt>true</tt> if this pojo is acceptable, <tt>false</tt> otherwise.
+     * @return <tt>true</tt> if this pojo is acceptable, <tt>false</tt>
+     *         otherwise.
      */
     public boolean accept(T t);
 }

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/filter/Filters.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/filter/Filters.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/filter/Filters.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/filter/Filters.java Sat Jan 21 18:30:32 2012
@@ -17,55 +17,53 @@
  *  under the License.
  */
 
+package org.apache.isis.applib.filter;
 
-package org.apache.isis.applib.filter;
+public final class Filters {
 
-
-
-public final class Filters {
-
-    private Filters() {}
-
-    public static <T> Filter<T> and(final Filter<T> f1, final Filter<T> f2) {
-        return new Filter<T>() {
-            @Override
-            public boolean accept(final T f) {
-                return f1.accept(f) && f2.accept(f);
-            }
-        };
-    }
-
-    public static <T> Filter<T> or(final Filter<T> f1, final Filter<T> f2) {
-        return new Filter<T>() {
-            @Override
-            public boolean accept(final T f) {
-                return f1.accept(f) || f2.accept(f);
-            }
-        };
-    }
-
-    public static <T> Filter<T> not(final Filter<T> f1) {
-        return new Filter<T>() {
-            @Override
-            public boolean accept(final T f) {
-                return !f1.accept(f);
-            }
-        };
-    }
-
-    public static <T> Filter<T> any() {
-        return new Filter<T>() {
-
-            @Override
-            public boolean accept(final T t) {
-                return true;
-            }
-        };
-    }
+    private Filters() {
+    }
+
+    public static <T> Filter<T> and(final Filter<T> f1, final Filter<T> f2) {
+        return new Filter<T>() {
+            @Override
+            public boolean accept(final T f) {
+                return f1.accept(f) && f2.accept(f);
+            }
+        };
+    }
+
+    public static <T> Filter<T> or(final Filter<T> f1, final Filter<T> f2) {
+        return new Filter<T>() {
+            @Override
+            public boolean accept(final T f) {
+                return f1.accept(f) || f2.accept(f);
+            }
+        };
+    }
+
+    public static <T> Filter<T> not(final Filter<T> f1) {
+        return new Filter<T>() {
+            @Override
+            public boolean accept(final T f) {
+                return !f1.accept(f);
+            }
+        };
+    }
+
+    public static <T> Filter<T> any() {
+        return new Filter<T>() {
+
+            @Override
+            public boolean accept(final T t) {
+                return true;
+            }
+        };
+    }
 
     public final static <T> Filter<T> anyOfType(final Class<T> clazz) {
         return any();
-    }
+    }
 
     public static <T> Filter<T> none() {
         return new Filter<T>() {
@@ -76,8 +74,8 @@ public final class Filters {
         };
     }
 
-    public static <T> Filter<T> noneOfType(final Class<T> clazz) {
-        return none();
+    public static <T> Filter<T> noneOfType(final Class<T> clazz) {
+        return none();
     }
-
-}
+
+}

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/fixtures/AbstractFixture.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/fixtures/AbstractFixture.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/fixtures/AbstractFixture.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/fixtures/AbstractFixture.java Sat Jan 21 18:30:32 2012
@@ -30,14 +30,17 @@ import org.apache.isis.applib.fixtures.s
  * Convenience class for creating fixtures.
  * 
  * <p>
- * Most subclasses will simply override {@link #install()} to setup objects. In addition though fixtures may also:
+ * Most subclasses will simply override {@link #install()} to setup objects. In
+ * addition though fixtures may also:
  * <ul>
- * <li>change the date/time within the course of fixture installation, using {@link #setDate(int, int, int)} and
- * {@link #setTime(int, int)}.
+ * <li>change the date/time within the course of fixture installation, using
+ * {@link #setDate(int, int, int)} and {@link #setTime(int, int)}.
  * <li>change the current user using {@link #switchUser(String, String...)}.
  * <li>create composite fixtures using {@link #addFixture(Object)}.
- * <li>search for existing objects using {@link #firstMatch(Class, org.apache.isis.applib.Filter)} or
- * {@link #uniqueMatch(Class, org.apache.isis.applib.Filter)} (and various overloads thereof).
+ * <li>search for existing objects using
+ * {@link #firstMatch(Class, org.apache.isis.applib.Filter)} or
+ * {@link #uniqueMatch(Class, org.apache.isis.applib.Filter)} (and various
+ * overloads thereof).
  * </ul>
  * 
  * <p>
@@ -67,8 +70,8 @@ public abstract class AbstractFixture ex
     // ///////////////////////////////////////////////////////////////
 
     /**
-     * Most subclasses will override this method, but composite fixtures should instead call {@link #addFixture(Object)}
-     * in their constructor.
+     * Most subclasses will override this method, but composite fixtures should
+     * instead call {@link #addFixture(Object)} in their constructor.
      */
     @Override
     public void install() {
@@ -86,7 +89,8 @@ public abstract class AbstractFixture ex
     }
 
     /**
-     * Returns an array of any fixtures that have been {@link #addFixture(Object) added}.
+     * Returns an array of any fixtures that have been
+     * {@link #addFixture(Object) added}.
      */
     @Override
     public List<Object> getFixtures() {
@@ -98,8 +102,8 @@ public abstract class AbstractFixture ex
     // ///////////////////////////////////////////////////////////////
 
     /**
-     * Will print warning message and do nothing if {@link FixtureClock} could not be {@link FixtureClock#initialize()
-     * initialized}.
+     * Will print warning message and do nothing if {@link FixtureClock} could
+     * not be {@link FixtureClock#initialize() initialized}.
      */
     public void earlierDate(final int years, final int months, final int days) {
         if (shouldIgnoreCallBecauseNoClockSetup("earlierDate()")) {
@@ -109,8 +113,8 @@ public abstract class AbstractFixture ex
     }
 
     /**
-     * Will print warning message and do nothing if {@link FixtureClock} could not be {@link FixtureClock#initialize()
-     * initialized}.
+     * Will print warning message and do nothing if {@link FixtureClock} could
+     * not be {@link FixtureClock#initialize() initialized}.
      */
     public void earlierTime(final int hours, final int minutes) {
         if (shouldIgnoreCallBecauseNoClockSetup("earlierTime()")) {
@@ -120,8 +124,8 @@ public abstract class AbstractFixture ex
     }
 
     /**
-     * Will print warning message and do nothing if {@link FixtureClock} could not be {@link FixtureClock#initialize()
-     * initialized}.
+     * Will print warning message and do nothing if {@link FixtureClock} could
+     * not be {@link FixtureClock#initialize() initialized}.
      */
     public void laterDate(final int years, final int months, final int days) {
         if (shouldIgnoreCallBecauseNoClockSetup("laterDate()")) {
@@ -131,8 +135,8 @@ public abstract class AbstractFixture ex
     }
 
     /**
-     * Will print warning message and do nothing if {@link FixtureClock} could not be {@link FixtureClock#initialize()
-     * initialized}.
+     * Will print warning message and do nothing if {@link FixtureClock} could
+     * not be {@link FixtureClock#initialize() initialized}.
      */
     public void laterTime(final int hours, final int minutes) {
         if (shouldIgnoreCallBecauseNoClockSetup("laterTime()")) {

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/fixtures/BaseFixture.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/fixtures/BaseFixture.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/fixtures/BaseFixture.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/fixtures/BaseFixture.java Sat Jan 21 18:30:32 2012
@@ -54,8 +54,8 @@ abstract class BaseFixture extends Abstr
     // /////////////////////////////////////////////////
 
     /**
-     * Will print warning message and do nothing if {@link FixtureClock} could not be {@link FixtureClock#initialize()
-     * initialized}.
+     * Will print warning message and do nothing if {@link FixtureClock} could
+     * not be {@link FixtureClock#initialize() initialized}.
      */
     public void setDate(final int year, final int month, final int day) {
         if (shouldIgnoreCallBecauseNoClockSetup("setDate()")) {
@@ -65,8 +65,8 @@ abstract class BaseFixture extends Abstr
     }
 
     /**
-     * Will print warning message and do nothing if {@link FixtureClock} could not be {@link FixtureClock#initialize()
-     * initialized}.
+     * Will print warning message and do nothing if {@link FixtureClock} could
+     * not be {@link FixtureClock#initialize() initialized}.
      */
     public void setTime(final int hour, final int minute) {
         if (shouldIgnoreCallBecauseNoClockSetup("setTime()")) {
@@ -79,15 +79,16 @@ abstract class BaseFixture extends Abstr
      * The {@link Clock} singleton, downcast to {@link FixtureClock}.
      * 
      * <p>
-     * Will return <tt>null</tt> if {@link FixtureClock} could not be {@link FixtureClock#initialize() initialized}.
+     * Will return <tt>null</tt> if {@link FixtureClock} could not be
+     * {@link FixtureClock#initialize() initialized}.
      */
     public FixtureClock getFixtureClock() {
         return clock;
     }
 
     /**
-     * Will print warning message and do nothing if {@link FixtureClock} could not be {@link FixtureClock#initialize()
-     * initialized}.
+     * Will print warning message and do nothing if {@link FixtureClock} could
+     * not be {@link FixtureClock#initialize() initialized}.
      */
     public void resetClock() {
         if (shouldIgnoreCallBecauseNoClockSetup("resetClock()")) {

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/fixtures/DateFixture.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/fixtures/DateFixture.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/fixtures/DateFixture.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/fixtures/DateFixture.java Sat Jan 21 18:30:32 2012
@@ -20,15 +20,18 @@
 package org.apache.isis.applib.fixtures;
 
 /**
- * Sole purpose is to set the date/time while object fixtures are being installed.
+ * Sole purpose is to set the date/time while object fixtures are being
+ * installed.
  * 
  * <p>
- * An alternative is to change the date using {@link AbstractFixture#setDate(int, int, int)} and
+ * An alternative is to change the date using
+ * {@link AbstractFixture#setDate(int, int, int)} and
  * {@link AbstractFixture#setTime(int, int)}.
  * 
  * <p>
- * Note that the last date set <i>will</i> remain in force for the application itself. To revert to the current time,
- * have a fixture at the end call {@link #resetClock()}.
+ * Note that the last date set <i>will</i> remain in force for the application
+ * itself. To revert to the current time, have a fixture at the end call
+ * {@link #resetClock()}.
  * 
  * @see SwitchUserFixture
  */

Modified: incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/fixtures/FixtureClock.java
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/fixtures/FixtureClock.java?rev=1234388&r1=1234387&r2=1234388&view=diff
==============================================================================
--- incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/fixtures/FixtureClock.java (original)
+++ incubator/isis/trunk/framework/applib/src/main/java/org/apache/isis/applib/fixtures/FixtureClock.java Sat Jan 21 18:30:32 2012
@@ -31,9 +31,10 @@ import org.apache.isis.applib.clock.Cloc
  * If not set it will provide the time provided by the system clock.
  * 
  * <p>
- * Note that - by design - it does not provide any mechanism to advance the time (eg automatic ticking of the clock).
- * That is, the time returned is always explicitly under the control of the programmer (it can be moved forward or back
- * as required).
+ * Note that - by design - it does not provide any mechanism to advance the time
+ * (eg automatic ticking of the clock). That is, the time returned is always
+ * explicitly under the control of the programmer (it can be moved forward or
+ * back as required).
  */
 public class FixtureClock extends Clock {
     private static final TimeZone UTC_TIME_ZONE;
@@ -47,17 +48,20 @@ public class FixtureClock extends Clock 
     }
 
     /**
-     * Configures the system to use a FixtureClock rather than the in-built system clock. Can be called multiple times.
+     * Configures the system to use a FixtureClock rather than the in-built
+     * system clock. Can be called multiple times.
      * 
      * <p>
      * Must call before any other call to {@link Clock#getInstance()}.
      * 
      * @throws IllegalStateException
-     *             if Clock singleton already initialized with some other implementation.
+     *             if Clock singleton already initialized with some other
+     *             implementation.
      */
     public synchronized static FixtureClock initialize() {
         if (!isInitialized() || !(getInstance() instanceof FixtureClock)) {
-            // installs the FixtureClock as the Clock singleton via the Clock's constructor
+            // installs the FixtureClock as the Clock singleton via the Clock's
+            // constructor
             // if was initialized, then will replace.
             // (if non-replaceable, then superclass will throw exception for us.
             new FixtureClock();
@@ -91,8 +95,8 @@ public class FixtureClock extends Clock 
      * Access via {@link Clock#getTime()}.
      * 
      * <p>
-     * Will just return the system time until {@link #setDate(int, int, int)} or {@link #setTime(int, int)} (or one of
-     * the overloads) has been called.
+     * Will just return the system time until {@link #setDate(int, int, int)} or
+     * {@link #setTime(int, int)} (or one of the overloads) has been called.
      */
     @Override
     protected long time() {
@@ -110,8 +114,9 @@ public class FixtureClock extends Clock 
      * Sets the clock to epoch, that is midnight, 1 Jan 1970 UTC.
      * 
      * <p>
-     * This is typically called before either {@link #setDate(int, int, int)} (so that time is set to midnight) and/or
-     * {@link #setTime(int, int)} (so that date is set to a well known value).
+     * This is typically called before either {@link #setDate(int, int, int)}
+     * (so that time is set to midnight) and/or {@link #setTime(int, int)} (so
+     * that date is set to a well known value).
      */
     public void clear() {
         setupCalendarIfRequired();
@@ -119,8 +124,8 @@ public class FixtureClock extends Clock 
     }
 
     /**
-     * Sets the hours and minutes as specified, and sets the seconds and milliseconds to zero, but the date portion is
-     * left unchanged.
+     * Sets the hours and minutes as specified, and sets the seconds and
+     * milliseconds to zero, but the date portion is left unchanged.
      * 
      * @see #setDate(int, int, int)
      * @see #addTime(int, int)
@@ -150,7 +155,8 @@ public class FixtureClock extends Clock 
      * Adjusts the time by the specified number of hours and minutes.
      * 
      * <p>
-     * Typically called after {@link #setTime(int, int)}, to move the clock forward or perhaps back.
+     * Typically called after {@link #setTime(int, int)}, to move the clock
+     * forward or perhaps back.
      * 
      * @see #addDate(int, int, int)
      */
@@ -164,7 +170,8 @@ public class FixtureClock extends Clock 
      * Adjusts the time by the specified number of years, months or days.
      * 
      * <p>
-     * Typically called after {@link #setDate(int, int, int)}, to move the clock forward or perhaps back.
+     * Typically called after {@link #setDate(int, int, int)}, to move the clock
+     * forward or perhaps back.
      * 
      * @see #addTime(int, int)
      */



Mime
View raw message