- All Known Subinterfaces:
- All Known Implementing Classes:
public interface Cloneable<S>
default S Clone()This method creates a new instance of the same
Class, specified by
, of the instance on which this method is called. Whatever initializations required to create a functional new instance are performed.
However, this method does NOT create a copy of the current instance. (A common mistake is to confuse cloning with copying: cloning creates a duplicate with only equal initial state while copying creates a duplicate with equal full state. Example: a clone of an adult would not be an identical adult, but just an embryo with equal DNA. A state-wise identical adult would be a copy, not a clone.)
This method is effectively a constructor called on an existing instance. The use case of such a method is to eliminate the need to redundantly pass a second instance or constructor if a clone of an instance is needed.
To indicate the constructor-like character of this method, the pattern of starting the name with a capital letter is applied to this method (and to workaround the botch-job protected method the moronic JDK developers hardcoded in Object.)
- a clone of this instance.