duke@1: /*
ohair@798:  * Copyright (c) 2001, 2010, Oracle and/or its affiliates. All rights reserved.
duke@1:  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
duke@1:  *
duke@1:  * This code is free software; you can redistribute it and/or modify it
duke@1:  * under the terms of the GNU General Public License version 2 only, as
duke@1:  * published by the Free Software Foundation.
duke@1:  *
duke@1:  * This code is distributed in the hope that it will be useful, but WITHOUT
duke@1:  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
duke@1:  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
duke@1:  * version 2 for more details (a copy is included in the LICENSE file that
duke@1:  * accompanied this code).
duke@1:  *
duke@1:  * You should have received a copy of the GNU General Public License version
duke@1:  * 2 along with this work; if not, write to the Free Software Foundation,
duke@1:  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
duke@1:  *
ohair@554:  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
ohair@554:  * or visit www.oracle.com if you need additional information or have any
ohair@554:  * questions.
duke@1:  */
duke@1: 
duke@1: import java.lang.*;
duke@1: import java.io.*;
duke@1: 
duke@1: /*
duke@1:  * @test
duke@1:  * @bug 4341304 4485668 4966728
duke@1:  * @summary Test that methods readResolve and writeReplace show
duke@1:  * up in serialized-form.html the same way that readObject and writeObject do.
duke@1:  * If the doclet includes readResolve and writeReplace in the serialized-form
duke@1:  * documentation that same way the it includes readObject and writeObject, the
duke@1:  * test passes.  This also tests that throws tag information is correctly shown
duke@1:  * in the serialized form page.
duke@1:  * Make sure see tags work in serialized form.
duke@1:  * @author jamieh
duke@1:  * @library ../lib/
duke@1:  * @build JavadocTester
duke@1:  * @build TestSerializedForm
duke@1:  * @run main TestSerializedForm
duke@1:  */
duke@1: 
duke@1: public class TestSerializedForm extends JavadocTester implements Serializable {
duke@1: 
duke@1:     private static final String BUG_ID = "4341304-4485668-4966728";
duke@1: 
duke@1:     private static final String[][] TEST = {
duke@1:         {BUG_ID + FS + "serialized-form.html",
bpatel@766:             "protected java.lang.Object readResolve()"},
duke@1:         {BUG_ID + FS + "serialized-form.html",
bpatel@766:             "protected java.lang.Object writeReplace()"},
duke@1:         {BUG_ID + FS + "serialized-form.html",
bpatel@766:             "protected java.lang.Object readObjectNoData()"},
duke@1:         {BUG_ID + FS + "serialized-form.html",
duke@1:             "See Also"},
duke@1:     };
duke@1: 
duke@1:     private static final String[][] NEGATED_TEST = NO_TEST;
duke@1:     private static final String[] ARGS = new String[] {
duke@1:         "-d", BUG_ID, "-sourcepath", SRC_DIR,
duke@1:         SRC_DIR + FS + "TestSerializedForm.java"
duke@1:     };
duke@1: 
duke@1:     /**
duke@1:      * @serial
duke@1:      * @see TestSerializedForm
duke@1:      */
duke@1:     public final int SERIALIZABLE_CONSTANT = 1;
duke@1: 
duke@1:     /**
duke@1:      * The entry point of the test.
duke@1:      * @param args the array of command line arguments.
duke@1:      */
duke@1:     public static void main(String[] args) {
duke@1:         TestSerializedForm tester = new TestSerializedForm();
duke@1:         int actualExitCode = run(tester, ARGS, TEST, NEGATED_TEST);
duke@1:         tester.printSummary();
duke@1:     }
duke@1: 
duke@1:     /**
duke@1:      * {@inheritDoc}
duke@1:      */
duke@1:     public String getBugId() {
duke@1:         return BUG_ID;
duke@1:     }
duke@1: 
duke@1:     /**
duke@1:      * {@inheritDoc}
duke@1:      */
duke@1:     public String getBugName() {
duke@1:         return getClass().getName();
duke@1:     }
duke@1: 
duke@1:     /**
duke@1:      * @throws IOException when there is an I/O error.
duke@1:      * @serial
duke@1:      */
duke@1:     private void readObject(ObjectInputStream s) {}
duke@1: 
duke@1:     /**
duke@1:      * @throws IOException when there is an I/O error.
duke@1:      * @serial
duke@1:      */
duke@1:     private void writeObject(ObjectOutputStream s) {}
duke@1: 
duke@1:     /**
duke@1:      * @throws IOException when there is an I/O error.
duke@1:      * @serialData This is a serial data comment.
duke@1:      */
duke@1:     protected Object readResolve(){return null;}
duke@1: 
duke@1:     /**
duke@1:      * @throws IOException when there is an I/O error.
duke@1:      * @serialData This is a serial data comment.
duke@1:      */
duke@1:     protected Object writeReplace(){return null;}
duke@1: 
duke@1:     /**
duke@1:      * @throws IOException when there is an I/O error.
duke@1:      * @serialData This is a serial data comment.
duke@1:      */
duke@1:     protected Object readObjectNoData() {
duke@1:         return null;
duke@1:     }
duke@1: 
duke@1: }