Narzędzia użytkownika

Narzędzia witryny


xerces_dom

Różnice

Różnice między wybraną wersją a wersją aktualną.

Odnośnik do tego porównania

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
xerces_dom [2008/04/15 00:01]
kmioduszewski
xerces_dom [2008/04/16 02:07]
kmioduszewski
Linia 139: Linia 139:
  
 </​code> ​ </​code> ​
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
  
  
Linia 148: Linia 161:
  
 ===== DOMDocument,​ operacje na dokumencie===== ===== DOMDocument,​ operacje na dokumencie=====
-Gdy dokument zostanie sparsowany bez żadnych błędów możemy swobodnie zacząć na nim pracować wykorzystując zawarte w rekomendacjach metody. Poniżej kod zawierający ​przykładowe operacje:+Gdy dokument zostanie sparsowany bez żadnych błędów możemy swobodnie zacząć na nim pracować wykorzystując zawarte w rekomendacjach metody. Poniżje znajduje się kod przykładowej aplikacji, która wczytuje plik XML, wpisuje jego zawartość na ekran, modyfikuje go, a następnie zapisuje zmiany do pliku.\\ \\  
 +Plik XML - ''​notes.xml'',​ który zostanie wczytany: 
 +<code xml> 
 +<?xml version="​1.0"?>​ 
 +<​!DOCTYPE notes SYSTEM "​note.dtd">​ 
 +<notes owner="​John Doe">​ 
 +   <​note date="​21/​02/​2008">​ 
 +      <​from>​Jani</​from>​ 
 +      <​heading>​Reminder</​heading>​ 
 +      <​body>​Don'​t forget me this weekend</​body>​ 
 +   </​note>​ 
 +   <​note date="​12/​04/​2008">​ 
 +      <​from>​Jeff</​from>​ 
 +      <​heading>​Money</​heading>​ 
 +      <​body>​Gimme my money back!</​body>​ 
 +   </​note>​ 
 +</​notes>​ 
 +</​code>​ 
 +DTD - ''​notes.dtd''​ 
 +<​code>​ 
 + <​!ELEMENT notes (note+) >  
 + <​!ATTLIST notes owner CDATA #​REQUIRED>​ 
 +  <​!ELEMENT note (from,​heading,​body)>​ 
 +  <​!ATTLIST note date CDATA #​REQUIRED>​ 
 +  <​!ELEMENT from    (#​PCDATA)>​ 
 +  <​!ELEMENT heading (#​PCDATA)>​ 
 +  <​!ELEMENT body    (#​PCDATA)>​ 
 +</​code>​ 
 +Klasy pomocnicze ''​support.h''​:
 <code cpp> <code cpp>
-//...+#include <​string>​ 
 +#include <​iostream>​ 
 +#include <​stdexcept>​ 
 +#include <xercesc/util/XMLString.hpp> 
 +#include <​xercesc/​sax/​HandlerBase.hpp> 
 +#include <​xercesc/​util/​PlatformUtils.hpp>​ 
 +#include <​xercesc/​dom/​DOM.hpp>​  
 +#include <​xercesc/​parsers/​XercesDOMParser.hpp>​ 
 +#include <​xercesc/​framework/​LocalFileFormatTarget.hpp>​ 
 +#include <​xercesc/​framework/​StdOutFormatTarget.hpp>
  
-xercesc::​DOMDocumentXMLdoc = parser->​getDocument();​ +//klasa pomocnicza ułatwiająca współpracę z XMLCh
-xercesc::​DOMElement* root = XMLdoc->​getDocumentElement();​+class UniString { 
 +//​private ​:
  
-//pobieramy nazwę elementu głównego 
-char* rootName = XMLString::​transcode(root->​getLocalName());​ 
  
-if(root->​hasAttributes()) { +public : 
- xercesc::DOMNamedNodeMap* attrMap = root->​getAttributes(); + char* ​  ​cString;​ 
- //iterujemy sobie po atrybutach + XMLCh* ​ xmlString;​ 
-        forXMLSize_t i = 0 ; i < attrMap->​getLength() ; ++i ) { + UniString(const XMLCh* const str)  
- DOMAttr* attr = dynamic_cast<​DOMAttr*>​(attrMap->​item(ix)); +
-                //​wykorzystujemy sobie atrybut + cString(xercesc::​XMLString::​transcode(str)), 
-                ​attr->​getName();  //tutaj mamy nazwe + xmlString(xercesc::XMLString::​replicate(str)
-                ​attr->​getValue(); //wartosc + {} 
-                //...+  
 + UniString(const char* const str) 
 +
 + cString(xercesc::​XMLString::​replicate(str))
 + xmlString(xercesc::​XMLString::​transcode(str)) 
 + {}  
 +  
 + UniString(const std::​string&​ str) 
 + : 
 + cString(xercesc::​XMLString::​replicate(str.c_str())), 
 + xmlString(xercesc::​XMLString::​transcode(str.c_str())) 
 + {} 
 +  
 + ~UniString()  
 +
 + xercesc::​XMLString::​release(&​cString); 
 + xercesc::​XMLString::​release(&​xmlString);​
  }  }
-}+  
 + const char* toCString() const { return cString; ​} 
 + const XMLCh* toXMLString() const { return xmlString; } 
 +  
 + std::​ostream&​ print(std::​ostream&​ s) const  
 +
 + s << cString; 
 + return(s);​ 
 +
 + 
  
 +};
 + 
 +std::​ostream&​ operator<<​( std::​ostream&​ s, const UniString&​ str ) { return str.print(s);​ }
 + 
 +//klasa pomocnicza przechowująca nazwy tagów oraz atrybutów ​
 +class DocNames {
 +public:
 + const UniString TAG_NOTES;
 + const UniString TAG_NOTE;
 + const UniString TAG_FROM;
 + const UniString TAG_HEADING;​
 + const UniString TAG_BODY;
 + 
 + const UniString ATTR_OWNER;
 + const UniString ATTR_DATE;
 + 
 + DocNames()
 + :
 + TAG_NOTES("​notes"​),​
 + TAG_NOTE("​note"​),​
 + TAG_FROM("​from"​),​
 + TAG_HEADING("​heading"​),​
 + TAG_BODY("​body"​),​
 + 
 + ATTR_OWNER("​owner"​),​
 + ATTR_DATE("​date"​)
 + {}
 +};
  
 +class myErrorHandler : xercesc::​HandlerBase {
 + void warning( const xercesc::​SAXParseException&​ e ) { 
 + std::cerr << "​warning:​ " << UniString(e.getMessage())
 +   << " | line: " << e.getLineNumber() << std::endl;
 + }
 + void error( const xercesc::​SAXParseException&​ e ) {
 + std::cerr << "​error:​ " << UniString(e.getMessage()) ​
 + << " | line: " << e.getLineNumber() << std::endl;
 + }
 + void fatalError( const xercesc::​SAXParseException&​ e ) {
 + std::cerr << "​fatalError:​ " << UniString(e.getMessage())  ​
 + << " | line: " <<​e.getLineNumber() << std::endl;
 + }
 + void resetErrors() {}
 +};
 +</​code>​
 +''​DOMtest.h''​ - zawiera klasę DOMtest, prezentującą możliwości korzystania biblioteki DOM.
 +<code cpp>
 +#include "​support.h"​
  
 +class DOMtest {
 +private:
 + std::​string filename;
 + xercesc::​XercesDOMParser parser;
 + DocNames names;
 + bool loaded;
  
 + DOMtest(const DOMtest&​);​
 +public:
 + DOMtest(std::​string f) 
 +
 + filename(f), ​
 + parser(),
 + names(),
 + loaded(false)
 + { };
 +
 + void init() throw( std::​runtime_error )
 + {
 + parser.setValidationScheme(xercesc::​XercesDOMParser::​Val_Auto); ​   ​
 + parser.setDoNamespaces(true); ​  
 +
 + xercesc::​ErrorHandler* errHandler = (xercesc::​ErrorHandler*) new myErrorHandler();​
 + parser.setErrorHandler(errHandler);​
 +
 + try {
 + parser.parse(filename.c_str());​
 + } catch(xercesc::​XMLException&​ e){
 + UniString eMsg(e.getMessage());​
 + throw(std::​runtime_error(eMsg.toCString()));​
 + }catch( const xercesc::​DOMException&​ e ){
 + UniString eMsg(e.getMessage());​
 + throw(std::​runtime_error(eMsg.toCString()));​
 + }
 +
 + if(parser.getErrorCount()!=0) ​
 + throw(std::​runtime_error("​..."​));​
 + }
 +
 + //funkcja zawierający przykładowy sposób pobiernia ​
 + //​informacji z dokumentu (bonus wyswietlanie ich)
 + std::​ostream&​ print(std::​ostream&​ s) throw(std::​runtime_error) ​ {
 + s << "MY NOTES: " << std::endl;
 + try {
 + //​bierzmy sobie dokumenty
 + xercesc::​DOMDocument* xmlDoc = parser.getDocument();​
 +
 + //​bierzemy sobie element główny
 + xercesc::​DOMElement* root = xmlDoc->​getDocumentElement();​
 +
 + if(root == NULL)
 + throw(std::​runtime_error("​Empty Document"​));​
 +
 + //​pobieramy wartość atrybutu owner
 + //​names.ATTR_OWNER.toXMLString() <- zwraca XMLCh* "​owner";​ -> support.h
 + UniString owner(root->​getAttribute(names.ATTR_OWNER.toXMLString()));​
 + s << "​owner:​ " << owner << std::endl;
 +
 + //​pobieramy wszystkie elementy '​note'​
 + xercesc::​DOMNodeList* notesElements = root->​getElementsByTagName(names.TAG_NOTE.toXMLString());​
 +
 + for( XMLSize_t i = 0; i < notesElements->​getLength();​ ++i) {
 + s << "note no. " << i+1 << " ";
 +
 + //​bierzmy sobie node
 + xercesc::​DOMNode* node = notesElements->​item(i);​
 +
 + //​konwersja na DOMElement, mogę sobie na to pozwolić gdyż znam,
 + //​całą strukturę dokumentu, w przypadku nie znania wypadałoby sprawdzić
 + //​aczkolwiek dynamic_cast rzuci wyjatke w razie problemów
 + xercesc::​DOMElement* domElement = dynamic_cast<​xercesc::​DOMElement*>​(node);​
 +
 + //​pobieram datę
 + UniString date(domElement->​getAttribute(names.ATTR_DATE.toXMLString()));​
 + s << "date: " << date << std::endl;
 +
 + //​pobiorę sobie "​bezposrednio"​ zawartość <​form></​form>​
 + //nie jest to może tak "​bezpośrednie"​ jak np. w Javascript ;)
 + UniString from(domElement->​getElementsByTagName(names.TAG_FROM.toXMLString())->​item(0)->​getTextContent());​
 + s << " From: " << from << std::​endl; ​
 +
 + //teraz kolejne elementy
 + UniString heading(domElement->​getElementsByTagName(names.TAG_HEADING.toXMLString())->​item(0)->​getTextContent());​
 + s << " Heading: " << heading << std::endl;
 +
 + UniString body(domElement->​getElementsByTagName(names.TAG_BODY.toXMLString())->​item(0)->​getTextContent());​
 + s << " Body: " << std::endl << " ​   " << body << std::endl << std::endl;
 + }
 +
 + } catch(xercesc::​XMLException&​ e){
 + UniString eMsg(e.getMessage());​
 + throw(std::​runtime_error(eMsg.toCString()));​
 + } catch( const xercesc::​DOMException&​ e ){
 + UniString eMsg(e.getMessage());​
 + throw(std::​runtime_error(eMsg.toCString()));​
 + }
 + return(s) ;
 + }
 +
 + //tworzymy nową notkę i dopinamy ją do drzewa dokumentu
 + void modify() throw(std::​runtime_error) ​
 + {
 + try {
 + //tresc notki
 + UniString date("​16/​04/​2008"​);​
 + UniString from("​Cassius"​);​
 + UniString heading("​!!!"​);​
 + UniString body("​Nice try, Zarflax!"​);​
 +
 + //aby tworzyć nowe elemnty potrzebujemy DOMDocument
 + xercesc::​DOMDocument* xmlDoc = parser.getDocument();​
 +
 + //​tworzymy nowy element <​note></​note>​
 + xercesc::​DOMElement* noteElement = xmlDoc->​createElement(names.TAG_NOTE.toXMLString());​
 +
 + //​tworzymy atrybut date
 + xercesc::​DOMAttr* noteElementDate = xmlDoc->​createAttribute(names.ATTR_DATE.toXMLString());​
 + //​ustawiamy wartosc atrybutu date
 + noteElementDate->​setValue(date.toXMLString());​
 + //​przypinamy atrybut date do elementu note
 + noteElement->​setAttributeNode(noteElementDate);​
 +
 + //​tworzymy kolejne elementy i przypominamy do notki
 + xercesc::​DOMElement* noteFromElement = xmlDoc->​createElement(names.TAG_FROM.toXMLString());​
 + //​ustawiamy tresc elementu <​from></​from>​
 + noteFromElement->​setTextContent(from.toXMLString());​
 + noteElement->​appendChild(noteFromElement);​
 +
 + xercesc::​DOMElement* noteHeadingElement = xmlDoc->​createElement(names.TAG_HEADING.toXMLString());​
 + noteHeadingElement->​setTextContent(heading.toXMLString());​
 + noteElement->​appendChild(noteHeadingElement);​
 +
 + xercesc::​DOMElement* noteBodyElement = xmlDoc->​createElement(names.TAG_BODY.toXMLString());​
 + noteBodyElement->​setTextContent(body.toXMLString());​
 + noteElement->​appendChild(noteBodyElement);​
 +
 + //​dopinamy kompletną notkę elementu <​notes></​notes>​
 + xmlDoc->​getDocumentElement()->​appendChild(noteElement);​
 +
 + } catch(xercesc::​XMLException&​ e){
 + UniString eMsg(e.getMessage());​
 + throw(std::​runtime_error(eMsg.toCString()));​
 + } catch( const xercesc::​DOMException&​ e ){
 + UniString eMsg(e.getMessage());​
 + throw(std::​runtime_error(eMsg.toCString()));​
 + }
 + }
 +
 + void write(std::​string filename) throw(std::​runtime_error) {
 + try {
 + //​konieczne do wykorzystania przy zapisie pliku
 + xercesc::​XMLFormatTarget* file = new xercesc::​LocalFileFormatTarget(UniString(filename).toXMLString());​
 +
 + //obiekt wykorzystywana do zapisu
 + xercesc::​DOMWriter* domWriter = parser.getDocument()->​getImplementation()->​createDOMWriter();​
 +
 + //jezeli mamy możliwość ustawiamy przyjazne dla człowieka formatowanie
 + if(domWriter->​canSetFeature(xercesc::​XMLUni::​fgDOMWRTFormatPrettyPrint,​true)){
 + domWriter->​setFeature(xercesc::​XMLUni::​fgDOMWRTFormatPrettyPrint,​true);​
 + }
 +
 + //zapis
 + domWriter->​writeNode(file,​*parser.getDocument()); ​
 +
 + delete(file);​
 + } catch(xercesc::​XMLException&​ e){
 + UniString eMsg(e.getMessage());​
 + throw(std::​runtime_error(eMsg.toCString()));​
 + } catch( const xercesc::​DOMException&​ e ){
 + UniString eMsg(e.getMessage());​
 + throw(std::​runtime_error(eMsg.toCString()));​
 + }
 + }
 +};
 +</​code>​
 +plik testujący ''​main.cpp''​
 +<code cpp>
 +#include "​DOMtest.h"​
 +
 +int main() {
 + try { 
 + xercesc::​XMLPlatformUtils::​Initialize();​
 + }
 + catch (const xercesc::​XMLException&​ e) {
 + std::cerr << UniString(e.getMessage()) << std::endl;
 + return 1;
 + }
 + 
 + try {
 + DOMtest* DOM = new DOMtest("​notes.xml"​);​
 + //​incjacja prasera itp.
 + DOM->​init();​
 + //​pobieranie wartości, wydruk na ekranie
 + DOM->​print(std::​cout);​
 + //dodanie notki
 + DOM->​modify();​
 + //zapisu do pliku
 + DOM->​write("​notes2.xml"​);​
 + } catch(std::​runtime_error&​ e) {
 + std::cerr << e.what() << std::endl;
 + std::cerr << "​Exiting"​ << std::endl;
 + }
 +
 + xercesc::​XMLPlatformUtils::​Terminate();​
 + 
 + return 0;
 +}
 </​code>​ </​code>​
xerces_dom.txt · ostatnio zmienione: 2008/04/16 15:33 przez kmioduszewski