According to the The Java Language Specification \[[JLS 2005|AA. Bibliography#JLS 05]\], Section 12, §12.5, "Creation of New Class Instances," [JLS 2015]: Wiki Markup
Unlike C++, the Java programming language does not specify altered rules for method dispatch during the creation of a new class instance. If methods are invoked that are overridden in subclasses in the object being initialized, then these overriding methods are used, even before the new object is completely initialized.
Consequently, invocation Invocation of an overridable method during object construction may result in the use of uninitialized data, leading to runtime exceptions or to unanticipated outcomes. Calling overridable methods from constructors can also leak the this
reference before object construction is complete, potentially exposing uninitialized or inconsistent data to other threads . See rule (see TSM01-J. Do not let the ( this ) reference escape during object construction for additional information). As a result, constructors may invoke a class's constructor must invoke (directly or indirectly) only methods in that class that are static, final or private; all other method invocations are forbidden.
Noncompliant Code Example
This noncompliant code example results in the use of uninitialized data by the doLogic()
method.:
Code Block | ||
---|---|---|
| ||
class SuperClass { public SuperClass () { doLogic(); } public void doLogic() { System.out.println("This is superclass!"); } } class SubClass extends SuperClass { private String color = null; public SubClass() { super(); color = "Redred"; } public void doLogic() { // Color becomes null System.out.println("This is subclass! The color is :" + color); // ... } } public class Overridable { public static void main(String[] args) { SuperClass bc = new SuperClass(); // Prints "This is superclass!" SuperClass sc = new SubClass(); // Prints "This is subclass! The color is :null" } } |
...
This compliant solution declares the doLogic()
method as final so that it cannot be overridden.:
Code Block | ||
---|---|---|
| ||
class SuperClass {
public SuperClass() {
doLogic();
}
public final void doLogic() {
System.out.println("This is superclass!");
}
}
|
...
Allowing a constructor to call overridable methods may give can provide an attacker with access to the this
reference before an object is fully initialized, which in turn could lead to a vulnerability.
Rule | Severity | Likelihood | Remediation Cost | Priority | Level |
---|
MET05-J |
Medium |
Probable |
Medium | P8 | L2 |
Automated Detection
Automated detection of constructors that contain invocations of overridable methods appears to be is straightforward.
Tool |
---|
Related Vulnerabilities
Search for vulnerabilities resulting from the violation of this rule on the CERT website.
Bibliography
Version | Checker | Description | |||||||
---|---|---|---|---|---|---|---|---|---|
PVS-Studio |
| V6052 | |||||||
SonarQube |
| S1699 | Constructors should only call non-overridable methods | ||||||
SpotBugs |
| MC_OVERRIDABLE_METHOD_CALL_IN_CONSTRUCTOR | Implemented (since 4.5.0) |
Related Guidelines
Inheritance [RIP] | |
Guideline 7-4 / OBJECT-4: Prevent constructors from calling methods that can be overridden |
Bibliography
[ESA 2005] | Rule 62, Do not call nonfinal methods from within a constructor |
[JLS 2015] | Chapter 8, "Classes" |
Rule 81, |
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="a5be2b5d-56cb-4944-a7b6-8800a5bbe794"><ac:plain-text-body><![CDATA[
[[ESA 2005
AA. Bibliography#ESA 05]]
Rule 62: Do not call non-final methods from within a constructor
]]></ac:plain-text-body></ac:structured-macro>
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="fc58cd66-c35b-4532-9b8e-0068be3f1c7f"><ac:plain-text-body><![CDATA[
[[JLS 2005
AA. Bibliography#JLS 05]]
[Chapter 8, Classes
http://java.sun.com/docs/books/jls/third_edition/html/classes.html], 12.5 "Creation of New Class Instances"
]]></ac:plain-text-body></ac:structured-macro>
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="a92576fa-7873-42fd-a9f5-a70765a1c478"><ac:plain-text-body><![CDATA[
[[Rogue 2000
AA. Bibliography#Rogue 00]] Rule 81:
Do not call non-final methods from within a constructor |
]]></ac:plain-text-body></ac:structured-macro>
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="45757156-1b46-484c-bb0b-8acd52992791"><ac:plain-text-body><![CDATA[
[[SCG 2007
AA. Bibliography#SCG 07]]
Guideline 4-3, Prevent constructors from calling methods that can be overridden
]]></ac:plain-text-body></ac:structured-macro>
...