001    package org.apache.ojb.broker.core.proxy;
002    
003    /* Copyright 2002-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    import org.apache.ojb.broker.Identity;
019    
020    
021    /**
022     * This is a callback interface that allows interaction with the
023     * Materialization process of the IndirectionHandler
024     * The ODMG TransactionImpl implements this interface to
025     * provide a delayed registration mechanism for proxies.
026     * @author Thomas Mahler
027     * @version $Id: MaterializationListener.java,v 1.1 2007-08-24 22:17:32 ewestfal Exp $
028     */
029    public interface MaterializationListener
030    {
031        /**
032         *  this callback is invoked before an Object is materialized
033         *  within an IndirectionHandler.
034         *  @param handler the invoking handler
035         *  @param oid the identity of the object to be materialized
036         */
037        public abstract void beforeMaterialization(IndirectionHandler handler, Identity oid);
038    
039        /**
040         *  this callback is invoked after an Object is materialized
041         *  within an IndirectionHandler.
042         *  @param handler the invoking handler
043         *  @param materializedObject the materialized Object
044         */
045        public abstract void afterMaterialization(IndirectionHandler handler, Object materializedObject);
046    }