protected Ini getSpecifiedIni(String[] configLocations) throws ConfigurationException {

        Ini ini = null;

        if (configLocations != null && configLocations.length > 0) {

            if (configLocations.length > 1) {
                LOGGER.warn("More than one Shiro .ini config location has been specified.  Only the first will be "
                        + "used for configuration as the {} implementation does not currently support multiple "
                        + "files.  This may be supported in the future however.", IniWebEnvironment.class.getName());
            }

            //required, as it is user specified:
            ini = createIni(configLocations[0], true);
        }

        return ini;
    }
Extension point to allow subclasses to provide an {@link Ini} configuration that will be merged into the
users configuration.  The users configuration will override anything set here.
<p>
<strong>NOTE:</strong> Framework developers should use with caution. It is possible a user could provide
configuration that would conflict with the frameworks configuration.  For example: if this method returns an
Ini object with the following configuration:
<pre><code>
    [main]
    realm = com.myco.FoobarRealm
    realm.foobarSpecificField = A string
</code></pre>
And the user provides a similar configuration:
<pre><code>
    [main]
    realm = net.differentco.MyCustomRealm
</code></pre>
<p>
This would merge into:
<pre><code>
    [main]
    realm = net.differentco.MyCustomRealm
    realm.foobarSpecificField = A string
</code></pre>
<p>
This may cause a configuration error if <code>MyCustomRealm</code
does not contain the field <code>foobarSpecificField</code>.
This can be avoided if the Framework Ini uses more unique names, such as <code>foobarRealm</code>. which would result
in a merged configuration that looks like:
<pre><code>
    [main]
    foobarRealm = com.myco.FoobarRealm
    foobarRealm.foobarSpecificField = A string
    realm = net.differentco.MyCustomRealm
</code></pre>

</p>

@return Ini configuration used by the framework integrations.
@since 1.4
web/src/main/java/org/apache/shiro/web/env/IniWebEnvironment.java