78 lines
2.4 KiB
Plaintext
78 lines
2.4 KiB
Plaintext
Before records appeared in Java 16, there was a common way to represent getters for private fields of a class: a method named "get" with a capitalized field name. For example, for a ``++String++`` field named "myField" the signature of the getter method will be: ``++public String getMyField()++``
|
||
|
||
|
||
In records, getters are named differently. Getters created by default do not contain the "get" prefix. So for a record's ``++String++`` field "myField" the getter method will be: ``++public String myField()++``
|
||
|
||
|
||
This means that if you want to override the default getter behavior it is better to use the method provided by records instead of creating a new one. Otherwise, this will bring confusion to the users of the record as two getters will be available and even leads to bugs if the behavior is different from the default one.
|
||
|
||
|
||
This rule raises an issue when a record contains a getter named "get" with a capitalized field name that is not behaving the same as the default one.
|
||
|
||
|
||
== Noncompliant Code Example
|
||
|
||
[source,java]
|
||
----
|
||
record Person(String name, int age) {
|
||
public String getName() { // Noncompliant
|
||
return name.toUpperCase(Locale.ROOT);
|
||
}
|
||
}
|
||
----
|
||
|
||
|
||
== Compliant Solution
|
||
|
||
[source,java]
|
||
----
|
||
record Person(String name, int age) {
|
||
@Override
|
||
public String name() { // Compliant
|
||
return name.toUpperCase(Locale.ROOT);
|
||
}
|
||
}
|
||
|
||
record Person(String name, int age) {
|
||
public String getNameUpperCase() { // Compliant
|
||
return name.toUpperCase(Locale.ROOT);
|
||
}
|
||
}
|
||
record Person(String name, int age) {
|
||
public String getName() { // Compliant, is equivalent to 'name()'
|
||
return name;
|
||
}
|
||
}
|
||
record Person(String name, int age) {
|
||
@Override
|
||
public String name() { // Compliant
|
||
return name.toUpperCase(Locale.ROOT);
|
||
}
|
||
public String getName() { // Compliant, equal to 'name()'
|
||
return name.toUpperCase(Locale.ROOT);
|
||
}
|
||
}
|
||
----
|
||
|
||
|
||
== Exceptions
|
||
|
||
If the implementations of ``++getMyField()++`` and ``++myField()++`` methods are equivalent, the issue should not be raised as this was probably done to support compatibility with the previous convention.
|
||
|
||
|
||
== See
|
||
|
||
* https://docs.oracle.com/javase/specs/jls/se16/html/jls-8.html#jls-8.10[Records specification]
|
||
|
||
ifdef::env-github,rspecator-view[]
|
||
|
||
'''
|
||
== Implementation Specification
|
||
(visible only on this page)
|
||
|
||
include::message.adoc[]
|
||
|
||
include::highlighting.adoc[]
|
||
|
||
endif::env-github,rspecator-view[]
|