clone : Java Glossary
home C words local find no local find frame, full screen Google search web for topic jump to footer translate with Babelfish by Roedy Green ©1996-2008 Canadian Mind Products
Go to : punctuation 0-9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z (all)
clone
It can sometimes be faster to make a copy of an existing object than to create a new one and initialise it. The method to do this is called clone(). If you want to make objects of your class publicly cloneable, you need code like this:

You can then use it like this:

Rabbit r1 = new Rabbit();
Rabbit r2 = (Rabbit)r1.clone();
Note: To comply with Cloneable, clone() must return an Object not a Rabbit. In Java 1.5+ you can return a Rabbit using the new covariance feature.

Instead of using super.clone(), you could use new Rabbit() and copy the fields one by one to the new object and return the new object. Then you don’t have to mess with CloneNotSupportedException.

If you were happy with a protected clone, that just blindly copied the raw bits of the object, you need not redefine your own version. Usually though, you would want a public one. Note you can’t create a private or default scope clone. You can only increase the visibility when you override.

The default protected clone does a shallow copy, that is, it does not make copies of objects pointed to by the object, but it copies all fields and references in an object. If you write your own clone, you might implement a deep copy, that is, also make copies of objects pointed to, and also objects pointed to by those objects recursively. Be careful. It is easy to create a chain reaction explosion or even an endless loop with a deep copy. Clone returns an Object not the type of the thing cloned. You need to cast it back.

If you are an assembler programmer you can think of clone as implemented by a native method that allocates a block of ram the same size as the existing object, then does a byte block move to copy the object literally byte for byte, then returns a handle to that new ram. I would like to see a variant of this sort of fast object construction for copy constructors. e.g. constructors of the form:

Clever Clone

If you implemented clone in the Dog class, using protected super. clone() in the standard way, like any public method, clone() would be inherited by the Dalmatian class. And further clone of a Dalmatian object would produce a Dalmatian, not a Dog even though clone is defined in Dog.

Cloning Arrays

Learning More

Sun’s Javadoc on Arrays.deepEquals() : available:

CMP_homejump to top
CMP logo
feedback Please email your feedback for publication, errors, omissions, broken/redirected link reports
and suggestions to improve this page to Roedy Green : feedback email
made with CSS
HTML Checked!
ICRA ratings logo
mindprod.com IP:[65.110.21.43]
Your face IP:[38.103.63.16] The information on this page is for non-military use only.
You are visitor number 35,234. Military use includes use by defence contractors.
You can get a fresh copy of this page from: or possibly from your local J: drive (Java virtual drive/Mindprod website mirror)
http://mindprod.com/jgloss/clone.html J:\mindprod\jgloss\clone.html