api20/test/java/javax/jdo/JDOHelperTest.java

/*
 * Copyright 2005 The Apache Software Foundation.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at 
 * 
 *     http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software 
 * distributed under the License is distributed on an "AS IS" BASIS, 
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
 * See the License for the specific language governing permissions and 
 * limitations under the License.
 */

package javax.jdo;

import java.io.File;
import java.io.InputStream;

import java.util.HashMap;
import java.util.Map;
import java.util.Properties;

import javax.jdo.pc.PCPoint;
import javax.jdo.util.AbstractTest;
import javax.jdo.util.BatchTestRunner;

import javax.naming.Context;
import javax.naming.InitialContext;
import javax.naming.NamingException;

/**
 * Tests class javax.jdo.JDOHelper.
 * <p>
 * TBD: implementation of testMakeDirty, 
 * TBD: testing interrogative methods for persistent instances
 * TBD: getPMF for valid PMF class
 */
public class JDOHelperTest extends AbstractTest {
    
    /** */
    public static void main(String args[]) {
        BatchTestRunner.run(JDOHelperTest.class);
    }

    /** */
    public void testGetPM() {
        PCPoint p = new PCPoint(1, new Integer(1));
        if (JDOHelper.getPersistenceManager(p) != null) {
            fail("JDOHelper.getPersistenceManager should return null pm for non-persistent instance");
        }

        // TBD: test for persistent instance
    }

    /** */
    public void testMakeDirty() {
        // TBD: test JDOHelper.makeDirty(pc, fieldName);
    }

    /** */
    public void testGetObjectId() {
        PCPoint p = new PCPoint(1, new Integer(1));
        if (JDOHelper.getObjectId(p) != null) {
            fail("JDOHelper.getObjectId should return null ObjectId for non-persistent instance");
        }

        // TBD test JDOHelper.getObjectId(pc) for persistent instance
    }

    /** */
    public void testGetTransactionObjectId() {
        PCPoint p = new PCPoint(1, new Integer(1));
        if (JDOHelper.getObjectId(p) != null) {
            fail("JDOHelper.getTransactionalObjectId should return null ObjectId for non-persistent instance");
        }

        // TBD test JDOHelper.getTransactionalObjectId(pc) for persistent instance
    }

    /** */
    public void testIsDirty() {
        PCPoint p = new PCPoint(1, new Integer(1));
        if (JDOHelper.isDirty(p)) {
            fail("JDOHelper.isDirty should return false for non-persistent instance");
        }

        // TBD test JDOHelper.isDirty(pc) for persistent instance
    }

    /** */
    public void testIsTransactional() {
        PCPoint p = new PCPoint(1, new Integer(1));
        if (JDOHelper.isTransactional(p)) {
            fail("JDOHelper.isTransactional should return false for non-persistent instance");
        }

        // TBD test JDOHelper.isTransactional(pc) for persistent instance
    }

    /** */
    public void testIsPersistent() {
        PCPoint p = new PCPoint(1, new Integer(1));
        if (JDOHelper.isPersistent(p)) {
            fail("JDOHelper.isPersistent should return false for non-persistent instance");
        }

        // TBD test JDOHelper.isPersistent(pc) for persistent instance
    }

    /** */
    public void testIsNew() {
        PCPoint p = new PCPoint(1, new Integer(1));
        if (JDOHelper.isNew(p)) {
            fail("JDOHelper.isNew should return false for non-persistent instance");
        }

        // TBD test JDOHelper.isNew(pc) for persistent instance
    }


    /** */
    public void testIsDeleted() {
        PCPoint p = new PCPoint(1, new Integer(1));
        if (JDOHelper.isDeleted(p)) {
            fail("JDOHelper.isDeleted should return false for non-persistent instance");
        }

        // TBD test JDOHelper.isDeleted(pc) for persistent instance
    }
    
    /** Test null String resource with no class loader.
     */
    public void testGetPMFNullResource() {
        PersistenceManagerFactory pmf = null;
        try {
            pmf = JDOHelper.getPersistenceManagerFactory((String)null);
            fail("Null resource name should result in JDOFatalUserException");
        }
        catch (JDOFatalUserException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    /** Test null String resource with good class loader.
     */
    public void testGetPMFNullResourceGoodClassLoader() {
        PersistenceManagerFactory pmf = null;
        try {
            pmf = JDOHelper.getPersistenceManagerFactory((String)null, this.getClass().getClassLoader());
            fail("Null resource name should result in JDOFatalUserException");
        }
        catch (JDOFatalUserException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    /** Test bad String resource with no class loader.
     */
    public void testGetPMFBadResource() {
        PersistenceManagerFactory pmf = null;
        try {
            pmf = JDOHelper.getPersistenceManagerFactory("Whatever");
            fail("Null resource name should result in JDOFatalUserException");
        }
        catch (JDOFatalUserException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    /** Test null String resource with good class loader.
     */
    public void testGetPMFBadResourceGoodClassLoader() {
        PersistenceManagerFactory pmf = null;
        try {
            pmf = JDOHelper.getPersistenceManagerFactory("Whatever", this.getClass().getClassLoader());
            fail("Null resource name should result in JDOFatalUserException");
        }
        catch (JDOFatalUserException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    /** Test null File resource with no class loader.
     */
    public void testGetPMFNullFile() {
        PersistenceManagerFactory pmf = null;
        try {
            pmf = JDOHelper.getPersistenceManagerFactory((File)null);
            fail("Null file should result in JDOFatalUserException");
        }
        catch (JDOFatalUserException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    /** Test null File resource with good class loader.
     */
    public void testGetPMFNullFileGoodClassLoader() {
        PersistenceManagerFactory pmf = null;
        try {
            pmf = JDOHelper.getPersistenceManagerFactory((File)null, this.getClass().getClassLoader());
            fail("Null file should result in JDOFatalUserException");
        }
        catch (JDOFatalUserException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    /** Test bad File resource with no class loader.
     */
    public void testGetPMFBadFile() {
        PersistenceManagerFactory pmf = null;
        try {
            pmf = JDOHelper.getPersistenceManagerFactory(new File("Whatever"));
            fail("Null file should result in JDOFatalUserException");
        }
        catch (JDOFatalUserException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    /** Test bad File resource with good class loader.
     */
    public void testGetPMFBadFileGoodClassLoader() {
        PersistenceManagerFactory pmf = null;
        try {
            pmf = JDOHelper.getPersistenceManagerFactory(new File("Whatever"), this.getClass().getClassLoader());
            fail("Null file should result in JDOFatalUserException");
        }
        catch (JDOFatalUserException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    /** Test null JNDI resource name with no class loader.
     */
    public void testGetPMFNullJNDI() {
        PersistenceManagerFactory pmf = null;
        try {
            pmf = JDOHelper.getPersistenceManagerFactory((String)null, getInitialContext());
            fail("Null JNDI resource name should result in JDOFatalUserException");
        }
        catch (JDOFatalUserException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    /** Test null JNDI resource name with good class loader.
     */
    public void testGetPMFNullJNDIGoodClassLoader() {
        PersistenceManagerFactory pmf = null;
        try {
            pmf = JDOHelper.getPersistenceManagerFactory((String)null, getInitialContext(), this.getClass().getClassLoader());
            fail("Null JNDI resource name should result in JDOFatalUserException");
        }
        catch (JDOFatalUserException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    /** Test bad JNDI resource name with no class loader.
     */
    public void testGetPMFBadJNDI() {
        PersistenceManagerFactory pmf = null;
        try {
            pmf = JDOHelper.getPersistenceManagerFactory("Whatever", getInitialContext());
            fail("Bad JNDI resource name should result in JDOFatalUserException");
        }
        catch (JDOFatalUserException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    /** Test bad JNDI resource name with good class loader.
     */
    public void testGetPMFBadJNDIGoodClassLoader() {
        PersistenceManagerFactory pmf = null;
        try {
            pmf = JDOHelper.getPersistenceManagerFactory("Whatever", getInitialContext(), this.getClass().getClassLoader());
            fail("Bad JNDI resource name should result in JDOFatalUserException");
        }
        catch (JDOFatalUserException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    /** Test null stream with no class loader.
     */
    public void testGetPMFNullStream() {
        PersistenceManagerFactory pmf = null;
        try {
            pmf = JDOHelper.getPersistenceManagerFactory((InputStream)null);
            fail("Null JNDI resource name should result in JDOFatalUserException");
        }
        catch (JDOFatalUserException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    /** Test null stream with good class loader.
     */
    public void testGetPMFNullStreamGoodClassLoader() {
        PersistenceManagerFactory pmf = null;
        try {
            pmf = JDOHelper.getPersistenceManagerFactory((InputStream)null, this.getClass().getClassLoader());
            fail("Null JNDI resource name should result in JDOFatalUserException");
        }
        catch (JDOFatalUserException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    /** Test null ClassLoader.
     */
    public void testGetPMFNullClassLoader() {
        PersistenceManagerFactory pmf = null;
        try {
            pmf = JDOHelper.getPersistenceManagerFactory
                    ("Whatever", (ClassLoader)null);
            fail("Null ClassLoader should result in JDOFatalUserException");
        }
        catch (JDOFatalUserException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    /** Test both null ClassLoaders.
     */
    public void testGetPMFBothNullClassLoader() {
        PersistenceManagerFactory pmf = null;
        try {
            pmf = JDOHelper.getPersistenceManagerFactory
                    ("Whatever", (ClassLoader)null, (ClassLoader)null);
            fail("Null ClassLoader should result in JDOFatalUserException");
        }
        catch (JDOFatalUserException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    /** Test missing property javax.jdo.PersistenceManagerFactoryClass.
     */
    public void testGetPMFNoClassNameProperty() {
        PersistenceManagerFactory pmf = null;
        try {
            pmf = JDOHelper.getPersistenceManagerFactory(new Properties());
            fail("Missing property PersistenceManagerFactoryClass should result in JDOFatalUserException ");
        }
        catch (JDOFatalUserException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    /** Test bad PMF class does not exist.
     */
    public void testBadPMFClassNotFound() {
        PersistenceManagerFactory pmf = null;
        Properties props = new Properties();
        props.put("javax.jdo.PersistenceManagerFactoryClass", 
                "ThisClassDoesNotExist");
        try {
            pmf = JDOHelper.getPersistenceManagerFactory(props);
            fail("Bad PersistenceManagerFactoryClass should result in JDOFatalUserException ");
        }
        catch (JDOFatalUserException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    /** Test bad PMF class no method getPersistenceManagerFactory(Properties).
     */
    public void testBadPMFNoGetPMFPropertiesMethod() {
        PersistenceManagerFactory pmf = null;
        Properties props = new Properties();
        props.put("javax.jdo.PersistenceManagerFactoryClass", 
                "javax.jdo.JDOHelperTest$BadPMFNoGetPMFMethod");
        try {
            pmf = JDOHelper.getPersistenceManagerFactory(props);
            fail("Bad PersistenceManagerFactory should result in JDOFatalInternalException ");
        }
        catch (JDOFatalInternalException ex) {
            if (ex.getCause() instanceof NoSuchMethodException) {
                if (verbose)
                    println("Caught expected exception " + ex);
            } else {
                fail("Bad PersistenceManagerFactory should result in " +
                        "JDOFatalInternalException with nested " +
                        "NoSuchMethodException. " +
                        "Actual nested exception was " + ex);
            }
        }
    }

    /** Test bad PMF class no method getPersistenceManagerFactory(Map).
     */
    public void testBadPMFNoGetPMFMapMethod() {
        PersistenceManagerFactory pmf = null;
        Map props = new HashMap();
        props.put("javax.jdo.PersistenceManagerFactoryClass", 
                "javax.jdo.JDOHelperTest$BadPMFNoGetPMFMethod");
        try {
            pmf = JDOHelper.getPersistenceManagerFactory(props);
            fail("Bad PersistenceManagerFactory should result in JDOFatalInternalException ");
        }
        catch (JDOFatalInternalException ex) {
            if (ex.getCause() instanceof NoSuchMethodException) {
                if (verbose)
                    println("Caught expected exception " + ex);
            } else {
                fail("Bad PersistenceManagerFactory should result in " +
                        "JDOFatalInternalException with nested " +
                        "NoSuchMethodException. " +
                        "Actual nested exception was " + ex);
            }
        }
    }

    /** Test bad PMF class non-static getPMF method.
     */
    public void testBadPMFNonStaticGetPMFMethod() {
        PersistenceManagerFactory pmf = null;
        Properties props = new Properties();
        props.put("javax.jdo.PersistenceManagerFactoryClass", 
                "javax.jdo.JDOHelperTest$BadPMFNonStaticGetPMFMethod");
        try {
            pmf = JDOHelper.getPersistenceManagerFactory(props);
            fail("Bad PersistenceManagerFactoryClass should result in JDOFatalInternalException ");
        }
        catch (JDOFatalInternalException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    /** Test bad PMF class doesn't implement PMF.
     */
    public void testBadPMFWrongReturnType() {
        PersistenceManagerFactory pmf = null;
        Properties props = new Properties();
        props.put("javax.jdo.PersistenceManagerFactoryClass", 
                "javax.jdo.JDOHelperTest$BadPMFWrongReturnType");
        try {
            pmf = JDOHelper.getPersistenceManagerFactory(props);
            fail("Bad PersistenceManagerFactoryClass should result in JDOFatalInternalException ");
        }
        catch (JDOFatalInternalException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    /** Test bad PMF class getPersistenceManagerFactory throws Exception.
     */
    public void testBadPMFGetPMFMethodThrowsJDOException() {
        PersistenceManagerFactory pmf = null;
        Properties props = new Properties();
        props.put("javax.jdo.PersistenceManagerFactoryClass", 
                "javax.jdo.JDOHelperTest$BadPMFGetPMFMethodThrowsJDOException");
        try {
            pmf = JDOHelper.getPersistenceManagerFactory(props);
            fail("BadPMFGetPMFMethodThrowsJDOException.GetPersistenceManagerFactory " +
                    "should result in JDOUnsupportedOptionException. " +
                    "No exception was thrown.");
        }
        catch (JDOUnsupportedOptionException ex) {
            if (verbose)
                println("Caught expected exception " + ex);
        }
    }

    private Context getInitialContext() {
        try {
            return new InitialContext();
        } catch (NamingException ne) {
            fail("Could not get Initial Context");
            return null;
        }
    }
    
    private class BadPMFNoGetPMFMethod {
    }

    private class BadPMFNonStaticGetPMFMethod {
        public BadPMFNonStaticGetPMFMethod 
                getPersistenceManagerFactory(Map props) {
            return new BadPMFNonStaticGetPMFMethod();
        }
    }
        
    private static class BadPMFWrongReturnType {
        public static BadPMFWrongReturnType 
                getPersistenceManagerFactory(Map props) {
            return new BadPMFWrongReturnType();
        }
    }
    
    private static class BadPMFGetPMFMethodThrowsJDOException {
        public static PersistenceManagerFactory
                getPersistenceManagerFactory(Map props) {
            throw new JDOUnsupportedOptionException(
                    "GetPMF method throws JDOUnsupportedOptionException");
        }
    }
}