AOO410/main/jvmfwk/source/elements.hxx - openoffice - Git at Google

 /**************************************************************
  *
  * Licensed to the Apache Software Foundation (ASF) under one
  * or more contributor license agreements.  See the NOTICE file
  * distributed with this work for additional information
  * regarding copyright ownership.  The ASF licenses this file
  * to you under the Apache License, Version 2.0 (the
  * "License"); you may not use this file except in compliance
  * with the License.  You may obtain a copy of the License at
  *
  *   http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing,
  * software distributed under the License is distributed on an
  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
  * KIND, either express or implied.  See the License for the
  * specific language governing permissions and limitations
  * under the License.
  *
  *************************************************************/


 #if !defined INCLUDED_JVMFWK_ELEMENTS_HXX
 #define INCLUDED_JVMFWK_ELEMENTS_HXX

 #include <vector>
 #include "jvmfwk/framework.h"
 #include "fwkutil.hxx"
 #include "rtl/ustring.hxx"
 #include "rtl/byteseq.hxx"
 #include "libxml/parser.h"
 #include "boost/optional.hpp"

 #define NS_JAVA_FRAMEWORK "http://openoffice.org/2004/java/framework/1.0"
 #define NS_SCHEMA_INSTANCE "http://www.w3.org/2001/XMLSchema-instance"

 namespace jfw
 {

 /** gets the value of the updated element from the javavendors.xml.
  */
 rtl::OString getElementUpdated();

 /** create the child elements within the root structure for each platform.

     @param bNeedsSave
     [out]If true then the respective structure of elements was added and the
     document needs to be saved.
  */
 void createSettingsStructure(
     xmlDoc * document, bool * bNeedsSave);


 /** represents the settings saved in the /java/javaInfo element.
     It is used within class NodeJava which determines the settings
     file.
 */
 class CNodeJavaInfo
 {
 public:
     CNodeJavaInfo();
     ~CNodeJavaInfo();

     /** if true, then javaInfo is empty. When writeToNode is called
         then all child elements are deleted.
      */
     bool m_bEmptyNode;
     /** Contains the value of the <updated> element of
         the javavendors.xml after loadFromNode was called.
         It is not used, when the javaInfo node is written.
         see writeToNode
      */
     ::rtl::OString sAttrVendorUpdate;
     /** contains the nil value of the /java/javaInfo@xsi:nil attribute.
         Default is true;
      */
     bool bNil;
     /** contains the value of the /java/javaInfo@autoSelect attribute.
         Default is true. If it is false then the user has modified the JRE
         selection by actively choosing a JRE from the options dialog. That is,
         the function jfw_setSelectedJRE was called. Contrary, the function
         jfw_findAndSelectJRE sets the attribute to true.
      */
     bool bAutoSelect;
     ::rtl::OUString sVendor;
     ::rtl::OUString sLocation;
     ::rtl::OUString sVersion;
     sal_uInt64 nFeatures;
     sal_uInt64 nRequirements;
     ::rtl::ByteSequence arVendorData;

     /** reads the node /java/javaInfo.
         If javaInfo@xsi:nil = true then member bNil is set to true
         an no further elements are read.
      */
     void loadFromNode(xmlDoc * pDoc,xmlNode * pJavaInfo);
     /** The attribut nil will be set to false. The function gets the value
         javaSettings/updated from the javavendors.xml and writes it to
         javaInfo@vendorUpdate in javasettings.xml
      */
     void writeToNode(xmlDoc * pDoc, xmlNode * pJavaInfo) const;

     /** returns NULL if javaInfo is nil.
      */
     JavaInfo * makeJavaInfo() const;
 };

 /** this class represents the java settings  based on a particular
     settings file.

     Which settings file is used is determined by the value passed into the
     constructo and the values of the bootstrap parameters UNO_JAVA_JFW_USER_DATA,
     UNO_JAVA_JFW_SHARED_DATA,_JAVA_JFW_INSTALL_DATA.

     If the value is USER_OR_INSTALL then it depends of the bootstrap parameter
     UNO_JAVA_JFW_INSTALL_DATA. If it has as value then it is used. Otherwise the
     value from UNO_JAVA_JFW_USER_DATA is used.

     The method load reads the data from the settings file.
     The method write stores the data into the settings file.
  */
 class NodeJava
 {
 public:
     enum Layer { USER_OR_INSTALL, USER, SHARED, INSTALL };
 private:

     /** creates settings file and fills it with default values.

         When this function is called then it creates the
         settings file at the possition determined by the bootstrap parameters
         (UNO_JAVA_JFW_USER_DATA, UNO_JAVA_JFW_SHARED_DATA,
         UNO_JAVA_JFW_INSTALL_DATA) and m_layer, unless the file already exists
         (see createSettingsDocument).

         @return
         JFW_E_CONFIG_READWRITE
     */
     void prepareSettingsDocument() const;

     /** helper function for prepareSettingsDocument.
     */
     void createSettingsDocument() const;

     /** returns the system path to the data file which is to be used. The value
         depends on
         the the member m_layer and the bootstrap paramters UNO_JAVA_JFW_USER_DATA,
         UNO_JAVA_JFW_SHARED_DATA and UNO_JAVA_JFW_INSTALL_DATA which this may be.
     */
     ::rtl::OString getSettingsPath() const;

     /** returns the file URL to the data file which is to be used. See getSettingsPath.
     */
     ::rtl::OUString getSettingsURL() const;

     /** Verifies if the respective settings file exist. In case UNO_JAVA_JFW_INSTALL_DATA
         is used, the age is checked. If the file is too old then we assume that it does not
         exist and wipe its contents. Then still FILE_DOES_NOT_EXIST is returned.
      */
     jfw::FileStatus checkSettingsFileStatus() const;

     /** Determines the layer for which the instance the loads and writes the
         data.
     */
     Layer m_layer;

     /** User configurable option.  /java/enabled
         If /java/enabled@xsi:nil == true then the value will be uninitialized
         after a call to load().
     */
     boost::optional<sal_Bool> m_enabled;

     /** User configurable option. /java/userClassPath
         If /java/userClassPath@xsi:nil == true then the value is uninitialized
         after a call to load().
     */
     boost::optional< ::rtl::OUString> m_userClassPath;
     /** User configurable option.  /java/javaInfo
         If /java/javaInfo@xsi:nil == true then the value is uninitialized
         after a call to load.
      */
     boost::optional<CNodeJavaInfo> m_javaInfo;
     /** User configurable option. /java/vmParameters
         If /java/vmParameters@xsi:nil == true then the value is uninitialized
         after a call to load.
     */
     boost::optional< ::std::vector< ::rtl::OUString> > m_vmParameters;
     /** User configurable option. /java/jreLocations
         If /java/jreLocaltions@xsi:nil == true then the value is uninitialized
         after a call to load.
     */
     boost::optional< ::std::vector< ::rtl::OUString> > m_JRELocations;

     /** Only in INSTALL mode. Then NodeJava.write writes a <modified> element
         which contains the seconds value of the TimeValue (osl/time.h), obtained
         with osl_getSystemTime.
         It returns 0 if the value cannot be obtained.
         This is used to fix the problem that the modified time of the settings
         file is incorrect because it resides on an NFS volume where the NFS
         server and NFS client do not have the same system time. For example if
         the server time is ahead of the client time then checkSettingsFileStatus
         deleted the settings. So even if javaldx determined a Java
         (jfw_findAndSelectJRE) then jfw_startVM returned a JFW_E_NO_SELECT. Then
         it looked again for a java by calling jfw_findAndSelectJRE, which
         returned a JFW_E_NONE. But the following jfw_startVM returned again
         JFW_E_NO_SELECT. So it looped. (see issue i114509)

         NFS server and NFS client should have the same time. It is common
         practise to enforce this in networks. We actually should not work
         around a malconfigured network. We must however, make sure that we do
         not loop. Maybe a better approach is, that:
         - assume that mtime and system time are reliable
         - checkSettingsFile uses system time and mtime of the settings file,
         instset of using getModifiedTime.
         - allow a small error margin
         - jfw_startVM must return a JFW_E_EXPIRED_SETTINGS
         - XJavaVM::startVM should prevent the loop by processing the new return+        value

     */
     sal_uInt32 getModifiedTime() const;

 public:

     NodeJava(Layer theLayer = USER_OR_INSTALL);

     /** sets m_enabled.
         /java/enabled@xsi:nil will be set to false when write is called.
      */
     void setEnabled(sal_Bool bEnabled);

     /** sets m_sUserClassPath. See setEnabled.
      */
     void setUserClassPath(const ::rtl::OUString & sClassPath);

     /** sets m_aInfo. See setEnabled.
         @param bAutoSelect
         true- called by jfw_setSelectedJRE
         false called by jfw_findAndSelectJRE
      */
     void setJavaInfo(const JavaInfo * pInfo, bool bAutoSelect);

     /** sets the /java/vmParameters/param elements.
         When this method all previous values are removed and replaced
         by those in arParameters.
         /java/vmParameters@xsi:nil will be set to true when write() is
         called.
      */
     void setVmParameters(rtl_uString  * * arParameters, sal_Int32 size);

     /** sets the /java/jreLocations/location elements.
         When this method is called then all previous values are removed
         and replaced by those in arParamters.
         /java/jreLocations@xsi:nil will be set to true write() is called.
      */
     void setJRELocations(rtl_uString  * * arParameters, sal_Int32 size);

     /** adds a location to the already existing locations.
         Note: call load() before, then add the location and then call write().
     */
     void addJRELocation(rtl_uString * sLocation);

     /** writes the data to user settings.
      */
     void write() const;

     /** load the values of the settings file.
      */
     void load();

     /** returns the value of the element /java/enabled
      */
     const boost::optional<sal_Bool> & getEnabled() const;
     /** returns the value of the element /java/userClassPath.
      */
     const boost::optional< ::rtl::OUString> & getUserClassPath() const;

     /** returns the value of the element /java/javaInfo.
      */
     const boost::optional<CNodeJavaInfo> & getJavaInfo() const;

     /** returns the parameters from the element /java/vmParameters/param.
      */
     const boost::optional< ::std::vector< ::rtl::OUString> > & getVmParameters() const;

     /** returns the parameters from the element /java/jreLocations/location.
      */
     const boost::optional< ::std::vector< ::rtl::OUString> > & getJRELocations() const;
 };

 /** merges the settings for shared, user and installation during construction.
     The class uses a simple merge mechanism for the javasettings.xml files in share and
     user. The following elements completly overwrite the corresponding elements
     from share:
     /java/enabled
     /java/userClassPath
     /java/vmParameters
     /java/jreLocations
     /java/javaInfo

     In case of an installation, the shared and user settings are completely
     disregarded.

     The locations of the different settings files is obtained through the
     bootstrap variables:
     UNO_JAVA_JFW_USER_DATA
     UNO_JAVA_JFW_SHARED_DATA
     UNO_JAVA_JFW_INSTALL_DATA

     The class also determines useful default values for settings which have not been made.
 */
 class MergedSettings
 {
 private:
     const MergedSettings& operator = (MergedSettings&);
     MergedSettings(MergedSettings&);

     void merge(const NodeJava & share, const NodeJava & user);

     sal_Bool m_bEnabled;

     ::rtl::OUString m_sClassPath;

     ::std::vector< ::rtl::OUString> m_vmParams;

     ::std::vector< ::rtl::OUString> m_JRELocations;

     CNodeJavaInfo m_javaInfo;

 public:
     MergedSettings();
     virtual ~MergedSettings();

     /** the default is true.
      */
     sal_Bool getEnabled() const;

     const ::rtl::OUString & getUserClassPath() const;

     ::std::vector< ::rtl::OString> getVmParametersUtf8() const;
     /** returns a JavaInfo structure representing the node
         /java/javaInfo. Every time a new JavaInfo structure is created
         which needs to be freed by the caller.
         If both, user and share settings are nil, then NULL is returned.
     */
     JavaInfo * createJavaInfo() const;

     /** returns the value of the attribute /java/javaInfo[@vendorUpdate].
      */
     ::rtl::OString const & getJavaInfoAttrVendorUpdate() const;

 #ifdef WNT
     /** returns the javaInfo@autoSelect attribute.
         Before calling this function loadFromSettings must be called.
         It uses the javaInfo@autoSelect attribute  to determine
         the return value;
      */
     bool getJavaInfoAttrAutoSelect() const;
 #endif

     /** returns an array.
         Caller must free the strings and the array.
      */
     void getVmParametersArray(rtl_uString *** parParameters, sal_Int32 * size) const;

     /** returns an array.
         Caller must free the strings and the array.
      */
     void getJRELocations(rtl_uString *** parLocations, sal_Int32 * size) const;

     const ::std::vector< ::rtl::OUString> & getJRELocations() const;
 };


 class VersionInfo
 {
     ::std::vector< ::rtl::OUString> vecExcludeVersions;
     rtl_uString ** arVersions;

 public:
     VersionInfo();
     ~VersionInfo();

     void addExcludeVersion(const ::rtl::OUString& sVersion);

     ::rtl::OUString sMinVersion;
     ::rtl::OUString sMaxVersion;

     /** The caller DOES NOT get ownership of the strings. That is he
         does not need to release the strings.
         The array exists as long as this object exists.
     */

     rtl_uString** getExcludeVersions();
     sal_Int32 getExcludeVersionSize();
 };

 struct PluginLibrary
 {
     PluginLibrary()
     {
     }
     PluginLibrary(rtl::OUString vendor,::rtl::OUString path) :
         sVendor(vendor), sPath(path)
     {
     }
     /** contains the vendor string which is later userd in the xml API
      */
     ::rtl::OUString sVendor;
     /** File URL the plug-in library
      */
     ::rtl::OUString sPath;
 };

 } //end namespace
 #endif
	/**************************************************************
	*
	* Licensed to the Apache Software Foundation (ASF) under one
	* or more contributor license agreements. See the NOTICE file
	* distributed with this work for additional information
	* regarding copyright ownership. The ASF licenses this file
	* to you under the Apache License, Version 2.0 (the
	* "License"); you may not use this file except in compliance
	* with the License. You may obtain a copy of the License at
	*
	* http://www.apache.org/licenses/LICENSE-2.0
	*
	* Unless required by applicable law or agreed to in writing,
	* software distributed under the License is distributed on an
	* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
	* KIND, either express or implied. See the License for the
	* specific language governing permissions and limitations
	* under the License.
	*
	*************************************************************/


	#if !defined INCLUDED_JVMFWK_ELEMENTS_HXX
	#define INCLUDED_JVMFWK_ELEMENTS_HXX

	#include <vector>
	#include "jvmfwk/framework.h"
	#include "fwkutil.hxx"
	#include "rtl/ustring.hxx"
	#include "rtl/byteseq.hxx"
	#include "libxml/parser.h"
	#include "boost/optional.hpp"

	#define NS_JAVA_FRAMEWORK "http://openoffice.org/2004/java/framework/1.0"
	#define NS_SCHEMA_INSTANCE "http://www.w3.org/2001/XMLSchema-instance"

	namespace jfw
	{

	/** gets the value of the updated element from the javavendors.xml.
	*/
	rtl::OString getElementUpdated();

	/** create the child elements within the root structure for each platform.

	@param bNeedsSave
	[out]If true then the respective structure of elements was added and the
	document needs to be saved.
	*/
	void createSettingsStructure(
	xmlDoc * document, bool * bNeedsSave);


	/** represents the settings saved in the /java/javaInfo element.
	It is used within class NodeJava which determines the settings
	file.
	*/
	class CNodeJavaInfo
	{
	public:
	CNodeJavaInfo();
	~CNodeJavaInfo();

	/** if true, then javaInfo is empty. When writeToNode is called
	then all child elements are deleted.
	*/
	bool m_bEmptyNode;
	/** Contains the value of the <updated> element of
	the javavendors.xml after loadFromNode was called.
	It is not used, when the javaInfo node is written.
	see writeToNode
	*/
	::rtl::OString sAttrVendorUpdate;
	/** contains the nil value of the /java/javaInfo@xsi:nil attribute.
	Default is true;
	*/
	bool bNil;
	/** contains the value of the /java/javaInfo@autoSelect attribute.
	Default is true. If it is false then the user has modified the JRE
	selection by actively choosing a JRE from the options dialog. That is,
	the function jfw_setSelectedJRE was called. Contrary, the function
	jfw_findAndSelectJRE sets the attribute to true.
	*/
	bool bAutoSelect;
	::rtl::OUString sVendor;
	::rtl::OUString sLocation;
	::rtl::OUString sVersion;
	sal_uInt64 nFeatures;
	sal_uInt64 nRequirements;
	::rtl::ByteSequence arVendorData;

	/** reads the node /java/javaInfo.
	If javaInfo@xsi:nil = true then member bNil is set to true
	an no further elements are read.
	*/
	void loadFromNode(xmlDoc * pDoc,xmlNode * pJavaInfo);
	/** The attribut nil will be set to false. The function gets the value
	javaSettings/updated from the javavendors.xml and writes it to
	javaInfo@vendorUpdate in javasettings.xml
	*/
	void writeToNode(xmlDoc * pDoc, xmlNode * pJavaInfo) const;

	/** returns NULL if javaInfo is nil.
	*/
	JavaInfo * makeJavaInfo() const;
	};

	/** this class represents the java settings based on a particular
	settings file.

	Which settings file is used is determined by the value passed into the
	constructo and the values of the bootstrap parameters UNO_JAVA_JFW_USER_DATA,
	UNO_JAVA_JFW_SHARED_DATA,_JAVA_JFW_INSTALL_DATA.

	If the value is USER_OR_INSTALL then it depends of the bootstrap parameter
	UNO_JAVA_JFW_INSTALL_DATA. If it has as value then it is used. Otherwise the
	value from UNO_JAVA_JFW_USER_DATA is used.

	The method load reads the data from the settings file.
	The method write stores the data into the settings file.
	*/
	class NodeJava
	{
	public:
	enum Layer { USER_OR_INSTALL, USER, SHARED, INSTALL };
	private:

	/** creates settings file and fills it with default values.

	When this function is called then it creates the
	settings file at the possition determined by the bootstrap parameters
	(UNO_JAVA_JFW_USER_DATA, UNO_JAVA_JFW_SHARED_DATA,
	UNO_JAVA_JFW_INSTALL_DATA) and m_layer, unless the file already exists
	(see createSettingsDocument).

	@return
	JFW_E_CONFIG_READWRITE
	*/
	void prepareSettingsDocument() const;

	/** helper function for prepareSettingsDocument.
	*/
	void createSettingsDocument() const;

	/** returns the system path to the data file which is to be used. The value
	depends on
	the the member m_layer and the bootstrap paramters UNO_JAVA_JFW_USER_DATA,
	UNO_JAVA_JFW_SHARED_DATA and UNO_JAVA_JFW_INSTALL_DATA which this may be.
	*/
	::rtl::OString getSettingsPath() const;

	/** returns the file URL to the data file which is to be used. See getSettingsPath.
	*/
	::rtl::OUString getSettingsURL() const;

	/** Verifies if the respective settings file exist. In case UNO_JAVA_JFW_INSTALL_DATA
	is used, the age is checked. If the file is too old then we assume that it does not
	exist and wipe its contents. Then still FILE_DOES_NOT_EXIST is returned.
	*/
	jfw::FileStatus checkSettingsFileStatus() const;

	/** Determines the layer for which the instance the loads and writes the
	data.
	*/
	Layer m_layer;

	/** User configurable option. /java/enabled
	If /java/enabled@xsi:nil == true then the value will be uninitialized
	after a call to load().
	*/
	boost::optional<sal_Bool> m_enabled;

	/** User configurable option. /java/userClassPath
	If /java/userClassPath@xsi:nil == true then the value is uninitialized
	after a call to load().
	*/
	boost::optional< ::rtl::OUString> m_userClassPath;
	/** User configurable option. /java/javaInfo
	If /java/javaInfo@xsi:nil == true then the value is uninitialized
	after a call to load.
	*/
	boost::optional<CNodeJavaInfo> m_javaInfo;
	/** User configurable option. /java/vmParameters
	If /java/vmParameters@xsi:nil == true then the value is uninitialized
	after a call to load.
	*/
	boost::optional< ::std::vector< ::rtl::OUString> > m_vmParameters;
	/** User configurable option. /java/jreLocations
	If /java/jreLocaltions@xsi:nil == true then the value is uninitialized
	after a call to load.
	*/
	boost::optional< ::std::vector< ::rtl::OUString> > m_JRELocations;

	/** Only in INSTALL mode. Then NodeJava.write writes a <modified> element
	which contains the seconds value of the TimeValue (osl/time.h), obtained
	with osl_getSystemTime.
	It returns 0 if the value cannot be obtained.
	This is used to fix the problem that the modified time of the settings
	file is incorrect because it resides on an NFS volume where the NFS
	server and NFS client do not have the same system time. For example if
	the server time is ahead of the client time then checkSettingsFileStatus
	deleted the settings. So even if javaldx determined a Java
	(jfw_findAndSelectJRE) then jfw_startVM returned a JFW_E_NO_SELECT. Then
	it looked again for a java by calling jfw_findAndSelectJRE, which
	returned a JFW_E_NONE. But the following jfw_startVM returned again
	JFW_E_NO_SELECT. So it looped. (see issue i114509)

	NFS server and NFS client should have the same time. It is common
	practise to enforce this in networks. We actually should not work
	around a malconfigured network. We must however, make sure that we do
	not loop. Maybe a better approach is, that:
	- assume that mtime and system time are reliable
	- checkSettingsFile uses system time and mtime of the settings file,
	instset of using getModifiedTime.
	- allow a small error margin
	- jfw_startVM must return a JFW_E_EXPIRED_SETTINGS
	- XJavaVM::startVM should prevent the loop by processing the new return+ value

	*/
	sal_uInt32 getModifiedTime() const;

	public:

	NodeJava(Layer theLayer = USER_OR_INSTALL);

	/** sets m_enabled.
	/java/enabled@xsi:nil will be set to false when write is called.
	*/
	void setEnabled(sal_Bool bEnabled);

	/** sets m_sUserClassPath. See setEnabled.
	*/
	void setUserClassPath(const ::rtl::OUString & sClassPath);

	/** sets m_aInfo. See setEnabled.
	@param bAutoSelect
	true- called by jfw_setSelectedJRE
	false called by jfw_findAndSelectJRE
	*/
	void setJavaInfo(const JavaInfo * pInfo, bool bAutoSelect);

	/** sets the /java/vmParameters/param elements.
	When this method all previous values are removed and replaced
	by those in arParameters.
	/java/vmParameters@xsi:nil will be set to true when write() is
	called.
	*/
	void setVmParameters(rtl_uString * * arParameters, sal_Int32 size);

	/** sets the /java/jreLocations/location elements.
	When this method is called then all previous values are removed
	and replaced by those in arParamters.
	/java/jreLocations@xsi:nil will be set to true write() is called.
	*/
	void setJRELocations(rtl_uString * * arParameters, sal_Int32 size);

	/** adds a location to the already existing locations.
	Note: call load() before, then add the location and then call write().
	*/
	void addJRELocation(rtl_uString * sLocation);

	/** writes the data to user settings.
	*/
	void write() const;

	/** load the values of the settings file.
	*/
	void load();

	/** returns the value of the element /java/enabled
	*/
	const boost::optional<sal_Bool> & getEnabled() const;
	/** returns the value of the element /java/userClassPath.
	*/
	const boost::optional< ::rtl::OUString> & getUserClassPath() const;

	/** returns the value of the element /java/javaInfo.
	*/
	const boost::optional<CNodeJavaInfo> & getJavaInfo() const;

	/** returns the parameters from the element /java/vmParameters/param.
	*/
	const boost::optional< ::std::vector< ::rtl::OUString> > & getVmParameters() const;

	/** returns the parameters from the element /java/jreLocations/location.
	*/
	const boost::optional< ::std::vector< ::rtl::OUString> > & getJRELocations() const;
	};

	/** merges the settings for shared, user and installation during construction.
	The class uses a simple merge mechanism for the javasettings.xml files in share and
	user. The following elements completly overwrite the corresponding elements
	from share:
	/java/enabled
	/java/userClassPath
	/java/vmParameters
	/java/jreLocations
	/java/javaInfo

	In case of an installation, the shared and user settings are completely
	disregarded.

	The locations of the different settings files is obtained through the
	bootstrap variables:
	UNO_JAVA_JFW_USER_DATA
	UNO_JAVA_JFW_SHARED_DATA
	UNO_JAVA_JFW_INSTALL_DATA

	The class also determines useful default values for settings which have not been made.
	*/
	class MergedSettings
	{
	private:
	const MergedSettings& operator = (MergedSettings&);
	MergedSettings(MergedSettings&);

	void merge(const NodeJava & share, const NodeJava & user);

	sal_Bool m_bEnabled;

	::rtl::OUString m_sClassPath;

	::std::vector< ::rtl::OUString> m_vmParams;

	::std::vector< ::rtl::OUString> m_JRELocations;

	CNodeJavaInfo m_javaInfo;

	public:
	MergedSettings();
	virtual ~MergedSettings();

	/** the default is true.
	*/
	sal_Bool getEnabled() const;

	const ::rtl::OUString & getUserClassPath() const;

	::std::vector< ::rtl::OString> getVmParametersUtf8() const;
	/** returns a JavaInfo structure representing the node
	/java/javaInfo. Every time a new JavaInfo structure is created
	which needs to be freed by the caller.
	If both, user and share settings are nil, then NULL is returned.
	*/
	JavaInfo * createJavaInfo() const;

	/** returns the value of the attribute /java/javaInfo[@vendorUpdate].
	*/
	::rtl::OString const & getJavaInfoAttrVendorUpdate() const;

	#ifdef WNT
	/** returns the javaInfo@autoSelect attribute.
	Before calling this function loadFromSettings must be called.
	It uses the javaInfo@autoSelect attribute to determine
	the return value;
	*/
	bool getJavaInfoAttrAutoSelect() const;
	#endif

	/** returns an array.
	Caller must free the strings and the array.
	*/
	void getVmParametersArray(rtl_uString *** parParameters, sal_Int32 * size) const;

	/** returns an array.
	Caller must free the strings and the array.
	*/
	void getJRELocations(rtl_uString *** parLocations, sal_Int32 * size) const;

	const ::std::vector< ::rtl::OUString> & getJRELocations() const;
	};


	class VersionInfo
	{
	::std::vector< ::rtl::OUString> vecExcludeVersions;
	rtl_uString ** arVersions;

	public:
	VersionInfo();
	~VersionInfo();

	void addExcludeVersion(const ::rtl::OUString& sVersion);

	::rtl::OUString sMinVersion;
	::rtl::OUString sMaxVersion;

	/** The caller DOES NOT get ownership of the strings. That is he
	does not need to release the strings.
	The array exists as long as this object exists.
	*/

	rtl_uString** getExcludeVersions();
	sal_Int32 getExcludeVersionSize();
	};

	struct PluginLibrary
	{
	PluginLibrary()
	{
	}
	PluginLibrary(rtl::OUString vendor,::rtl::OUString path) :
	sVendor(vendor), sPath(path)
	{
	}
	/** contains the vendor string which is later userd in the xml API
	*/
	::rtl::OUString sVendor;
	/** File URL the plug-in library
	*/
	::rtl::OUString sPath;
	};

	} //end namespace
	#endif