GraphBuilder.h

#ifndef REBECCA_GRAPHBUILDER_H
#define REBECCA_GRAPHBUILDER_H

/*
 * RebeccaAIML, Artificial Intelligence Markup Language 
 * C++ api and engine.
 *
 * Copyright (C) 2005 Frank Hassanabad
 *
 * 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.1 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., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 */


/* Disable Windows VC 7.x warning about 
 * it ignoring the throw specification
 */
#ifdef _WIN32
#    pragma warning ( push )
#    pragma warning( disable : 4290 )
#endif

//Rebecca includes
#include <rebecca/exports.h>
#include <rebecca/StringPimpl.h>
#include <rebecca/CallBacks.h>
#include <rebecca/Exceptions.h>

namespace rebecca 
{
namespace impl 
{

class REBECCA_EXPORT GraphBuilder
{
    public:

        virtual void addFile(const char * const file) 
            throw(FileNotFoundException &, Exception &) = 0;        

        virtual void addDirectory(const char * const directory, const char * const regularExpression = ".*\\.aiml") 
            throw(IllegalArgumentException &, DirectoryNotFoundException &, Exception &) = 0;
        
        virtual void addString(const char * const stringContainingAIML)
            throw(Exception &) = 0;

        virtual void setAddStringAIMLHeader(const char * const aimlHeader)
            throw(Exception &) = 0;

        virtual void setAddStringAIMLFooter(const char * const aimlFooter)
            throw(Exception &) = 0;

        virtual void setAIMLSchema(const char * const schema) 
            throw(Exception &) = 0;

        virtual void setCommonTypesSchema(const char * const schema) 
            throw(Exception &) = 0;

        virtual void setAIMLValidation(bool trueOrFalse = true) 
            throw(Exception &) = 0;
        
        virtual StringPimpl getResponse(const char * const input) 
            throw(Exception &) = 0;
        
        virtual void setThat(const char * const that) 
            throw(Exception &) = 0;

        virtual void setTopic(const char * const topic) 
            throw(Exception &) = 0;

        virtual StringPimpl getThat() const
            throw(Exception &) = 0;

        virtual StringPimpl getTopic() const
            throw(Exception &) = 0;

        virtual void createGraph() 
            throw(XMLErrorException &, Exception &) = 0;

        virtual bool predicateMatch(const char * const predicateName, const char * const aimlPattern) const
            throw(Exception &) = 0;
        
        virtual void setPredicate(const char * const name, const char * const value) 
            throw(Exception &) = 0;

        virtual StringPimpl getPredicate(const char * const name) const
            throw(Exception &) = 0;

        virtual StringPimpl getBotPredicate(const char * const name) const
            throw(Exception &)  = 0;

        virtual void setBotPredicate(const char * const name, const char * const value) 
            throw(Exception &) = 0;
        
        virtual StringPimpl getPreviousBotResponse(const unsigned int &previousBotResponse, const unsigned int &sentence) const
            throw(IllegalArgumentException &, Exception &) = 0;

        virtual StringPimpl getPreviousUserInput(const unsigned int &previousUserInput, const unsigned int &sentence) const
            throw(IllegalArgumentException &, Exception &) = 0;
        
        virtual void setBotConfigurationSchema(const char *const schema) 
            throw(Exception &) = 0;

        virtual void setBotConfigurationValidation(const bool trueOrFalse = true) 
            throw(Exception &) = 0;

        virtual void parseSubstitutionFile(const char *const fileName) 
            throw(XMLErrorException &, FileNotFoundException &, Exception &) = 0;

        virtual void parseSentenceSplitterFile(const char *const fileName) 
            throw(XMLErrorException &, FileNotFoundException &, Exception &) = 0;

        virtual void parsePropertiesFile(const char *const fileName)
            throw(XMLErrorException &, FileNotFoundException &, Exception &) = 0;
        
        virtual void setSentenceSplitter(const char *const splitter) 
            throw(Exception &) = 0;

        virtual void setInputSubstitution(const char *const find, const char *const replace) 
            throw(IllegalArgumentException &, Exception &) = 0;

        virtual void setGenderSubstitution(const char *const find, const char *const replace) 
            throw(IllegalArgumentException &, Exception &) = 0;

        virtual void setPersonSubstitution(const char *const find, const char *const replace) 
            throw(IllegalArgumentException &, Exception &) = 0;

        virtual void setPerson2Substitution(const char *const find, const char *const replace) 
            throw(IllegalArgumentException &, Exception &)  = 0;
        
        virtual StringPimpl getVersion() const 
            throw(Exception &) = 0;
        
        virtual int getSize() const 
            throw(Exception &) = 0;

        virtual void setCallBacks(CallBacks *callBacks) 
            throw(Exception &) = 0;

        virtual void storeGossip(const char * const gossip) 
            throw(Exception &) = 0;
        
        virtual StringPimpl getId() const
            throw(Exception &) = 0;
        
        virtual void setId(const char * const id)
            throw(Exception &) = 0;

        virtual void addCustomTagLibrary(const char * const library)
            throw(FileNotFoundException &, Exception &) = 0;

        virtual void removeCustomTagLibrary(const char * const library)
            throw(FileNotFoundException &, Exception &) = 0;
        
        virtual StringPimpl callSystemCommand(const char * const command)
            throw(Exception &) = 0;

        virtual ~GraphBuilder() { };
};

} //end of namespace impl

//Expose GraphBuilder to rebecca namespace
using rebecca::impl::GraphBuilder;

} //end of namespace rebecca


#ifdef _WIN32
#    pragma warning ( pop )
#endif




#endif

---