Implementing the Cloneable Interface

protected native Object clone() throws CloneNotSupportedException

Not all objects are cloneable. It particular only instances of classes that implement the Cloneable interface can be cloned. Trying to clone an object that does not implement the Cloneable interface throws a CloneNotSupportedException.

For example, to make the Car class cloneable, you simply declare that it implements the Cloneable interface. Since this is only a marker interface, you do not need to add any methods to the class.

public class Car extends MotorVehicle implements Cloneable {

  // ...

}

Car c1 = new Car("New York A12 345", 150.0);
Car c2 = c1.clone();

Most classes in the class library do not implement Cloneable so their instances are not cloneable.

Most of the time, clones are shallow copies. In other words if the object being cloned contains a reference to another object A, then the clone contains a reference to the same object A, not to a clone of A. If this isn't the behavior you want, you can override clone() yourself.

You may also override clone() if you want to make a subclass uncloneable, when one of its superclasses does implement Cloneable. In this case simply use a clone() method that throws a CloneNotSupportedException. For example,

  public Object clone() throws CloneNotSupportedException {
    throw new CloneNotSupportedException("Can't clone a SlowCar");
    // never get here
    return this;
  }

  public Object clone() throws CloneNotSupportedException {
    return super.clone();
  }