/**
 * The MIT License
 * Copyright (c) 2014 Ilkka Seppälä
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 */
package com.iluwatar.singleton;

import java.io.Serializable;

/**
 * The Initialize-on-demand-holder idiom is a secure way of creating lazy initialized singleton
 * object in Java. refer to "The CERT Oracle Secure Coding Standard for Java" By Dhruv Mohindra,
 * Robert C. Seacord p.378
 * <p/>
 * Singleton objects usually are heavy to create and sometimes need to serialize them. This class
 * also shows how to preserve singleton in serialized version of singleton.
 *
 * @author mortezaadi@gmail.com
 */
public final class InitializingOnDemandHolderIdiom implements Serializable {

  private static final long serialVersionUID = 1L;

  private InitializingOnDemandHolderIdiom() {}

  public static InitializingOnDemandHolderIdiom getInstance() {
    return HelperHolder.INSTANCE;
  }

  protected Object readResolve() {
    return getInstance();
  }

  private static class HelperHolder {
    public static final InitializingOnDemandHolderIdiom INSTANCE =
        new InitializingOnDemandHolderIdiom();
  }

}

@@ -1168,38 +1168,8 @@
 n;%0A%0A
-import java.io.Serializable;%0A%0A
 /**%0A
@@ -1237,16 +1237,18 @@
 reating 
+a 
 lazy ini
@@ -1288,464 +1288,633 @@
 ava.
- refer to %22The CERT Oracle Secure Coding Standard for Java%22 By Dhruv Mohindra,%0A * Robert C. Seacord p.378
+%0A * %3Cp%3E%0A * The technique is is as lazy as possible and works in all known versions of Java. It takes advantage%0A * of language guarantees about class initialization, and will therefore work correctly in all%0A * Java-compliant compilers and virtual machines.
 %0A * %3Cp
-/
 %3E%0A * 
-Singleton objects usually are heavy to create and sometimes need to serialize them. This class%0A * also shows how to preserve singleton in serialized version of singleton.%0A *%0A * @author mortezaadi@gmail.com%0A */%0Apublic final class InitializingOnDemandHolderIdiom implements Serializable %7B%0A%0A  private static final long serialVersionUID = 1L;%0A
+The inner class is referenced no earlier (and therefore loaded no earlier by the class loader) than%0A * the moment that getInstance() is called. Thus, this solution is thread-safe without requiring special%0A * language constructs (i.e. volatile or synchronized).%0A *%0A */%0Apublic final class InitializingOnDemandHolderIdiom %7B%0A%0A  /**%0A   * Private constructor.%0A   */
 %0A  p
@@ -1958,16 +1958,60 @@
 m() %7B%7D%0A%0A
+  /**%0A   * @return Singleton instance%0A   */%0A
   public
@@ -2111,71 +2111,67 @@
 %0A%0A  
-protected Object readResolve() %7B%0A    return getInstance();%0A  %7D%0A
+/**%0A   * Provides the lazy-loaded Singleton instance.%0A   */
 %0A  p
@@ -2323,11 +2323,10 @@
 ();%0A  %7D%0A
-%0A
 %7D%0A

Improve Singleton holder example