roar109/syring

How to include it in your project

If you are using Maven as your dependency manager you can include this dependency:

  <dependency>
     <groupId>com.github.roar109</groupId>
     <artifactId>syring</artifactId>
     <version>1.0.1</version>
  </dependency>

Also, we need to create a file prop-config.properties in case you will use FILE/JNDI options and put it inside the resources folder in order to be available to the component class loader resource locator. In this file we need to define these 3 properties:

properties.variables=
jndi.variable=
jndi.client.context.factory.variable=

properties.variables may have several system variables separated by , where you may have different properties files.
jndi.variable is currently not being used, but in a future release it will hold the system variable to obtain the JNDI Provider URI.
jndi.client.context.factory.variable is the FQN of the class used to connect to the JNDI Server Directory. By default the frameworks provides a constant using JBoss JNP Client (org.jnp.interfaces.NamingContextFactory). Please note that this framework does not bundle any JNDI clients, thus you must add dependencies to any classes needed for this purpose. For example for JBoss JNPO client:
```
   <dependency>
      <groupId>jboss</groupId>
      <artifactId>jnp-client</artifactId>
      <version>4.0.2</version>
   </dependency>
```

For a reference implementation you may check this git project:

System/Env properties

@Inject @ApplicationProperty(name="service.endpoint.jndi.location", type=ApplicationProperty.Types.SYSTEM)
private String jndiUrl;

File properties

@Inject @ApplicationProperty(name="sample.prop.value", type=ApplicationProperty.Types.FILE)
private String allowEventRegistration;

JNDI values

@Inject @ApplicationProperty(name="project/sample/jndi", type=ApplicationProperty.Types.JNDI)
private String jndiUrl;

File + JNDI properties

@Inject @ApplicationProperty(name="data.jndi.url", type=ApplicationProperty.Types.FILE_JNDI)
private String allowEventRegistration;

When you have something like this in your project properties file data.jndi.url=server/sample/url this will get the value from your properties file and then look for the jndi definition of it. Follow the same rules as the File and JNDI options.

Integer, Long and Double values

By default the injection of values are Strings, however in some cases we need to insert numbers, so we add a valueType to the annotation since 1.1.0 version, an example of use is:

@Inject
@ApplicationProperty (name = "example.int.property", type = ApplicationProperty.Types.FILE, valueType=ApplicationProperty.ValueType.INTEGER)
private Integer systemInjectedInteger;

Is going to extract the value from the source (type) as string and then parse to Long.

roar109 / syring