jvmfwk/inc/elements.hxx

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   5  * This Source Code Form is subject to the terms of the Mozilla Public
   6  * License, v. 2.0. If a copy of the MPL was not distributed with this
   7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
   8  *
   9  * This file incorporates work covered by the following license notice:
  10  *
  11  *   Licensed to the Apache Software Foundation (ASF) under one or more
  12  *   contributor license agreements. See the NOTICE file distributed
  13  *   with this work for additional information regarding copyright
  14  *   ownership. The ASF licenses this file to you under the Apache
  15  *   License, Version 2.0 (the "License"); you may not use this file
  16  *   except in compliance with the License. You may obtain a copy of
  17  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  18  */
  19 #ifndef INCLUDED_JVMFWK_SOURCE_ELEMENTS_HXX
  20 #define INCLUDED_JVMFWK_SOURCE_ELEMENTS_HXX
  21
  22 #include <sal/config.h>
  23
  24 #include <memory>
  25 #include <vector>
  26 #include <jvmfwk/framework.hxx>
  27 #include "fwkutil.hxx"
  28 #include <rtl/ustring.hxx>
  29 #include <rtl/byteseq.hxx>
  30 #include <libxml/parser.h>
  31 #include <boost/optional.hpp>
  32
  33 #define NS_JAVA_FRAMEWORK "http://openoffice.org/2004/java/framework/1.0"
  34 #define NS_SCHEMA_INSTANCE "http://www.w3.org/2001/XMLSchema-instance"
  35
  36 namespace jfw
  37 {
  38
  39 /** gets the value of the updated element from the javavendors.xml.
  40  */
  41 OString getElementUpdated();
  42
  43 /** create the child elements within the root structure for each platform.
  44
  45     @param bNeedsSave
  46     [out]If true then the respective structure of elements was added and the
  47     document needs to be saved.
  48  */
  49 void createSettingsStructure(
  50     xmlDoc * document, bool * bNeedsSave);
  51
  52
  53 /** represents the settings saved in the /java/javaInfo element.
  54     It is used within class NodeJava which determines the settings
  55     file.
  56 */
  57 class CNodeJavaInfo
  58 {
  59 public:
  60     CNodeJavaInfo();
  61
  62     /** if true, then javaInfo is empty. When writeToNode is called
  63         then all child elements are deleted.
  64      */
  65     bool m_bEmptyNode;
  66     /** Contains the value of the <updated> element of
  67         the javavendors.xml after loadFromNode was called.
  68         It is not used, when the javaInfo node is written.
  69         see writeToNode
  70      */
  71     OString sAttrVendorUpdate;
  72     /** contains the nil value of the /java/javaInfo@xsi:nil attribute.
  73         Default is true;
  74      */
  75     bool bNil;
  76     /** contains the value of the /java/javaInfo@autoSelect attribute.
  77         Default is true. If it is false then the user has modified the JRE
  78         selection by actively choosing a JRE from the options dialog. That is,
  79         the function jfw_setSelectedJRE was called. Contrary, the function
  80         jfw_findAndSelectJRE sets the attribute to true.
  81      */
  82     bool bAutoSelect;
  83     OUString sVendor;
  84     OUString sLocation;
  85     OUString sVersion;
  86     sal_uInt64 nFeatures;
  87     sal_uInt64 nRequirements;
  88     ::rtl::ByteSequence arVendorData;
  89
  90     /** reads the node /java/javaInfo.
  91         If javaInfo@xsi:nil = true then member bNil is set to true
  92         an no further elements are read.
  93      */
  94     void loadFromNode(xmlDoc * pDoc,xmlNode * pJavaInfo);
  95     /** The attribute nil will be set to false. The function gets the value
  96         javaSettings/updated from the javavendors.xml and writes it to
  97         javaInfo@vendorUpdate in javasettings.xml
  98      */
  99     void writeToNode(xmlDoc * pDoc, xmlNode * pJavaInfo) const;
 100
 101     /** returns NULL if javaInfo is nil.
 102      */
 103     std::unique_ptr<JavaInfo> makeJavaInfo() const;
 104 };
 105
 106 /** this class represents the java settings  based on a particular
 107     settings file.
 108
 109     Which settings file is used is determined by the value passed into the
 110     constructor and the values of the bootstrap parameters
 111     UNO_JAVA_JFW_USER_DATA and UNO_JAVA_JFW_SHARED_DATA.
 112
 113     The method load reads the data from the settings file.
 114     The method write stores the data into the settings file.
 115  */
 116 class NodeJava
 117 {
 118 public:
 119     enum Layer { USER, SHARED };
 120 private:
 121
 122     /** creates settings file and fills it with default values.
 123
 124         When this function is called then it creates the
 125         settings file at the position determined by the bootstrap parameters
 126         (UNO_JAVA_JFW_USER_DATA, UNO_JAVA_JFW_SHARED_DATA) and m_layer, unless
 127         the file already exists (see createSettingsDocument).
 128
 129         @return
 130         JFW_E_CONFIG_READWRITE
 131     */
 132     bool prepareSettingsDocument() const;
 133
 134     /** helper function for prepareSettingsDocument.
 135     */
 136     bool createSettingsDocument() const;
 137
 138     /** returns the system path to the data file which is to be used. The value
 139         depends on the member m_layer and the bootstrap parameters
 140         UNO_JAVA_JFW_USER_DATA and UNO_JAVA_JFW_SHARED_DATA.
 141     */
 142     OString getSettingsPath() const;
 143
 144     /** returns the file URL to the data file which is to be used. See getSettingsPath.
 145     */
 146     OUString getSettingsURL() const;
 147
 148     /** Verifies if the respective settings file exist.
 149      */
 150     static jfw::FileStatus checkSettingsFileStatus(OUString const & sURL);
 151
 152     /** Determines the layer for which the instance the loads and writes the
 153         data.
 154     */
 155     Layer m_layer;
 156
 157     /** User configurable option.  /java/enabled
 158         If /java/enabled@xsi:nil == true then the value will be uninitialized
 159         after a call to load().
 160     */
 161     boost::optional<sal_Bool> m_enabled;
 162
 163     /** User configurable option. /java/userClassPath
 164         If /java/userClassPath@xsi:nil == true then the value is uninitialized
 165         after a call to load().
 166     */
 167     boost::optional< OUString> m_userClassPath;
 168     /** User configurable option.  /java/javaInfo
 169         If /java/javaInfo@xsi:nil == true then the value is uninitialized
 170         after a call to load.
 171      */
 172     boost::optional<CNodeJavaInfo> m_javaInfo;
 173     /** User configurable option. /java/vmParameters
 174         If /java/vmParameters@xsi:nil == true then the value is uninitialized
 175         after a call to load.
 176     */
 177     boost::optional< ::std::vector< OUString> > m_vmParameters;
 178     /** User configurable option. /java/jreLocations
 179         If /java/jreLocaltions@xsi:nil == true then the value is uninitialized
 180         after a call to load.
 181     */
 182     boost::optional< ::std::vector< OUString> > m_JRELocations;
 183
 184 public:
 185
 186     explicit NodeJava(Layer theLayer);
 187
 188     /** sets m_enabled.
 189         /java/enabled@xsi:nil will be set to false when write is called.
 190      */
 191     void setEnabled(bool bEnabled);
 192
 193     /** sets m_sUserClassPath. See setEnabled.
 194      */
 195     void setUserClassPath(const OUString & sClassPath);
 196
 197     /** sets m_aInfo. See setEnabled.
 198         @param bAutoSelect
 199         true- called by jfw_setSelectedJRE
 200         false called by jfw_findAndSelectJRE
 201      */
 202     void setJavaInfo(const JavaInfo * pInfo, bool bAutoSelect);
 203
 204     /** sets the /java/vmParameters/param elements.
 205         When this method all previous values are removed and replaced
 206         by those in arParameters.
 207         /java/vmParameters@xsi:nil will be set to true when write() is
 208         called.
 209      */
 210     void setVmParameters(std::vector<OUString> const & arParameters);
 211
 212     /** adds a location to the already existing locations.
 213         Note: call load() before, then add the location and then call write().
 214     */
 215     void addJRELocation(OUString const & sLocation);
 216
 217     /** writes the data to user settings.
 218      */
 219     void write() const;
 220
 221     /** load the values of the settings file.
 222      */
 223     void load();
 224
 225     /** returns the value of the element /java/enabled
 226      */
 227     const boost::optional<sal_Bool> & getEnabled() const { return m_enabled;}
 228     /** returns the value of the element /java/userClassPath.
 229      */
 230     const boost::optional< OUString> & getUserClassPath() const { return m_userClassPath;}
 231
 232     /** returns the value of the element /java/javaInfo.
 233      */
 234     const boost::optional<CNodeJavaInfo> & getJavaInfo() const { return m_javaInfo;}
 235
 236     /** returns the parameters from the element /java/vmParameters/param.
 237      */
 238     const boost::optional< ::std::vector< OUString> > & getVmParameters() const { return m_vmParameters;}
 239
 240     /** returns the parameters from the element /java/jreLocations/location.
 241      */
 242     const boost::optional< ::std::vector< OUString> > & getJRELocations() const { return m_JRELocations;}
 243 };
 244
 245 /** merges the settings for shared, user and installation during construction.
 246     The class uses a simple merge mechanism for the javasettings.xml files in share and
 247     user. The following elements completely overwrite the corresponding elements
 248     from share:
 249     /java/enabled
 250     /java/userClassPath
 251     /java/vmParameters
 252     /java/jreLocations
 253     /java/javaInfo
 254
 255     In case of an installation, the shared and user settings are completely
 256     disregarded.
 257
 258     The locations of the different settings files is obtained through the
 259     bootstrap variables:
 260     UNO_JAVA_JFW_USER_DATA
 261     UNO_JAVA_JFW_SHARED_DATA
 262
 263     The class also determines useful default values for settings which have not been made.
 264 */
 265 class MergedSettings final
 266 {
 267 private:
 268     MergedSettings& operator = (MergedSettings const &) = delete;
 269     MergedSettings(MergedSettings const &) = delete;
 270
 271     void merge(const NodeJava & share, const NodeJava & user);
 272
 273     bool m_bEnabled;
 274
 275     OUString m_sClassPath;
 276
 277     ::std::vector< OUString> m_vmParams;
 278
 279     ::std::vector< OUString> m_JRELocations;
 280
 281     CNodeJavaInfo m_javaInfo;
 282
 283 public:
 284     MergedSettings();
 285     ~MergedSettings();
 286
 287     /** the default is true.
 288      */
 289     bool getEnabled() const { return m_bEnabled;}
 290
 291     const OUString & getUserClassPath() const { return m_sClassPath;}
 292
 293     ::std::vector< OString> getVmParametersUtf8() const;
 294     /** returns a JavaInfo structure representing the node
 295         /java/javaInfo. Every time a new JavaInfo structure is created
 296         which needs to be freed by the caller.
 297         If both, user and share settings are nil, then NULL is returned.
 298     */
 299     std::unique_ptr<JavaInfo> createJavaInfo() const;
 300
 301     /** returns the value of the attribute /java/javaInfo[@vendorUpdate].
 302      */
 303     OString const & getJavaInfoAttrVendorUpdate() const { return m_javaInfo.sAttrVendorUpdate;}
 304
 305 #ifdef _WIN32
 306     /** returns the javaInfo@autoSelect attribute.
 307         Before calling this function loadFromSettings must be called.
 308         It uses the javaInfo@autoSelect attribute  to determine
 309         the return value;
 310      */
 311     bool getJavaInfoAttrAutoSelect() const;
 312 #endif
 313
 314     void getVmParametersArray(std::vector<OUString> * parParameters) const;
 315
 316     const ::std::vector< OUString> & getJRELocations() const { return m_JRELocations;}
 317 };
 318
 319
 320 struct VersionInfo
 321 {
 322     ::std::vector< OUString> vecExcludeVersions;
 323     OUString sMinVersion;
 324     OUString sMaxVersion;
 325 };
 326
 327 } //end namespace
 328 #endif
 329
 330 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */