iomanager.java

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

/*
 * Copyright (C) 1999-2005 <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
 */

package org.mandarax.zkb;

import org.mandarax.util.logging.LogCategories;
import java.util.Properties;

/**
 * Interface that describes how ZKB is imported / exported.
 * This functionality used to be in the ZKBManager (v3.3 and older), outsourcing it has various advantages, in 
 * particular that we can now export/import to/from zip files AND folders.
 * @author <A href="http://www-ist.massey.ac.nz/JBDietrich" target="_top">Jens Dietrich</A>
 * @version 3.4 <7 March 05>
 * @since 3.4
 */

public interface IOManager extends LogCategories {
	
	// constant
	public static final String META = "zkb-meta-inf.properties";
	public static final String KB = "kb.xml";
	public static final String RESOURCES = "resources"; // + extension from ops used (e.g. .ser or .xml)
	
	// return type for read method
	public class Data {
		public Properties metaData = null;
		public byte[] kbData,resourceData;
		public ObjectPersistencyService ops;
	}
	
	/**
	 * Write zkb data.
	 * @param target an object describing the target (e.g. a file)
	 * @param metaData the serialized meta data
	 * @param kbData the serialized knowledge base
	 * @param resourceData the serialized resource data (objects)
	 * @param ops the object persistency service used
	 */
	public void write(Object target,byte[] metaData, byte[] kbData, byte[] resourceData,ObjectPersistencyService ops) throws Exception ; 
	
	/**
	 * Read zkb data.
	 * @param source the data source (e.g., a file)
	 * @return a data object
	 */
	public Data read(Object source) throws Exception ; 
}