CredentialParams class
Contains credentials to authenticate against external services. They are used together with connection parameters, but usually stored in a separate store, protected from unauthorized access.
Configuration parameters
store_key
: key to retrieve parameters from credential storeusername
: user nameuser
: alternative to usernamepassword
: user passwordpass
: alternative to passwordaccess_id
: application access idclient_id
: alternative to access_idaccess_key
: application secret keyclient_key
: alternative to access_keysecret_key
: alternative to access_key
In addition to standard parameters CredentialParams may contain any number of custom parameters
See https://rawgit.com/pip-services-node/pip-services3-commons-node/master/doc/api/classes/config.configparams.html ConfigParams
See ConnectionParams
See CredentialResolver
See ICredentialStore
Example
var credential = CredentialParams.fromTuples(
'user', 'jdoe',
'pass', 'pass123',
'pin', '321'
);
var username = credential.getUsername(); // Result: 'jdoe'
var password = credential.getPassword(); // Result: 'pass123'
var pin = credential.getAsNullableString('pin'); // Result: 321
- Inheritance
- Object
- MapMixin<
String, String> - MapBase<
String, String> - CredentialParams
Constructors
- CredentialParams([dynamic values ])
- Creates a new credential parameters and fills it with values. [...]
Properties
-
entries
→ Iterable<
MapEntry< String, String> > -
The map entries of this.
read-only, inherited
- hashCode → int
-
The hash code for this object. [...]
read-only, inherited
- isEmpty → bool
-
Returns true if there is no key/value pair in the map.
read-only, inherited
- isNotEmpty → bool
-
Returns true if there is at least one key/value pair in the map.
read-only, inherited
-
keys
→ Iterable<
String> -
The keys of this. [...]
read-only, inherited
- length → int
-
The number of key/value pairs in the map.
read-only, inherited
- runtimeType → Type
-
A representation of the runtime type of the object.
read-only, inherited
-
values
→ Iterable<
String> -
The values of this. [...]
read-only, inherited
Methods
-
getAccessId(
) → String - Gets the application access id. The value can be stored in parameters 'access_id' pr 'client_id' [...]
-
getAccessKey(
) → String - Gets the application secret key. The value can be stored in parameters 'access_key', 'client_key' or 'secret_key'. [...]
-
getPassword(
) → String - Get the user password. The value can be stored in parameters 'password' or 'pass'. [...]
-
getStoreKey(
) → String -
Gets the key to retrieve these credentials from
CredentialStore
. If this key is null, than all parameters are already present. [...] -
getUsername(
) → String - Gets the user name. The value can be stored in parameters 'username' or 'user'. [...]
-
setAccessId(
String value) → void - Sets the application access id. [...]
-
setAccessKey(
String value) → void - Sets the application secret key. [...]
-
setPassword(
String value) → void - Sets the user password. [...]
-
setStoreKey(
String value) → void -
Sets the key to retrieve these parameters from
CredentialStore
. [...] -
setUsername(
String value) → void - Sets the user name. [...]
-
useCredentialStore(
) → bool -
Checks if these credential parameters shall be retrieved from
CredentialStore
. The credential parameters are redirected toCredentialStore
when store_key parameter is set. [...] -
addAll(
Map< String, String> other) → void -
Adds all key/value pairs of
other
to this map. [...]inherited -
addEntries(
Iterable< MapEntry< newEntries) → voidString, String> > -
Adds all key/value pairs of
newEntries
to this map. [...]inherited -
addSection(
String section, ConfigParams sectionParams) → void -
Adds parameters into this ConfigParams under specified section.
Keys for the new parameters are appended with section dot prefix. [...]
inherited
-
append(
dynamic map) → void -
Appends new elements to this map. [...]
inherited
-
cast<
RK, RV> () → Map< RK, RV> -
Provides a view of this map as having
RK
keys andRV
instances, if necessary. [...]inherited -
clear(
) → void -
Clears this map by removing all its elements.
inherited
-
clone(
) → dynamic -
Creates a binary clone of this object. [...]
inherited
-
containsKey(
Object key) → bool -
Returns true if this map contains the given
key
. [...]inherited -
containsValue(
Object value) → bool -
Returns true if this map contains the given
value
. [...]inherited -
forEach(
void action(String key String value)) → void -
Applies
f
to each key/value pair of the map. [...]inherited -
fromJson(
Map< String, dynamic> json) → void -
Returned JSON Map object from values of this object
inherited
-
get(
String key) → String -
Gets a map element specified by its key. [...]
inherited
-
getAsArray(
String key) → AnyValueArray -
Converts map element into an AnyValueArray or returns empty AnyValueArray if conversion is not possible. [...]
inherited
-
getAsArrayWithDefault(
String key, AnyValueArray defaultValue) → AnyValueArray -
Converts map element into an AnyValueArray or returns default value if conversion is not possible. [...]
inherited
-
getAsBoolean(
String key) → bool -
Converts map element into a boolean or returns false if conversion is not possible. [...]
inherited
-
getAsBooleanWithDefault(
String key, bool defaultValue) → bool -
Converts map element into a boolean or returns default value if conversion is not possible. [...]
inherited
-
getAsDateTime(
String key) → DateTime -
Converts map element into a DateTime or returns the current date if conversion is not possible. [...]
inherited
-
getAsDateTimeWithDefault(
String key, DateTime defaultValue) → DateTime -
Converts map element into a DateTime or returns default value if conversion is not possible. [...]
inherited
-
getAsDouble(
String key) → double -
Converts map element into a double or returns 0 if conversion is not possible. [...]
inherited
-
getAsDoubleWithDefault(
String key, double defaultValue) → double -
Converts map element into a double or returns default value if conversion is not possible. [...]
inherited
-
getAsDuration(
String key) → Duration -
Converts map element into a Duration or returns the current date if conversion is not possible. [...]
inherited
-
getAsDurationWithDefault(
String key, Duration defaultValue) → Duration -
Converts map element into a Duration or returns default value if conversion is not possible. [...]
inherited
-
getAsFloat(
String key) → double -
Converts map element into a float or returns 0 if conversion is not possible. [...]
inherited
-
getAsFloatWithDefault(
String key, double defaultValue) → double -
Converts map element into a flot or returns default value if conversion is not possible. [...]
inherited
-
getAsInteger(
String key) → int -
Converts map element into an integer or returns 0 if conversion is not possible. [...]
inherited
-
getAsIntegerWithDefault(
String key, int defaultValue) → int -
Converts map element into an integer or returns default value if conversion is not possible. [...]
inherited
-
getAsLong(
String key) → int -
Converts map element into a long or returns 0 if conversion is not possible. [...]
inherited
-
getAsLongWithDefault(
String key, int defaultValue) → int -
Converts map element into a long or returns default value if conversion is not possible. [...]
inherited
-
getAsMap(
String key) → AnyValueMap -
Converts map element into an AnyValueMap or returns empty AnyValueMap if conversion is not possible. [...]
inherited
-
getAsMapWithDefault(
String key, AnyValueMap defaultValue) → AnyValueMap -
Converts map element into an AnyValueMap or returns default value if conversion is not possible. [...]
inherited
-
getAsNullableArray(
String key) → AnyValueArray -
Converts map element into an AnyValueArray or returns null if conversion is not possible. [...]
inherited
-
getAsNullableBoolean(
String key) → bool -
Converts map element into a boolean or returns null if conversion is not possible. [...]
inherited
-
getAsNullableDateTime(
String key) → DateTime -
Converts map element into a DateTime or returns null if conversion is not possible. [...]
inherited
-
getAsNullableDouble(
String key) → double -
Converts map element into a double or returns null if conversion is not possible. [...]
inherited
-
getAsNullableDuration(
String key) → Duration -
Converts map element into a Duration or returns null if conversion is not possible. [...]
inherited
-
getAsNullableFloat(
String key) → double -
Converts map element into a float or returns null if conversion is not possible. [...]
inherited
-
getAsNullableInteger(
String key) → int -
Converts map element into an integer or returns null if conversion is not possible. [...]
inherited
-
getAsNullableLong(
String key) → int -
Converts map element into a long or returns null if conversion is not possible. [...]
inherited
-
getAsNullableMap(
String key) → AnyValueMap -
Converts map element into an AnyValueMap or returns null if conversion is not possible. [...]
inherited
-
getAsNullableString(
String key) → String -
Converts map element into a string or returns null if conversion is not possible. [...]
inherited
-
getAsNullableType<
T> (TypeCode type, String key) → T -
Converts map element into a value defined by specied typecode.
If conversion is not possible it returns null. [...]
inherited
-
getAsObject(
[String key = null ]) → dynamic -
Gets the value stored in map element without any conversions.
When element key is not defined it returns the entire map value. [...]
inherited
-
getAsString(
dynamic key) → String -
Converts map element into a string or returns '' if conversion is not possible. [...]
inherited
-
getAsStringWithDefault(
String key String defaultValue) → String -
Converts map element into a string or returns default value if conversion is not possible. [...]
inherited
-
getAsType<
T> (TypeCode type, String key) → T -
Converts map element into a value defined by specied typecode.
If conversion is not possible it returns default value for the specified type. [...]
inherited
-
getAsTypeWithDefault<
T> (TypeCode type, String key, T defaultValue) → T -
Converts map element into a value defined by specied typecode.
If conversion is not possible it returns default value. [...]
inherited
-
getAsValue(
String key) → AnyValue -
Converts map element into an AnyValue or returns an empty AnyValue if conversion is not possible. [...]
inherited
-
getKeys(
) → List< String> -
Gets keys of all elements stored in this map. [...]
inherited
-
getSection(
String section) → ConfigParams -
Gets parameters from specific section stored in this ConfigMap.
The section name is removed from parameter keys. [...]
inherited
-
getSectionNames(
) → List< String> -
Gets a list with all 1st level section names. [...]
inherited
-
getValue(
) → Map< String, String> -
Gets an map with values. [...]
inherited
-
innerValue(
) → dynamic -
Returned inner values in Map object
inherited
-
map<
K2, V2> (MapEntry< K2, V2> transform(String key String value)) → Map<K2, V2> -
Returns a new map where all entries of this map are transformed by
the given
f
function.inherited -
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a non-existent method or property is accessed. [...]
inherited
-
override(
ConfigParams configParams) → ConfigParams -
Overrides parameters with new values from specified ConfigParams
and returns a new ConfigParams object. [...]
inherited
-
put(
String key, dynamic value) → void -
Puts a new value into map element specified by its key. [...]
inherited
-
putIfAbsent(
String key, String ifAbsent()) → String -
Look up the value of
key
, or add a new value if it isn't there. [...]inherited -
remove(
Object key) → String -
Removes
key
and its associated value, if present, from the map. [...]inherited -
removeWhere(
bool test(String key String value)) → void -
Removes all entries of this map that satisfy the given
predicate
.inherited -
setAsObject(
dynamic key, [ dynamic value = null ]) → void -
Sets a new value to map element specified by its index.
When the index is not defined, it resets the entire map value.
This method has double purpose because method overrides are not supported in JavaScript. [...]
inherited
-
setDefaults(
ConfigParams defaultConfigParams) → ConfigParams -
Set default values from specified ConfigParams and returns a new ConfigParams object. [...]
inherited
-
toJson(
) → Map< String, dynamic> -
Initialize this object from JSON Map object
inherited
-
toString(
) → String -
Gets a string representation of the object.
The result is a semicolon-separated list of key-value pairs as
'key1=value1;key2=value2;key=value3' [...]
inherited
-
update(
String key, String update(String value), { String ifAbsent() }) → String -
Updates the value for the provided
key
. [...]inherited -
updateAll(
String update(String key String value)) → void -
Updates all values. [...]
inherited
Operators
-
operator ==(
dynamic other) → bool -
The equality operator. [...]
inherited
-
operator [](
Object key) → String -
Returns the value for the given
key
or null ifkey
is not in the map. [...]inherited -
operator []=(
String key String value) → void -
Associates the
key
with the givenvalue
. [...]inherited
Static Methods
-
fromConfig(
ConfigParams config) → CredentialParams - Retrieves a single CredentialParams from configuration parameters from 'credential' section. If 'credentials' section is present instead, then is returns only the first credential element. [...]
-
fromString(
String line) → CredentialParams - Creates a new CredentialParams object filled with key-value pairs serialized as a string. [...]
-
fromTuples(
List tuples) → CredentialParams - Creates a new CredentialParams object filled with provided key-value pairs called tuples. Tuples parameters contain a sequence of key1, value1, key2, value2, ... pairs. [...]
-
manyFromConfig(
ConfigParams config) → List< CredentialParams> - Retrieves all CredentialParams from configuration parameters from 'credentials' section. If 'credential' section is present instead, than it returns a list with only one CredentialParams. [...]