|
|
|
/***************************************************************************
|
|
|
|
* This file is part of the KDE project
|
|
|
|
* copyright (C) 2005 by Sebastian Sauer (mail@dipe.org)
|
|
|
|
* copyright (C) 2006 by Bernd Steindorff (bernd@itii.de)
|
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU Library General Public
|
|
|
|
* License as published by the Free Software Foundation; either
|
|
|
|
* version 2 of the License, or (at your option) any later version.
|
|
|
|
* This program 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
|
|
|
|
* Library General Public License for more details.
|
|
|
|
* You should have received a copy of the GNU Library General Public License
|
|
|
|
* along with this program; see the file COPYING. If not, write to
|
|
|
|
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
|
|
* Boston, MA 02110-1301, USA.
|
|
|
|
***************************************************************************/
|
|
|
|
|
|
|
|
#include "xmlhandler.h"
|
|
|
|
#include "macro.h"
|
|
|
|
#include "macroitem.h"
|
|
|
|
#include "action.h"
|
|
|
|
|
|
|
|
#include <tqdom.h>
|
|
|
|
#include <kdebug.h>
|
|
|
|
|
|
|
|
using namespace KoMacro;
|
|
|
|
|
|
|
|
namespace KoMacro {
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @internal d-pointer class to be more flexible on future extension of the
|
|
|
|
* functionality without to much risk to break the binary compatibility.
|
|
|
|
*/
|
|
|
|
class XMLHandler::Private
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The @a Macro instance this @a XMLHandler
|
|
|
|
* manages.
|
|
|
|
*/
|
|
|
|
Macro* const macro;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Constructor.
|
|
|
|
*
|
|
|
|
* @param macro The @a Macro instance this
|
|
|
|
* @a XMLHandler manages.
|
|
|
|
*/
|
|
|
|
Private(Macro* const macro)
|
|
|
|
: macro(macro)
|
|
|
|
{
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
XMLHandler::XMLHandler(Macro* const macro)
|
|
|
|
: d( new Private(macro) )
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
|
|
|
XMLHandler::~XMLHandler()
|
|
|
|
{
|
|
|
|
delete d;
|
|
|
|
}
|
|
|
|
|
|
|
|
bool XMLHandler::parseXML(const TQDomElement& element)
|
|
|
|
{
|
|
|
|
// Remove old items. We should clear first.
|
|
|
|
d->macro->clearItems();
|
|
|
|
|
|
|
|
// We expect a <macro> element. Do we really need to be such strict or
|
|
|
|
// would it be more wise to trust the application in that case?
|
|
|
|
if(element.tagName() != "macro") {
|
|
|
|
kdDebug() << TQString("XMLHandler::parseXML() Invalid tagname \"%1\"").arg(element.tagName()) << endl;
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
// To be flexible with the xml-scheme, we need a version-number for xml.
|
|
|
|
// If there is more than one version, parsing should update old macro-data, so that it
|
|
|
|
// could write out in the newer version in toXML().
|
|
|
|
if( element.attribute("xmlversion") != "1"){
|
|
|
|
kdDebug() << TQString("XMLHandler::parseXML() Invalid xml-version \"%1\"").arg(element.attribute("xmlversion")) << endl;
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Do we need to load the macro's name?
|
|
|
|
// d->macro->setName(element.attribute("name"));
|
|
|
|
|
|
|
|
// Iterate through the child nodes the passed TQDomElement has and
|
|
|
|
// build the MacroItem elements.
|
|
|
|
for(TQDomNode itemnode = element.firstChild(); ! itemnode.isNull(); itemnode = itemnode.nextSibling()) {
|
|
|
|
// The tagname should be "item"
|
|
|
|
if(itemnode.nodeName() == "item") {
|
|
|
|
// The node is an element.
|
|
|
|
const TQDomElement itemelem = itemnode.toElement();
|
|
|
|
|
|
|
|
// Create a new MacroItem
|
|
|
|
TDESharedPtr<MacroItem> item = new MacroItem();
|
|
|
|
|
|
|
|
// Add the new item to our Macro.
|
|
|
|
d->macro->addItem( item );
|
|
|
|
|
|
|
|
// Each MacroItem may point to an Action instance. We
|
|
|
|
// try to determinate this action now and if it's defined
|
|
|
|
// and available, we set it.
|
|
|
|
TDESharedPtr<Action> action = Manager::self()->action( itemelem.attribute("action") );
|
|
|
|
if(action.data()) {
|
|
|
|
item->setAction(action);
|
|
|
|
}
|
|
|
|
|
|
|
|
// Set the comment
|
|
|
|
item->setComment( itemelem.attribute("comment") );
|
|
|
|
|
|
|
|
// Iterate through the children this item has and try
|
|
|
|
// to fill the list of variables our new MacroItem has.
|
|
|
|
for(TQDomNode childnode = itemnode.firstChild(); ! childnode.isNull(); childnode = childnode.nextSibling()) {
|
|
|
|
// The tagname should be "variable"
|
|
|
|
if(childnode.nodeName() == "variable") {
|
|
|
|
// The node is an element.
|
|
|
|
const TQDomElement childelem = childnode.toElement();
|
|
|
|
|
|
|
|
// The name the variable has.
|
|
|
|
const TQString name = childelem.attribute("name");
|
|
|
|
// The value the variable has.
|
|
|
|
const TQString value = childelem.text();
|
|
|
|
|
|
|
|
// Store the new variable in our macroitem.
|
|
|
|
item->addVariable(name, value);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// Job was done successfully.
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
|
|
TQDomElement XMLHandler::toXML()
|
|
|
|
{
|
|
|
|
// The TQDomDocument provides us the functionality to create new TQDomElement instances.
|
|
|
|
TQDomDocument document;
|
|
|
|
|
|
|
|
// Create the Macro-TQDomElement. This element will be returned.
|
|
|
|
TQDomElement macroelem = document.createElement("macro");
|
|
|
|
|
|
|
|
// Set the Macro-XML-Version, it should be the newest Version.
|
|
|
|
macroelem.setAttribute("xmlversion","1");
|
|
|
|
|
|
|
|
// Do we need to store the macro's name? Normaly the application
|
|
|
|
// could/should take care of it cause we don't know how the app
|
|
|
|
// may store the XML and cause we don't like to introduce
|
|
|
|
// redundancy at this point.
|
|
|
|
//macroelem.setAttribute("name",d->macro->name());
|
|
|
|
|
|
|
|
// The list of MacroItem-children a Macro provides.
|
|
|
|
TQValueList<TDESharedPtr<MacroItem > > items = d->macro->items();
|
|
|
|
|
|
|
|
// Create an iterator...
|
|
|
|
TQValueList<TDESharedPtr<MacroItem > >::ConstIterator it(items.constBegin()), end(items.constEnd());
|
|
|
|
// ...and iterate over the list of children the Macro provides.
|
|
|
|
for(;it != end; ++it) {
|
|
|
|
// We are iterating over MacroItem instances.
|
|
|
|
TDESharedPtr<MacroItem> item = *it;
|
|
|
|
|
|
|
|
// Flag to determinate if we really need to remember this item what
|
|
|
|
// is only the case if comment or action is defined.
|
|
|
|
bool append = false;
|
|
|
|
|
|
|
|
// Each MacroItem will have an own node.
|
|
|
|
TQDomElement itemelem = document.createElement("item");
|
|
|
|
|
|
|
|
// Each MacroItem could point to an Action provided by the Manager.
|
|
|
|
const TDESharedPtr<Action> action = item->action();
|
|
|
|
if( action ) {
|
|
|
|
append = true;
|
|
|
|
|
|
|
|
// Remember the name of the action.
|
|
|
|
itemelem.setAttribute("action", action->name());
|
|
|
|
|
|
|
|
// Each MacroItem could have a list of variables. We
|
|
|
|
// iterate through that list and build a element
|
|
|
|
// for each single variable.
|
|
|
|
TQMap<TQString, TDESharedPtr<Variable > > varmap = item->variables();
|
|
|
|
|
|
|
|
for(TQMap<TQString, TDESharedPtr<Variable > >::ConstIterator vit = varmap.constBegin(); vit != varmap.constEnd(); ++vit) {
|
|
|
|
const TDESharedPtr<Variable> v = vit.data();
|
|
|
|
if(! v.data()) {
|
|
|
|
// skip if the variable is NULL.
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
// Create an own element for the variable. The tagname will be
|
|
|
|
// the name of the variable.
|
|
|
|
TQDomElement varelement = document.createElement("variable");
|
|
|
|
|
|
|
|
// Remember the name the value has.
|
|
|
|
varelement.setAttribute("name", vit.key());
|
|
|
|
|
|
|
|
// Remember the value as textnode.
|
|
|
|
varelement.appendChild(document.createTextNode(v->toString()));
|
|
|
|
|
|
|
|
// Add the new variable-element to our MacroItem.
|
|
|
|
itemelem.appendChild(varelement);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// Each MacroItem could have an optional comment.
|
|
|
|
const TQString comment = item->comment();
|
|
|
|
if(! comment.isEmpty()) {
|
|
|
|
append = true;
|
|
|
|
itemelem.setAttribute("comment", item->comment());
|
|
|
|
}
|
|
|
|
|
|
|
|
// Check if we really need to remember the item.
|
|
|
|
if(append) {
|
|
|
|
macroelem.appendChild(itemelem);
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
// Job done. Return the macro's element.
|
|
|
|
return macroelem;
|
|
|
|
}
|