objectcontainer.java

用Java写的面相对象的数据库管理系统

// You can redistribute this software and/or modify it under the terms of
// the Ozone Core License version 1 published by ozone-db.org.
//
// The original code and portions created by SMB are
// Copyright (C) 1997-2000 by SMB GmbH. All rights reserved.
//
// $Id: ObjectContainer.java,v 1.12 2000/10/28 16:55:16 daniela Exp $

package org.ozoneDB.core;

import java.io.*;
import java.util.*;
import org.ozoneDB.DxLib.*;
import org.ozoneDB.*;
import org.ozoneDB.core.dr.*;


/**
 * Together with the {@link Store} interface this is part of the Store back-end
 * API.<p>
 * 
 * An ObjectContainer wraps a target (database) object and decorates it with
 * functionality needed by the database system, such as the corresponding object
 * ID. Also, the ObjectContainer is the delegate for the methods defined by
 * {@link OzoneCompatible}.
 * 
 * 
 * @author <a href="http://www.softwarebuero.de/">SMB</a>
 * @version $Revision: 1.12 $Date: 2000/10/28 16:55:16 $
 */
public interface ObjectContainer extends Lockable {
    
    public final static String PROXYNAME_POSTFIX = "_Proxy";
    public final static String IMPLNAME_POSTFIX = "_Impl";
    
    // possible return values of the state() method
    public final static int STATE_CLEAN = 0;
    public final static int STATE_READ = 1;
    public final static int STATE_MODIFIED = 2;
    public final static int STATE_CREATED = 4;
    public final static int STATE_DELETED = 8;
    
    /**
     * Return the current state of the container. Possible return values are the
     * STATE constants defined in this class. A container can only be in one of
     * these states at one time. The state of a container can only be raised
     * during one transaction. So, if a container is created (STATE_CREATED)
     * during a transaction, the state can become STATE_DELETED only.
     * 
     * 
     * @return The state of the container.
     */
    public int state();
    
    
    /**
     * Returns the time when the container was last commited with lock level
     * greater than {@link LEVEL_READ}. The value returned by this method should
     * only be compared against return values of this method.
     */
    public long modTime();
    
    
    public Lock lock();
    
    
    public void touch();
    
    
    public void setName( String _name );
    
    
    public String name();
    
    
    public void setTarget( OzoneCompatible _target );
    
    
    public OzoneCompatible target();
    
    
    public Class targetClass();
    
    
    public void createTarget( Env env, Class cl, String sig, Object[] args ) throws Exception;
    
    
    public Object invokeTarget( Env env, String methodName, String sig, Object[] args ) throws Exception;
    
    
    public Object invokeTarget( Env env, int methodIndex, Object[] args ) throws Exception;
    
    
    public void deleteTarget();
    
    
    public void nameTarget( String _name );
    
    
    public OzoneCompatible targetClone() throws Exception;
    
    
    /**
     * @return True if obj and receiver point to the same target object.
     */
    public boolean equals( Object obj );
    
    
    /**
     * Return a proxy for the receiver.
     * @return Proxy for this object.
     */
    public OzoneProxy ozoneProxy();
    
    
    public ObjectID id();
    
    
    public OzoneInterface database();
    
    
    public Permissions permissions();
    
}