Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Due to these reasons, checking the condition after wait is called is indispensable.

Noncompliant Code Example

This noncompliant example invokes the wait method inside a traditional if block and fails to check the post condition after the (accidental or malicious) notification is received. This means that the thread can waken when it is not supposed to.

Code Block
bgColor#FFcccc
synchronized(object) {
  if(<condition does not hold>)
    object.wait();
  //proceed when condition holds
}

Compliant Solution

The compliant solution encloses the wait method in a while loop and as a result checks the condition during both pre and post wait invocation times.

Code Block
bgColor#ccccff
//condition predicate is guarded by a lock on the shared object/variable
synchronized (object) {
  while (<condition does not hold>) {
    object.wait(); 
  }

  //proceed when condition holds
}

Risk Assessment

To guarantee liveness and safety, the {[wait()}} method should always be called inside a while loop.

Rule

Severity

Likelihood

Remediation Cost

Priority

Level

CON31-J

low

unlikely

medium

P??

L??

Automated Detection

TODO

Related Vulnerabilities

Search for vulnerabilities resulting from the violation of this rule on the CERT website.

References

Wiki Markup
\[[Bloch 01|AA. Java References#Bloch 01]\] Item 50: Never invoke wait outside a loop
\[[Lea 00|AA. Java References#Lea 00]\] 3.2.2 Monitor Mechanics, 1.3.2 Liveness
\[[Goetz 06|AA. Java References#Goetz 06]\] Section 14.2, Using Condition Queues
\[[API 06|AA. Java References#API 06]\] [Object|http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html]