/*
* @(#)DiskMapStore.java 3/11/2004
*
* Copyright (c) 2004, 2005 jASEN.org
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* 1. Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the distribution.
*
* 3. The names of the authors may not be used to endorse or promote products
* derived from this software without specific prior written permission.
*
* 4. Any modification or additions to the software must be contributed back
* to the project.
*
* 5. Any investigation or reverse engineering of source code or binary to
* enable emails to bypass the filters, and hence inflict spam and or viruses
* onto users who use or do not use jASEN could subject the perpetrator to
* criminal and or civil liability.
*
* THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES,
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
* FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JASEN.ORG,
* OR ANY CONTRIBUTORS TO THIS SOFTWARE BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
* OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
* EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
*/
package org.jasen.core.engine;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;
import java.io.OutputStream;
import java.util.Properties;
import org.jasen.error.JasenException;
import org.jasen.interfaces.JasenMapStore;
/**
* <P>
* Used to load/save a JasenMap to local disk by simply serializing the token map.
* </P>
* <p>
* This is the simplest implementation of a map store, however is not very portable.
* </p>
* <p>
* For greater portability it is recommended that alternate map stores be created. To use an alternate
* map store, specify the map store class in both the JasenTrainer and the RobinsonScanner plugin
* </p>
* <P>
* PLEASE NOTE however that the auto update service provided assumes a DiskMapStore as the primary store for engine data.
* <br/>
* Thus, if you change the MapStore, you will no longer be able to use the jASEN.org auto update service.
* </P>
* <P>
* You can still use the auto update engine against you OWN update site, just not at jasen.org
* </P>
* @author Jason Polites
* @see org.jasen.core.engine.JasenTrainer#setStore(JasenMapStore)
* @see org.jasen.plugins.RobinsonScanner#init(Properties)
*/
public class DiskMapStore implements JasenMapStore
{
/**
*
*/
public DiskMapStore() {
super ();
}
/* (non-Javadoc)
* @see org.jasen.core.engine.JasenMapStore#load()
*/
public JasenMap load(Object properties) throws JasenException {
InputStream in = null;
ObjectInputStream oin = null;
JasenMap map = null;
try
{
if(properties instanceof File) {
in = new FileInputStream((File)properties);
}
else if (properties instanceof String) {
in = new FileInputStream((String)properties);
}
else if(properties instanceof InputStream) {
in = (InputStream)properties;
}
else {
throw new JasenException("Unexpected or empty properties type. Must be String, File or InputStream");
}
oin = new ObjectInputStream(in);
map = (JasenMap)oin.readObject();
}
catch (IOException e)
{
throw new JasenException(e);
}
catch (ClassNotFoundException e)
{
throw new JasenException(e);
}
finally
{
if(in != null) {
try
{
in.close();
}
catch (IOException ignore){}
}
}
// Get the resource
return map;
}
/* (non-Javadoc)
* @see org.jasen.core.engine.JasenMapStore#save(org.jasen.core.engine.JasenMap)
*/
public void save(JasenMap map, Object properties) throws JasenException {
ObjectOutputStream oout = null;
OutputStream out = null;
try
{
if(properties instanceof File) {
out = new FileOutputStream((File)properties);
}
else if (properties instanceof String) {
out = new FileOutputStream((String)properties);
}
else if(properties instanceof OutputStream) {
out = (OutputStream)properties;
}
else {
throw new JasenException("Unexpected or empty properties type. Must be String, File or OutputStream");
}
oout = new ObjectOutputStream(out);
oout.writeObject(map);
oout.flush();
}
catch (IOException e)
{
throw new JasenException(e);
}
finally
{
if(out != null) {
try
{
out.close();
}
catch (IOException ignore){}
}
}
}
}