Databases
StackOverflow2013
Postsdbo
POWhere to place an assert statement for a collection member property value : at the start of a method or just before using it?
 

Note that there are some explanatory texts on larger screens.

plurals
  1. POWhere to place an assert statement for a collection member property value : at the start of a method or just before using it?
    primarykey
    data
    text
    <p>Consider a class Device as follows. Consider a method filterByType that accepts a collection of Devices as input parameter and returns devices of the specified type:</p> <pre><code>class Device { String barcode; String name; String type; // values like 'Laptop', 'Desktop', 'Tablet' etc. // other methods . . . } </code></pre> <p>class DeviceManager {</p> <pre><code>/** * @param devices is a list of Device type objects * @param requiredType filter */ List&lt;Device&gt; filterByType(List&lt;Device&gt; devices, String requiredType) { // Assert that the input list is neither null or empty // Assert that the requiredType parameter is valid // Do I assert type member here? i.e. Iterate through all collection members to check that type member is non-empty . // Filter based on type member value . . // throw an exception if type is empty } . . </code></pre> <p>}</p> <p>Queries:</p> <ol> <li><p>Do we add an assertion at the start of the method itself that each instance has the required info OR Is it better to start filtering while iterating through the collection and throw an exception if type is indeed empty</p></li> <li><p>Is it good practice to add a note in method level javadoc that Device 'type' member must be provided (i.e. as non-empty) or is this providing too much of (internal) implementation details</p></li> </ol>
    singulars
    1. PO
      singulars
      1. PTAnswer
    1. This table or related slice is empty.
    1. PTQuestion
    1. USTrey Jonn
    1. USTrey Jonn
    plurals
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. PO
      singulars
      1. PTAnswer
    1. This table or related slice is empty.
    1. This table or related slice is empty.
 

Querying!

 
Guidance
A row detail

Detail views are divided into sections. All the information in the data section comes from columns in the selected row. The other sections display data from other, related rows.

Related data can be related in a to-one or a to-many fashion. Captions of data related in a to-many fashion link to a list view showing a filtered view of the table.

Try moving around until you find a non-empty to-many entry and click on the label to get to one. You can move back to the root by clicking on the database name in the header.

SQuiL has stopped working due to an internal error.

If you are curious you may find further information in the browser console, which is accessible through the devtools (F12).

Reload