Keep access to underlying XMLDocument protected. Add a public Object method that exposes the underlying document's file version instead.

Author: aseth1

OpenSim/Common/Object.cpp

@@ -1241,13 +1241,18 @@ updateDefaultObjectsXMLNode(SimTK::Xml::Element& aParent)
  *
  * @return Document's filename for this object.
  */
-string Object::
-getDocumentFileName() const
+string Object::getDocumentFileName() const
 {
     return _document ? _document->getFileName() : "";
 }
 
 
+int Object::getDocumentFileVersion() const
+{ 
+    return _document ? _document->getDocumentVersion() : -1;
+}
+
+
 //-----------------------------------------------------------------------------
 // GENERATE XML DOCUMENT
 //-----------------------------------------------------------------------------

OpenSim/Common/Object.h

@@ -563,17 +563,23 @@ class OSIMCOMMON_API Object
     lost here. **/
     void setDocument(XMLDocument* doc) {_document=doc;}
 
+    /** Get a const pointer to the document (if any) associated with this
+    object. **/
+    const XMLDocument* getDocument() const {return _document;}
     /** Get a writable pointer to the document (if any) associated with this
     object. **/
     XMLDocument* updDocument() {return _document;}
 public:
-    /** Get a const pointer to the document (if any) associated with this
-    object. **/
-    const XMLDocument* getDocument() const { return _document; }
-
     /** If there is a document associated with this object then return the
     file name maintained by the document. Otherwise return an empty string. **/
     std::string getDocumentFileName() const;
+
+    /** If there is a document associated with this object then return its
+        version number. For example this is 30000 for OpenSim 3.x documents 
+        and is 305xx for OpenSim 4.0 beta and above. If there is no document
+        associated with the object, the method returns -1.*/
+    int getDocumentFileVersion() const;
+
     void setAllPropertiesUseDefault(bool aUseDefault);
 
     /** Write this %Object into an XML file of the given name; conventionally