Click here to Skip to main content
Click here to Skip to main content

Xerces for C++ Tutorial Using Visual C++

, 25 Jan 2009 CPOL
Rate this:
Please Sign up or sign in to vote.
Create an empty DOM document using Xerces for C++.

Introduction

This article shows you how to create an empty XML DOM document using Xerces for C++ using Visual Studio 9. Although I don't cover the actual output for this application, if I did, it would produce an XML document that looked like this:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<Hello_World/>

I've written another tutorial that shows how to output to the file system or output stream: Xerces for C++ Using Visual C++, Part 2.

Background

The main reason I've written this article is because the official documentation for Xerces is a little light on sample code. Also, I could not find anyone else using Xerces for C++ on Visual Studio 2008 (v9).

Subversion Source Control Repository (optional)

(All mention of Subversion Source Control is optional - just ignore if you wish.)

I write computer software for the Win32 platform. I do this mostly using Visual Studio products by Microsoft. In the past, I used Microsoft Visual Source Safe ("VSS") as my source code repository; however, I am now using an Open Source replacement called Subversion. I've looked at several high-end source control repositories; however, in my humble opinion, Subverion should suit the needs of almost any development team. It can be a bit scary at first (especially if you are used to VSS); but when combined with the TortoiseSVN client, it's really quite easy. Having said that, I would strongly suggest that you also revise the way you use source control. There's little point in upgrading to Subverion if you are just going to use it like VSS. I do not use Subverion using the command line interface (and I would never like to either).

Setting up your Visual Studio 9 Environment (w/Subversion)

(All mention of Subversion Source Control is optional - just ignore if you wish.)

The following is my own personal preferences for laying out files and folders on the HDD and how this integrates with Subversion source control. Have a look at the following screen snapshot of my Explorer (the icons have been modified by TortoiseSVN, but just ignore them for now).

ExplorerWithSubversionExternals.png

My own personal preference for laying out files and folders on the HDD and how this integrates with Subversion source control.

I split my code into three main areas:

  1. The project that I'm working on. In this case, Xerces_Lesson_01.
  2. Code from other organizations such as Xerces (from the Apache project).
  3. ... and a special folder called externals.

The main project (Xerces_Lesson_01) is split into branches, tags, and a trunk. This is the scheme recommended by Subversion source control which I've found very helpful. Code in the trunk always compiles and is never broken - It is considered my current working copy. Whenever I feel that I may 'break' code in order to refactor, fix bugs, or experiment, I 'branch' off into a separate folder, make changes, then merge back into the trunk. Release versions are 'tagged' and moved appropriately.

If a project is composed of multiple projects or libraries (my own or third party), I place these under source control too. In the example above, the third party library is xerces-c_2_7_0-windows_2000-msvc_60.

The externals folder has special attributes attached to it (thanks to TortoiseSVN) that copies files from one location to another. In the diagram above, files that have been copied to a new location are shaded red. Understand that these files are not just copied to Xerces_Lesson_01, but they are copied at the correct revision number that I specify. In this way, as I develop my project(s), I can step-back-in-time to any previous revision of my main project, and also pull in all dependences at that revision too. This is a very powerful technique for moving a project forward with confidence, despite having multiple dependencies that may change over time.

Another reason for pulling in dependencies from other projects into the externals folder is to keep all compiler and linker options tightly under source control as well (see next section).

Setting up Visual Studio 9 with Xerces

There are three things to setup before you can compile, link, and run an executable:

  1. Tell Visual Studio (and/or the Project) where to find the Include files (*.h)
  2. Tell Visual Studio (and/or the Project) where to find the the Library files (*.lib)
  3. Copy the Dynamic Link Libraries (*.dll) to the same directory as the executable (and/or to the solution directory during debug)

Assuming you've already download the Xerces binaries (containing include files, libraries, and DLLs), you can reference Xerces in multiple ways. Perhaps, the most common method is to add a reference to the various files using the VC++ Directories options (as shown below).

vs9options1.png

Tell Visual Studio where the various Xerces files are located. You will need to do this for include files (*.h) and libraries (*.lib). Note: Although this method is very popular, I don't use it or recommend it for a business environment... see next image.
  • Advantages
    1. Quick, simple, and easy.
  • Disadvantages
    1. The values are coupled to a particular instance of Visual Studio instead of the project you are working on. If you copy the project files to a different PC, you will have to re-establish these directories on the new PC.
    2. These values are not easily coupled with source control solutions (because they are not coupled to the project).
    3. If you have multiple developers working on the same projects, and one of them changes the values here, the change isn't automatically propagated to the other developer PCs.

As you can see from the list above, there are more disadvantages than advantages; therefore, I do not recommend this method in a business environment where you are working on code with other developers. Consider using the following instead:

vs9properties1.png

Place references to your third party, or external directories in the Project Properties instead. This way, they are tied very closely with the project.

While it's certainly possible to add the full path here, I usually don't, and provide relative paths instead. In general, I try to avoid absolute paths. This makes it easier for me to copy the entire project and all dependencies onto a memory stick and continue development on a different PC without changing anything. It also makes backups easier.

Link with Xerces Libraries

vs9properties2.png

The process of establishing references to library files (*.lib) is similar to include files. Set the Project Linker options.

Using the Code

I am assuming you have already downloaded and installed the binaries for Xerces for C++ (Win32 platform). Before using the sample code below, you will need to tell Visual Studio the location for the Xerces include and library files. You will also need to place the Xerces DLL into the solution directory (or in the same location as the executable).

// Mandatory for using any feature of Xerces.
#include <xercesc/util/PlatformUtils.hpp>

// DOM (if you want SAX, then that's a different include)
#include <xercesc/dom/DOM.hpp>

// Define namespace symbols (Otherwise we'd have to prefix Xerces code with 
// "XERCES_CPP_NAMESPACE::")
XERCES_CPP_NAMESPACE_USE


int main(void) {

    // Initilize Xerces.
    XMLPlatformUtils::Initialize();

    // Pointer to our DOMImplementation.
    DOMImplementation*    p_DOMImplementation = NULL;

    // Get the DOM Implementation (used for creating DOMDocuments).
    // Also see: http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html
    p_DOMImplementation = DOMImplementationRegistry::getDOMImplementation(
             XMLString::transcode("core"));


    // Pointer to our DOMDocument.
    DOMDocument*        p_DOMDocument = NULL;

    /*
    Create an empty DOMDocument. When an empty document is created specify the 
         namespace of the document (optional)
    and also the root node. Both of these values can be any valid text 
         (ie. no spaces or weird characters).
    The "root node" in this example is "Hello_World". (XML is case-sensitive) 
         This root node *owns everything* beneath it, just as if it were a separate
         object... in fact, it is. It's defined
    by the 'DOMNode' class.
    */
    p_DOMDocument = p_DOMImplementation->createDocument(0, L"Hello_World", 0);

    /*
    The output of the code above will produce the following:

        <?xml version="1.0" encoding="UTF-8" standalone="no" ?>
        <Hello_World/>

    */

    // Cleanup.
    p_DOMDocument->release();
    XMLPlatformUtils::Terminate();

    return 0;
}

If you get the following error:

error LNK2001: unresolved external symbol
    "__declspec(dllimport) public: static wchar_t *
    __cdecl xercesc_2_7::XMLString::transcode(char const * const)" (
    __imp_?transcode@XMLString@xercesc_2_7@@SAPA_WQBD@Z)

Modify the following C++ language compiler option:

/Zc:wchar_t (wchar_t Is Native Type)

History

  • Initial release: 2008-11-20.
  • Updated: 2008-11-29.
  • Updated: 2009-01-26 - Minor edits.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Peter Wilson
Software Developer (Senior) Various
Australia Australia
I've twice been the director/CEO/what-have-you of my own software companies. I sold software into 20 countries before I stopped counting.

Comments and Discussions

 
QuestionError Pinmemberpirat_zg13-Oct-10 1:55 
AnswerRe: Error PinmemberPeter Wilson13-Oct-10 3:45 
GeneralRe: Error Pinmemberpirat_zg13-Oct-10 3:55 
GeneralDebuging Error PinmemberTharinduSR6-May-09 3:22 
GeneralRe: Debuging Error PinmemberPeter Wilson6-May-09 4:02 
GeneralAnother update is ready! PinmemberPeter Wilson24-Jan-09 0:27 
GeneralRe: Another update is ready! PinmemberKarstenK25-Jan-09 22:05 
GeneralGreat expectations PinmvpCPallini28-Nov-08 4:45 
GeneralRe: Great expectations PinmemberPeter Wilson30-Nov-08 4:17 
GeneralMy vote of 1 PinmemberFernando A. Gomez F.27-Nov-08 12:30 
GeneralMy vote of 1 Pinmemberobjects25-Nov-08 22:31 
GeneralMy vote of 1 PinmemberAli Khanlarkhani25-Nov-08 20:47 
GeneralMy vote of 1 PinmemberRama Krishna Vavilala25-Nov-08 14:19 
GeneralRe: My vote of 1 PinmemberPeter Wilson28-Nov-08 19:20 
GeneralMy vote of 1 Pinmemberseverality25-Nov-08 10:34 
GeneralRe: My vote of 1 PinmemberPeter Wilson28-Nov-08 19:19 
GeneralLight code PinmemberFernando A. Gomez F.25-Nov-08 7:18 
GeneralRe: Light code PinmemberPeter Wilson28-Nov-08 19:17 
GeneralRe: Light code PinmemberFernando A. Gomez F.28-Nov-08 21:44 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.1411023.1 | Last Updated 26 Jan 2009
Article Copyright 2008 by Peter Wilson
Everything else Copyright © CodeProject, 1999-2014
Layout: fixed | fluid