001    package org.apache.ojb.otm.states;
002    
003    /* Copyright 2003-2005 The Apache Software Foundation
004     *
005     * Licensed under the Apache License, Version 2.0 (the "License");
006     * you may not use this file except in compliance with the License.
007     * You may obtain a copy of the License at
008     *
009     *     http://www.apache.org/licenses/LICENSE-2.0
010     *
011     * Unless required by applicable law or agreed to in writing, software
012     * distributed under the License is distributed on an "AS IS" BASIS,
013     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
014     * See the License for the specific language governing permissions and
015     * limitations under the License.
016     */
017    
018    /**
019     * this state represents new objects which must be created during tx
020     * (ODMG StateNewDirty).
021     */
022    public class PersistentNew extends State
023    {
024    
025        PersistentNew()
026        {
027        }
028    
029        /**
030         * return a String representation
031         */
032        public String toString()
033        {
034            return "Persistent-new";
035        }
036    
037        //-------------- State transitions --------------------
038    
039        /**
040         * Describes the state transition when user modifies object
041         */
042        public State markDirty()
043                throws IllegalObjectStateException
044        {
045            return this;
046        }
047    
048        /**
049         * Describes the state transition on makePersistent()
050         */
051        public State makePersistent()
052                throws IllegalObjectStateException
053        {
054            return this;
055        }
056    
057        /**
058         * Describes the state transition on deletePersistent()
059         */
060        public State deletePersistent()
061                throws IllegalObjectStateException
062        {
063            return State.PERSISTENT_NEW_DELETED;
064        }
065    
066        /**
067         * Describes the state transition on commit()
068         */
069        public State commit()
070                throws IllegalObjectStateException
071        {
072            return State.HOLLOW;
073        }
074    
075        /**
076         * Describes the state transition on rollback()
077         */
078        public State rollback()
079                throws IllegalObjectStateException
080        {
081            return State.TRANSIENT;
082        }
083    
084    
085        //-------------- State semantics --------------------
086    
087        /**
088         * object is new, thus we need an INSERT to store it
089         */
090        public boolean needsInsert()
091        {
092            return true;
093        }
094    
095    }