Hello everyone
I saw ManagedProperties mentioned so now I appear!
@Philipp.Hoefler if what you mean by complex types is that you want the
configuration admin to return some more advanced types like URLs Files or
Dates, then ManagedProperties will handle that for you. If not then stop
reading:)
If you want to use ManagedProperties and have questions, you can write me.
I am very talkative:)
ManagedProperties is made to handle mapping and propper handling of
advanced or complex types to the Configuration Admin. It works through the
java util Proxy as a middle layer, allowing an application to request
complex types like Dates or URLs while storing them as primitives and
Strings in the Configuration Admin.
In order to use a ManagedProperties, you register an annotated interface
with the ManagedProperties service, like so:
First you create the interface which will serve as your configuration
package my.package.config;
import dk.netdesign.common.osgi.config.annotation.Property;
import dk.netdesign.common.osgi.config.annotation.PropertyDefinition;
import dk.netdesign.common.osgi.config.exception.UnknownValueException;
@PropertyDefinition
public interface MyConfiguration {
@Property(type = String.class, typeMapper = ExistingFileFilter.class)
throws UnknownValueException
public File getExistingFile();
@Property(type = String.class, typeMapper = URLMapper.class) throws
UnknownValueException
public File getURL();
@Property
public String getUsername();
}
Then you register it with a bundle, either through an activator or through
Declarative Services
@Component
public class MyComponent {
ManagedPropertiesService mpRegistration;
MyConfiguration config;
@Activate
public void register(BundleContext context) throws
InstantiationException, IllegalAccessException, InvalidSyntaxException {
config = mpRegistration.register(MyConfiguration.class, context);
}
@Reference(cardinality = ReferenceCardinality.MANDATORY)
public void setManagedPropertiesService(ManagedPropertiesService
managedPropertiesService) throws Exception {
mpRegistration = managedPropertiesService;
}
}
This will create a configuration in the ConfigurationAdmin with 3
configurations, ExistingFile, URL and Username. Calling the getter methods
in the interface will return the current configuration, which means that it
will update if it gets changed in the WebConsole or anywhere else.
If you want you can pass a number of defaults with the config registration
like this:
config = mpRegistration.register(MyConfiguration.class, new
MyConfigurationDefaults(), context);
MyConfigurationDefaults is simply a class that implements the
MyConfiguration interface. The defaults come into play if no configuration
is found, for example if no configuration has been set yet, or if a single
configuration item was not set.
The Defaults class can do anything basically, if you want configuration
from a database or a webservice, it is possible.
This setup has the following advantages:
1. Since the Configuration is simply an interface it is easily tested
outside OSGi, by creating a setter or extra constructor for the interface.
Then you can simply pass whatever you want to the test, no need for
configuration admin or anything.
2. The defaults can be a powerful fallback for missing configuration.
3. When handling complex types, ManagedProperties can test the input and
fail the configuration update if something doesn't add up. This is very
useful for handling complex types, as you don't want to acidentally write
something that won't parse to what you want. For example, say you only want
to be able to specify files which actually exist.
public class ExistingFileFilter extends TypeFilter<String, File> {
@Override
public File parse(String input) throws TypeFilterException {
File f = new File(input);
try {
f.getCanonicalPath();
} catch (IOException ex) {
throw new TypeFilterException("Could not read the file '" +
input + "'. Could not resolve path: " + ex.getMessage(), ex);
}
return f;
}
@Override
public String revert(File input) throws TypeFilterException {
try {
return input.getCanonicalPath();
} catch (IOException ex) {
throw new TypeFilterException("Could not parse file", ex);
}
}
@Override
public void validate(File toValidate) throws TypeFilterException {
try {
String path = toValidate.getCanonicalPath();
if (!toValidate.exists()) {
throw new TypeFilterException("Could not parse file. The
file " + path + " did not exist");
}
} catch (IOException ex) {
throw new TypeFilterException("Could not read the file '" +
toValidate + "'. Could not resolve path: " + ex.getMessage(), ex);
}
}
}
If the configuration is updated with a filename that is either not a proper
filename, or the file does not exist on the system, the entire
configuration update will throw a ConfigurationUpdate and fail. Other use
cases could be propper URLS, or defining username/password combinations
which are actually valid.
ManagedProperties cannot currently create one return type based of several
configuration items. For example, say you have 3 configuration items:
Protocol, Host and Port, and you want that converted to single "getURL"
method. That is not CURRENTLY possible.
ManagedProperties has a few other cool features:
Callbacks:
You can register callback classes which are triggered when the
configuration is updated. This is very useful if you have something like a
Database connection, which only takes its configuration at construction
time.
Setters:
You can define matching setters on the interface getter methods. This will
allow you to change the configuration in the ConfigAdmin directly though
the application. This can be really useful if you want to give an
applcation admin power over the configuration for that application, but
aren't interested in allowing him full admin access to the container.
Wicket Integration:
A special page has been created for Wicket which can present the
configuration of a select configuration PID, which will make an
application-specific configuration page that much easier to implement.
On Thu, Jul 12, 2018 at 6:22 PM, Raymond Auge <raymond.a...@liferay.com>
wrote:
> On Thu, Jul 12, 2018 at 11:58 AM, Philipp Höfler <
> philipp.hoef...@pernexas.com> wrote:
>
> > Right, this is missing.
> > I added the @RquireConfigurator annotation to the GoGo Command class. Is
> > that a suitable place for it?
> > The json is now being loaded. The value is set to false.
> >
> > Could you please explain, how this is working?
> >
> It's not completely clear to me, why the @interface MyConfig is
> > automatically used to hold the configuration.
> >
>
> DS is merely creating a proxy of the annotation type which fronts (or is
> backed by) the configuration dictionary, using the default values as well,
> default values if that particular property is not defined or if no
> configuration is available.
>
>
> > In each class, that needs access to the config I've a activate and
> > modified method with this signature: public void modified(MyConfig
> config)
> >
> > Is the type resolved based on the pid and the param type of the method?
> >
>
> The Component Property Type will be backed by whatever configuration is
> associated with the component. so if you use the same Component Property
> Types on two different components which refer to two different pids, the
> proxies will show different values (based on the backing configuration
> dictionary of the component).
>
>
>
> >
> > ---
> > Back to my root problem:
> > Is it now possible to have the following configuration?
> > {
> > // Resource Format Version
> > ":configurator:resource-version" : 1,
> >
> > // First Configuration
> > "my.config":
> > {
> > "system1":
> > {
> > "test.securityEnabled": false,
> > "test.test": false
> > },
> > "system2":
> > {
> > "test.securityEnabled": false,
> > "test.test": false
> > }
> > }
> > }
> >
>
> Sure in this case the configuration dictionary will hold values:
>
> system1 = {"test.securityEnabled": false, "test.test": false}
> system2 = {"test.securityEnabled": false, "test.test": false}
>
> which is probably not what you intended.
>
> IF what you want is to create N instances of the component, one per set of
> configuration properties, you'd want to use Factory Configurations like so:
>
> {
> > // Resource Format Version
> > ":configurator:resource-version" : 1,
> >
> > // First Configuration
> > "my.config~system1":
> > {
> > "test.securityEnabled": false,
> > "test.test": false
> > },
> > // Second Configuration
> > "my.config~system2":
> > {
> > "test.securityEnabled": true,
> > "test.test": false
> > }
> > }
> > }
> >
>
> Then you will have 2 component activations; one for each system1, system2,
> each with a MyConfig instance backing a different factory configuration
> instance.
>
> HTH
> - Ray
>
>
> >
> > Is it possible to have such a config with n systems?
> > Meaning, I do not know the amount of systems at compile time.
> >
> > Further, how would the @interface MyConfig annotation look like?
> > Is it possible to expect an array of MyConfig for the modified(MyConfig[]
> > configs) method?
> >
> > Thanks for your help,
> > Philipp
> >
> > -----Ursprüngliche Nachricht-----
> > Von: Raymond Auge <raymond.a...@liferay.com>
> > Gesendet: Donnerstag, 12. Juli 2018 16:43
> > An: felix users <users@felix.apache.org>
> > Betreff: Re: Configurator R7 example
> >
> > Did you add the requirement to your configuration bundle?
> >
> > Require-Capability: osgi.extender; \
> > filter:="(&(osgi.extender=osgi.configurator) \
> > (version>=1.0
> > <https://osgi.org/specification/osgi.cmpn/7.0.0/
> > service.configurator.html#org.osgi.service.configurator>)(!(
> > version>=2.0)))"
> >
> > That or on some bit of code in the configuration bundle add the
> annotation:
> >
> > @org.osgi.service.configurator.annotations.RequireConfigurator
> >
> > - Ray
> >
> >
> > On Thu, Jul 12, 2018 at 10:23 AM, Philipp Höfler <
> > philipp.hoef...@pernexas.com> wrote:
> >
> > > Hallo David,
> > >
> > > thanks for the explanation.
> > > So, the configurator is just a "wrapper" for the ConfigAdminService to
> > > read json and transfer it into a key value format, right?
> > >
> > > I still have problems to use the
> > > I put a test.json file in the OSGI-INF/configurator folder of a bundle
> > > with the following content:
> > > {
> > > // Resource Format Version
> > > ":configurator:resource-version" : 1,
> > >
> > > // First Configuration
> > > "my.config":
> > > {
> > > "test.securityEnabled": false,
> > > "test.test": false
> > > }
> > > }
> > >
> > > In addition, I have an annotation for holding the values:
> > > public @interface MyConfig
> > > {
> > > boolean test_securityEnabled () default true;
> > > boolean test_test() default true;
> > > }
> > >
> > > Besides that, I've a custom GoGo command for configuration. But I am
> > > not sure, if this is really needed for loading the json?
> > >
> > > Unfortunately, the json is obviously not loaded.
> > > Both values are set to true, according to the default value.
> > >
> > > Do I have to do something in addition to load the json file?
> > >
> > > Thanks,
> > > Philipp
> > >
> > > -----Ursprüngliche Nachricht-----
> > > Von: David Bosschaert <david.bosscha...@gmail.com>
> > > Gesendet: Donnerstag, 12. Juli 2018 11:15
> > > An: users@felix.apache.org
> > > Betreff: Re: Configurator R7 example
> > >
> > > Hi Philipp,
> > >
> > > In the end the configuration specified with the Configurator will end
> > > up in OSGi Configuration Admin, so the Configurator is limited to the
> > > same types as ConfigAdmin. The Configurator allows complex JSON values
> > > to be specified, they will end up as JSON text in Configuration Admin
> > > if they go beyond what ConfigAdmin supports natively.
> > >
> > > So to use the Configurator you need the Configurator bundle plus the
> > > ConfigAdmin bundle.
> > >
> > > The Configurator handles configuration resources in
> > > OSGI-INF/configurator inside bundles but can also be provided with
> > > external configuration via the configurator.initial framework/system
> > > property. This is described in sections 150.4 and 150.5 in [1]. To
> > > provide Configurator configuration into the system you don't need to
> > > write any classes, but depending on how you use the configuration you
> > > may have to add classes that consume it. But again, the consumption
> > > can be done by anything that understands ConfigAdmin configs, so there
> > are a lot of options for this.
> > >
> > > I'm not aware of a complete tutorial on this topic yet. I agree it
> > > would be nice to have that.
> > >
> > > Hope this helps,
> > >
> > > David
> > >
> > > [1] https://osgi.org/specification/osgi.cmpn/7.0.0/
> > > service.configurator.html
> > >
> > > On Thu, 12 Jul 2018 at 10:55, Philipp Höfler
> > > <philipp.hoef...@pernexas.com
> > > >
> > > wrote:
> > >
> > > > Hi,
> > > >
> > > > I am searching for a possibility to load complex configurations.
> > > > I tried the ConfigurationAdminService, but key value pairs are not
> > > > sufficient as I need complex types.
> > > >
> > > > Raymond pointed out that I should have a look at the Configurator
> > > > Specification.
> > > > https://osgi.org/specification/osgi.cmpn/7.0.0/service.configurator.
> > > > ht
> > > > ml
> > > >
> > > > I read the specification and it sounds promising.
> > > > But I am stuck how to use the Configuration in my project.
> > > > I understand that I've to add the following dependency.
> > > > org.apache.felix.configurator
> > > >
> > > > But I don't understand if I've to add some classes, where the json
> > > > file has to be placed and if it's possible to place it outside of
> > > > the
> > > bundle?
> > > >
> > > > Is there any tutorial or sample project out there?
> > > >
> > > > Thanks,
> > > > Philipp
> > > >
> > >
> > > ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: users-unsubscr...@felix.apache.org
> > > For additional commands, e-mail: users-h...@felix.apache.org
> > >
> >
> >
> >
> > --
> > *Raymond Augé* <http://www.liferay.com/web/raymond.auge/profile>
> > (@rotty3000)
> > Senior Software Architect *Liferay, Inc.* <http://www.liferay.com>
> > (@Liferay)
> > Board Member & EEG Co-Chair, OSGi Alliance <http://osgi.org>
> > (@OSGiAlliance)
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: users-unsubscr...@felix.apache.org
> > For additional commands, e-mail: users-h...@felix.apache.org
> >
>
>
>
> --
> *Raymond Augé* <http://www.liferay.com/web/raymond.auge/profile>
> (@rotty3000)
> Senior Software Architect *Liferay, Inc.* <http://www.liferay.com>
> (@Liferay)
> Board Member & EEG Co-Chair, OSGi Alliance <http://osgi.org>
> (@OSGiAlliance)
>
