The setProperty operation on the Properties interface sets a property to the specified value:
Slice
module Ice
{
local interface Properties
{
void setProperty(string key, string value);
// ...
}
}
You can clear a property by setting it to the empty string.
For properties that control the Ice run time and its services (that is, properties that start with one of the reserved prefixes), this operation is useful only if you call it before you call initialize. This is because property values are usually read by the Ice run time only once, when you call initialize, so the Ice run time does not pay attention to a property value that is changed after you have initialized a communicator. Of course, this begs the question of how you can set a property value and have it also recognized by a communicator.
To permit you to set properties before initializing a communicator, the Ice run time provides an overloaded helper function or method called createProperties that creates a property set.
createProperties is provided in all language mappings with overloads that accept the following parameters:
- no parameter at all
ThiscreatePropertiescreates an empty property set, and does not checkICE_CONFIGfor a configuration file to parse. - the arguments given to the application plus a default property set
ThiscreatePropertiesreturns a property set that contains all the property settings that are passed as the default, plus any property settings in the arguments. If the argument vector sets a property that is also set in the passed default property set, the setting in the argument vector overrides the default. It also looks for the--Ice.Configoption; if the argument vector specifies a configuration file, the configuration file is parsed. The order of precedence of property settings, from lowest to highest, is:- Property settings passed in the default parameter
- Property settings set in the configuration file
- Property settings in the argument vector (parsed as described in Command-Line Parsing and Initialization)
createPropertiesalso looks for the setting of theICE_CONFIGenvironment variable and, if that variable specifies a configuration file, parse that file. (However, an explicit--Ice.Configoption in the argument vector or thedefaultsparameter overrides any setting of theICE_CONFIGenvironment variable.) - the arguments given to the application
Thisinitializeis like the initialize in2.above, with an empty default property set.
namespace Ice
{
// (1): empty properties
std::shared_ptr<Properties> createProperties();
// (2) and (3): clone default properties parameter (if present) then parse args
std::shared_ptr<Properties> createProperties(int argc&, const char* argv[], const std::shared_ptr<Properties>& = nullptr);
std::shared_ptr<Properties> createProperties(StringSeq& args, const std::shared_ptr<Properties>& defaults = nullptr);
#ifdef _WIN32
// (2) and (3): clone default properties parameter (if present) then parse args
std::shared_ptr<Properties> createProperties(int argc&, const wchar_t* argv[], const std::shared_ptr<Properties>& defaults = nullptr);
#endif
}
namespace Ice
{
// (1): empty properties
PropertiesPtr createProperties();
// (2) and (3): clone default properties parameter (if present) then parse args
PropertiesPtr createProperties(int argc&, const char* argv[], const PropertiesPtr& = 0);
PropertiesPtr createProperties(StringSeq& args, const PropertiesPtr& defaults = 0);
#ifdef _WIN32
// (2) and (3): clone default properties parameter (if present) then parse args
PropertiesPtr createProperties(int argc&, const wchar_t* argv[], const PropertiesPtr& defaults = 0);
#endif
}
namespace Ice
{
public sealed class Util
{
// (1): empty properties
public static Properties createProperties() { ... }
// (2): clone default properties and then parse args
public static Properties createProperties(ref string[] args, Properties defaults) { ... }
// (3): parse args
public static Properties createProperties(ref string[] args) { ... }
}
}
package com.zeroc.Ice;
public final class Util
{
// (1): empty properties
public static Properties createProperties() { ... }
// (2): clone default properties and then parse args
public static Properties createProperties(String[] args, Properties defaults) { ... }
public static Properties createProperties(String[] args, Properties defaults, java.util.List<String> remainingArgs) { ... }
// (3): parse args
public static Properties createProperties(String[] args) { ... }
public static Properties createProperties(String[] args, java.util.List<String> remainingArgs) { ... }
// ...
}
package Ice;
public final class Util
{
// (1): empty properties
public static Properties createProperties() { ... }
// (2): clone default properties and then parse args
public static Properties createProperties(String[] args, Properties defaults) { ... }
public static Properties createProperties(StringSeqHolder args, Properties defaults) { ... }
// (3): parse args
public static Properties createProperties(String[] args) { ... }
public static Properties createProperties(StringSeqHolder args) { ... }
// ...
}
Ice.createProperties = function(args, defaults) { ... }
% in Ice package % Valid arguments: % % (1): no parameter at all, returns empty properties % props = Ice.createProperties(); % (2): clone default properties and then parse args (a cell array of character vectors) % [props, remainingArgs] = createProperties(args, defaults); % (3): parse args (a cell array of character vectors) % [props, remainingArgs] = createProperties(args); function [props, remainingArgs] = createProperties(varargin)
@interface ICEUtil : NSObject // (1): empty properties +(id<ICEProperties>) createProperties; // (3): parse args +(id<ICEProperties>) createProperties:(int*)argc argv:(char*[])argv; ... @end
namespace Ice
{
function createProperties(args=array(), defaults=null) { ... }
}
# in Ice module def createProperties(args=[], defaults=None)
module Ice
def createProperties(args=[], defaults=None)
Like initialize, createProperties strips Ice-related command-line options from the passed argument vector.
createProperties is useful if you want to ensure that a property is set to a particular value, regardless of any setting of that property in a configuration file or in the argument vector. Here is an example:
// Get the initialized property set.
//
auto props = Ice::createProperties(argc, argv);
// Make sure that network and protocol tracing are off.
//
props->setProperty("Ice.Trace.Network", "0");
props->setProperty("Ice.Trace.Protocol", "0");
// Initialize a communicator with these properties.
//
Ice::InitializationData initData;
initData.properties = props;
Ice::CommunicatorHolder ich(initData);
// Get the initialized property set.
//
com.zeroc.Ice.Properties props = com.zeroc.Ice.Util.createProperties(args);
// Make sure that network and protocol tracing are off.
//
props.setProperty("Ice.Warn.Connections", "0");
props.setProperty("Ice.Trace.Protocol", "0");
// Initialize a communicator with these properties.
//
com.zeroc.Ice.InitializationData initData = new com.zeroc.Ice.InitializationData();
initData.properties = props;
com.zeroc.Ice.Communicator communicator = com.zeroc.Ice.Util.initialize(initData);
% Get the initialized property set.
%
props = Ice.createProperties(args);
% Make sure that network and protocol tracing are off.
%
props.setProperty('Ice.Warn.Connections', '0');
props.setProperty('Ice.Trace.Protocol', '0');
% Initialize a communicator with these properties.
%
initData = Ice.InitializationData();
initData.properties_ = props;
communicator = Ice.initialize(initData);
// Get the initialized property set.
//
$props = Ice\createProperties($args);
// Make sure that network and protocol tracing are off.
//
$props->setProperty("Ice.Trace.Network", "0");
$props->setProperty("Ice.Trace.Protocol", "0");
// Initialize a communicator with these properties.
//
$initData = new Ice\InitializationData();
$initData->properties = $props;
$communicator = Ice\initialize($initData);
# Get the initialized property set.
#
props = Ice.createProperties(sys.argv)
# Make sure that network and protocol tracing are off.
#
props.setProperty("Ice.Trace.Network", "0")
props.setProperty("Ice.Trace.Protocol", "0")
# Initialize a communicator with these properties.
#
initData = Ice.InitializationData()
initData.properties = props
communicator = Ice.initialize(initData)
# Get the initialized property set.
#
props = Ice::createProperties(ARGV)
# Make sure that network and protocol tracing are off.
#
props.setProperty("Ice.Trace.Network", "0")
props.setProperty("Ice.Trace.Protocol", "0")
# Initialize a communicator with these properties.
#
initData = Ice::InitializationData.new
initData.properties = props
initData = Ice::initialize(initData)
You can also set properties "in bulk" remotely through the Properties facet of Ice Admin.