objectpersistencyservice.java

Mandarax是一个规则引擎的纯Java实现。它支持多类型的事实和基于反映的规则

package org.mandarax.zkb;

/*
 * Copyright (C) 1999-2004 <A href="http://www-ist.massey.ac.nz/JBDietrich" target="_top">Jens Dietrich</a>
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */
 
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;

/**
 * Interface describing an object persisteny service (OPS).
 * An object persisteny service is responsible for saving objects stored in a kind of
 * map (associating object uris and objects) to a stream, and recovering the map from  
 * a stream. This is to support knowledge base storage: while knowledge base objects
 * such as rules and facts are stored in an xml file, the objects referenced are stored
 * separately as one big map. This is to benefit from existing technologies like
 * serialization.
 * <br>
 * The interface is similar to an JNDI context - most implementations will work with 
 * maps associating names and serialized object references. 
 * @author <A href="http://www-ist.massey.ac.nz/JBDietrich" target="_top">Jens Dietrich</A>
 * @version 3.4 <7 March 05>
 * @since 2.2
 */
public interface ObjectPersistencyService {
	/**
	 * Export objects.
	 * @param out an output stream
	 * @exception an io exception
	 */
	public void exportObjects(OutputStream out) throws IOException ;
	/**
	 * Import objects.
	 * @param in an input stream
	 * @exception an io exception
	 */
	public void importObjects(InputStream in) throws IOException ;	
	/**
	 * Get name.
	 * @return the name of the service
	 */
	public String getName() ;
	/**
	 * Get a brief description.
	 * @return a brief description of the service
	 */
	public String getDescription() ;	
	/**
	 * Get the extension of the associated files.
	 * @return a file extension
	 */
	public String getExtension() ;
	/**
	 * Create a name of an object.
	 * @param obj an object
	 * @return an uri
	 */
	public String createName(Object obj);	
	/**
	 * Bind an object to a name (uri).
	 * @param uri an uri
	 * @param obj an object
	 */
	public void bind(String uri,Object obj);
	/**
	 * Find an object. If the object is not yet registered, bind it
	 * using the generated name.
	 * @param obj an object
	 * @return the uri
	 */
	public String findOrBind(Object obj);
	/**
	 * Unbind the name (uri).
	 * @param uri an uri
	 */
	public void unbind(String uri);
	/**
	 * Get an object by name.
	 * @param uri an uri
	 * @return obj an object
	 */
	public Object lookup(String name);
	/**
	 * Reset the state, release all associations.
	 */
	public void reset();

	 
}