diff --git a/README.adoc b/README.adoc index c31d8a1..fd1a563 100644 --- a/README.adoc +++ b/README.adoc @@ -93,7 +93,7 @@ JavaConfig does not contain an implementation itself but only provides the speci The current configuration of an application can be accessed via `ConfigProvider#getConfig()`. -A `Config` consists of the information collected from the registered `javax.config.spi.ConfigSource` s. +A `Config` consists of the information collected from the registered `jakarta.config.spi.ConfigSource` s. These `ConfigSource` s get sorted according to their _ordinal_. That way it is possible to overwrite configuration with lower importance from outside. diff --git a/api/bnd.bnd b/api/bnd.bnd index 41636ed..8810d11 100644 --- a/api/bnd.bnd +++ b/api/bnd.bnd @@ -1,6 +1,6 @@ -exportcontents: \ - javax.config.* -Bundle-SymbolicName: javax.config + jakarta.config.* +Bundle-SymbolicName: jakarta.config Bundle-Name: JavaConfig Bundle Bundle-License: Apache License, Version 2.0 -Automatic-Module-Name: javax.config +Automatic-Module-Name: jakarta.config diff --git a/api/pom.xml b/api/pom.xml index e24d2fe..e083f50 100644 --- a/api/pom.xml +++ b/api/pom.xml @@ -17,8 +17,8 @@ 4.0.0 - javax.config - javaconfig-parent + jakarta.config + jakartaconfig-parent 1.0-SNAPSHOT @@ -84,7 +84,7 @@ org.apache.maven.plugins maven-jar-plugin - javax.config + jakarta.config JavaConfig bundle ${project.build.outputDirectory}/META-INF/MANIFEST.MF diff --git a/api/src/main/java/javax/config/Config.java b/api/src/main/java/jakarta/config/Config.java similarity index 98% rename from api/src/main/java/javax/config/Config.java rename to api/src/main/java/jakarta/config/Config.java index 4968058..3360ac8 100644 --- a/api/src/main/java/javax/config/Config.java +++ b/api/src/main/java/jakarta/config/Config.java @@ -32,11 +32,11 @@ * *******************************************************************************/ -package javax.config; +package jakarta.config; import java.util.Optional; -import javax.config.spi.ConfigSource; +import jakarta.config.spi.ConfigSource; /** *

@@ -79,7 +79,7 @@ * {@link #access(String, Class)} for accessing a configured value. * *

Configured values can also be accessed via injection. - * See {@link javax.config.inject.ConfigProperty} for more information. + * See {@link jakarta.config.inject.ConfigProperty} for more information. * * @author Mark Struberg * @author Gerhard Petracek diff --git a/api/src/main/java/javax/config/ConfigAccessor.java b/api/src/main/java/jakarta/config/ConfigAccessor.java similarity index 96% rename from api/src/main/java/javax/config/ConfigAccessor.java rename to api/src/main/java/jakarta/config/ConfigAccessor.java index ddd4b6c..552c8b7 100644 --- a/api/src/main/java/javax/config/ConfigAccessor.java +++ b/api/src/main/java/jakarta/config/ConfigAccessor.java @@ -24,13 +24,13 @@ * Extracted the Config part out of DeltaSpike and proposed as Microprofile-Config 8ff76eb3bcfaf4fd * *******************************************************************************/ -package javax.config; +package jakarta.config; import java.time.Duration; import java.util.Optional; -import javax.config.spi.Converter; +import jakarta.config.spi.Converter; /** @@ -90,7 +90,7 @@ public interface ConfigAccessor { Optional getOptionalValue(); /** - * Returns the property name key given in {@link javax.config.Config#access(String, Class)}. + * Returns the property name key given in {@link Config#access(String, Class)}. * @return the original property name */ String getPropertyName(); @@ -162,7 +162,7 @@ interface Builder { * Note that that the cache will get flushed if a {@code ConfigSource} notifies * the underlying {@link Config} about a value change. * This is done by invoking the callback provided to the {@code ConfigSource} via - * {@link javax.config.spi.ConfigSource#setAttributeChangeCallback(java.util.function.Consumer)}. + * {@link jakarta.config.spi.ConfigSource#setAttributeChangeCallback(java.util.function.Consumer)}. * * @param duration the maximum amount of the time to cache this value. * @return This builder @@ -202,7 +202,7 @@ interface Builder { * * Integer timeout = config.access("some.server.url", Integer.class) * .addLookupSuffix(tenant) - * .addLookupSuffix(config.access("javax.config.projectStage").build()) + * .addLookupSuffix(config.access("jakarta.config.projectStage").build()) * .build() * .getValue(); * diff --git a/api/src/main/java/javax/config/ConfigProvider.java b/api/src/main/java/jakarta/config/ConfigProvider.java similarity index 85% rename from api/src/main/java/javax/config/ConfigProvider.java rename to api/src/main/java/jakarta/config/ConfigProvider.java index 189cdc7..8cbd340 100644 --- a/api/src/main/java/javax/config/ConfigProvider.java +++ b/api/src/main/java/jakarta/config/ConfigProvider.java @@ -29,9 +29,9 @@ * *******************************************************************************/ -package javax.config; +package jakarta.config; -import javax.config.spi.ConfigProviderResolver; +import jakarta.config.spi.ConfigProviderResolver; /** *

@@ -45,13 +45,13 @@ * {@link Thread#getContextClassLoader()}). * *

- * A 'Configuration' consists of the information collected from the registered {@link javax.config.spi.ConfigSource ConfigSources}. - * These {@link javax.config.spi.ConfigSource ConfigSources} get sorted according to - * their ordinal defined via {@link javax.config.spi.ConfigSource#getOrdinal()}. + * A 'Configuration' consists of the information collected from the registered {@link jakarta.config.spi.ConfigSource ConfigSources}. + * These {@link jakarta.config.spi.ConfigSource ConfigSources} get sorted according to + * their ordinal defined via {@link jakarta.config.spi.ConfigSource#getOrdinal()}. * Thus it is possible to overwrite configuration by providing in a ConfigSource with higher importance from outside. * *

- * It is also possible to register custom {@link javax.config.spi.ConfigSource ConfigSources} to flexibly + * It is also possible to register custom {@link jakarta.config.spi.ConfigSource ConfigSources} to flexibly * extend the configuration mechanism. An example would be to pick up * configuration values from a database table. * @@ -77,7 +77,7 @@ private ConfigProvider() { } /** - * Provide a {@link Config} based on all {@link javax.config.spi.ConfigSource ConfigSources} of the + * Provide a {@link Config} based on all {@link jakarta.config.spi.ConfigSource ConfigSources} of the * current Thread Context ClassLoader (TCCL) * The {@link Config} will be stored for future retrieval. *

@@ -90,7 +90,7 @@ public static Config getConfig() { } /** - * Provide a {@link Config} based on all {@link javax.config.spi.ConfigSource ConfigSources} of the + * Provide a {@link Config} based on all {@link jakarta.config.spi.ConfigSource ConfigSources} of the * specified ClassLoader * *

diff --git a/api/src/main/java/javax/config/ConfigSnapshot.java b/api/src/main/java/jakarta/config/ConfigSnapshot.java similarity index 98% rename from api/src/main/java/javax/config/ConfigSnapshot.java rename to api/src/main/java/jakarta/config/ConfigSnapshot.java index 04307fd..8e8f9bc 100644 --- a/api/src/main/java/javax/config/ConfigSnapshot.java +++ b/api/src/main/java/jakarta/config/ConfigSnapshot.java @@ -24,7 +24,7 @@ * *******************************************************************************/ -package javax.config; +package jakarta.config; /** * A value holder for ConfigAccessor values which all got resolved in a guaranteed atomic way. diff --git a/api/src/main/java/javax/config/inject/ConfigProperty.java b/api/src/main/java/jakarta/config/inject/ConfigProperty.java similarity index 92% rename from api/src/main/java/javax/config/inject/ConfigProperty.java rename to api/src/main/java/jakarta/config/inject/ConfigProperty.java index be75b15..d34bf18 100644 --- a/api/src/main/java/javax/config/inject/ConfigProperty.java +++ b/api/src/main/java/jakarta/config/inject/ConfigProperty.java @@ -17,7 +17,7 @@ * limitations under the License. */ -package javax.config.inject; +package jakarta.config.inject; import static java.lang.annotation.ElementType.FIELD; import static java.lang.annotation.ElementType.METHOD; @@ -32,6 +32,7 @@ import javax.enterprise.util.Nonbinding; import javax.inject.Qualifier; + /** * Binds the injection point with a configured value. * Can be used to annotate injection points of type {@code TYPE}, {@code Optional} or {@code javax.inject.Provider}, @@ -45,7 +46,7 @@ * * The first sample injects the configured value of the {@code my.long.property} property. * The injected value does not change even if the underline - * property value changes in the {@link javax.config.Config}. + * property value changes in the {@link jakarta.config.Config}. * *

Injecting a native value is recommended for a mandatory property and its value does not change at runtime or used by a bean with RequestScoped. *

A further recommendation is to use the built in {@code META-INF/javaconfig.properties} file mechanism @@ -84,7 +85,7 @@ *

Injecting Dynamic Values

* * The next sample injects a Provider for the value of {@code my.long.property} property to resolve the property dynamically. - * Each invocation to {@code Provider#get()} will resolve the latest value from underlying {@link javax.config.Config} again. + * Each invocation to {@code Provider#get()} will resolve the latest value from underlying {@link jakarta.config.Config} again. * The existence of configured values will get checked during startup. * Instances of {@code javax.inject.Provider} are guaranteed to be Serializable. *
@@ -93,7 +94,7 @@
  * private Provider<Long> longConfigValue;
  * 
* - *

If {@code ConfigProperty} is used with a type where no {@link javax.config.spi.Converter} exists, + *

If {@code ConfigProperty} is used with a type where no {@link jakarta.config.spi.Converter} exists, * a deployment error will be thrown. * * @author Ondrej Mihalyi @@ -105,7 +106,7 @@ @Retention(RUNTIME) @Target({METHOD, FIELD, PARAMETER, TYPE}) public @interface ConfigProperty { - String UNCONFIGURED_VALUE="javax.config.configproperty.unconfigureddvalue"; + String UNCONFIGURED_VALUE="jakarta.config.configproperty.unconfigureddvalue"; /** * The key of the config property used to look up the configuration value. @@ -122,7 +123,7 @@ /** *

The default value if the configured property value does not exist. * - *

If the target Type is not String a proper {@link javax.config.spi.Converter} will get applied. + *

If the target Type is not String a proper {@link jakarta.config.spi.Converter} will get applied. * That means that any default value string should follow the formatting rules of the registered Converters. * * @@ -132,7 +133,7 @@ String defaultValue() default UNCONFIGURED_VALUE; /** - * @see javax.config.ConfigAccessor.Builder#evaluateVariables(boolean) + * @see jakarta.config.ConfigAccessor.Builder#evaluateVariables(boolean) * @return whether variable replacement is enabled. Defaults to {@code true}. */ @Nonbinding diff --git a/api/src/main/java/javax/config/inject/package-info.java b/api/src/main/java/jakarta/config/inject/package-info.java similarity index 84% rename from api/src/main/java/javax/config/inject/package-info.java rename to api/src/main/java/jakarta/config/inject/package-info.java index bbeb242..348c1e2 100644 --- a/api/src/main/java/javax/config/inject/package-info.java +++ b/api/src/main/java/jakarta/config/inject/package-info.java @@ -31,12 +31,12 @@ *

The following types can be injected: *

    * - *
  • T where T is a Type where a {@link javax.config.spi.Converter} exists and the property must exist.
  • + *
  • T where T is a Type where a {@link jakarta.config.spi.Converter} exists and the property must exist.
  • *
  • - * Optional<T> where T is a Type where a {@link javax.config.spi.Converter} exists where the property may exist. + * Optional<T> where T is a Type where a {@link jakarta.config.spi.Converter} exists where the property may exist. *
  • *
  • - * Provider<T> where T is a Type where a {@link javax.config.spi.Converter} exists where the property may exist. + * Provider<T> where T is a Type where a {@link jakarta.config.spi.Converter} exists where the property may exist. *
  • *
* @@ -45,5 +45,5 @@ * */ @org.osgi.annotation.versioning.Version("1.0") -package javax.config.inject; +package jakarta.config.inject; diff --git a/api/src/main/java/javax/config/package-info.java b/api/src/main/java/jakarta/config/package-info.java similarity index 90% rename from api/src/main/java/javax/config/package-info.java rename to api/src/main/java/jakarta/config/package-info.java index b1e7c7f..8bc337c 100644 --- a/api/src/main/java/javax/config/package-info.java +++ b/api/src/main/java/jakarta/config/package-info.java @@ -34,7 +34,7 @@ *

How it works

* *

A 'Configuration' consists of the information collected from the registered - * {@link javax.config.spi.ConfigSource ConfigSources}. + * {@link jakarta.config.spi.ConfigSource ConfigSources}. * These {@code ConfigSources} get sorted according to their ordinal. * That way it is possible to overwrite configuration with lower importance from outside. * @@ -50,13 +50,13 @@ *

That means that one can put the default configuration in a {@code META-INF/javaconfig.properties} anywhere on the classpath. * and the Operations team can later simply e.g set a system property to change this default configuration. * - *

It is of course also possible to register own {@link javax.config.spi.ConfigSource ConfigSources}. + *

It is of course also possible to register own {@link jakarta.config.spi.ConfigSource ConfigSources}. * A {@code ConfigSource} could e.g. read configuration values from a database table, a remote server, etc * *

Accessing and Using the Configuration

* - *

The configuration of an application is represented by an instance of {@link javax.config.Config}. - * The {@link javax.config.Config} can be accessed via the {@link javax.config.ConfigProvider}. + *

The configuration of an application is represented by an instance of {@link jakarta.config.Config}. + * The {@link jakarta.config.Config} can be accessed via the {@link jakarta.config.ConfigProvider}. * *

  *  Config config = ConfigProvider#getConfig();
@@ -75,5 +75,5 @@
  *
  */
 @org.osgi.annotation.versioning.Version("1.0")
-package javax.config;
+package jakarta.config;
 
diff --git a/api/src/main/java/javax/config/spi/ConfigBuilder.java b/api/src/main/java/jakarta/config/spi/ConfigBuilder.java
similarity index 98%
rename from api/src/main/java/javax/config/spi/ConfigBuilder.java
rename to api/src/main/java/jakarta/config/spi/ConfigBuilder.java
index 4030d99..54c34c0 100644
--- a/api/src/main/java/javax/config/spi/ConfigBuilder.java
+++ b/api/src/main/java/jakarta/config/spi/ConfigBuilder.java
@@ -26,9 +26,9 @@
  *      API improvements + JavaDoc  f53258b8eca1253fee52
  *
  *******************************************************************************/
-package javax.config.spi;
+package jakarta.config.spi;
 
-import javax.config.Config;
+import jakarta.config.Config;
 
 /**
  * Builder for manually creating an instance of a {@code Config}.
diff --git a/api/src/main/java/javax/config/spi/ConfigProviderResolver.java b/api/src/main/java/jakarta/config/spi/ConfigProviderResolver.java
similarity index 96%
rename from api/src/main/java/javax/config/spi/ConfigProviderResolver.java
rename to api/src/main/java/jakarta/config/spi/ConfigProviderResolver.java
index a6e8d18..df89f15 100644
--- a/api/src/main/java/javax/config/spi/ConfigProviderResolver.java
+++ b/api/src/main/java/jakarta/config/spi/ConfigProviderResolver.java
@@ -18,13 +18,13 @@
  * limitations under the License.
  *******************************************************************************/
 
-package javax.config.spi;
+package jakarta.config.spi;
 
 import java.security.AccessController;
 import java.security.PrivilegedAction;
 import java.util.ServiceLoader;
 
-import javax.config.Config;
+import jakarta.config.Config;
 
 /**
  * This class is not intended to be used by end-users but for
@@ -44,13 +44,13 @@ protected ConfigProviderResolver() {
     private static volatile ConfigProviderResolver instance = null;
 
     /**
-     * @see javax.config.ConfigProvider#getConfig()
+     * @see jakarta.config.ConfigProvider#getConfig()
      * @return config the config object for the Thread Context Classloader
      */
     public abstract Config getConfig();
 
     /**
-     * @see javax.config.ConfigProvider#getConfig(ClassLoader)
+     * @see jakarta.config.ConfigProvider#getConfig(ClassLoader)
      * @param loader the classloader
      * @return config the config object for the specified classloader
      */
@@ -96,7 +96,7 @@ protected ConfigProviderResolver() {
 
     /**
      * Creates a ConfigProviderResolver object
-     * Only used internally from within {@link javax.config.ConfigProvider}
+     * Only used internally from within {@link jakarta.config.ConfigProvider}
      * @return ConfigProviderResolver an instance of ConfigProviderResolver
      */
     public static ConfigProviderResolver instance() {
diff --git a/api/src/main/java/javax/config/spi/ConfigSource.java b/api/src/main/java/jakarta/config/spi/ConfigSource.java
similarity index 93%
rename from api/src/main/java/javax/config/spi/ConfigSource.java
rename to api/src/main/java/jakarta/config/spi/ConfigSource.java
index 46e3dd1..48dc2f3 100644
--- a/api/src/main/java/javax/config/spi/ConfigSource.java
+++ b/api/src/main/java/jakarta/config/spi/ConfigSource.java
@@ -28,7 +28,7 @@
  *      Methods renamed, JavaDoc and cleanup
  *
  *******************************************************************************/
-package javax.config.spi;
+package jakarta.config.spi;
 
 import java.util.Map;
 import java.util.Set;
@@ -63,18 +63,18 @@
  * 

Custom ConfigSource will get picked up via the {@link java.util.ServiceLoader} mechanism and and can be registered by * providing a file *

- *     META-INF/services/javax.config.spi.ConfigSource
+ *     META-INF/services/ConfigSource
  * 
* which contains the fully qualified {@code ConfigSource} implementation class name as content. * *

Adding a dynamic amount of custom config sources can be done programmatically via - * {@link javax.config.spi.ConfigSourceProvider}. + * {@link ConfigSourceProvider}. * *

If a ConfigSource implements the {@link AutoCloseable} interface * then the {@link AutoCloseable#close()} method will be called when - * the underlying {@link javax.config.Config} is being released. + * the underlying {@link jakarta.config.Config} is being released. * - *

If you register the same {@code ConfigSource} instance within multiple {@link javax.config.Config} then non-portable behaviour results. + *

If you register the same {@code ConfigSource} instance within multiple {@link jakarta.config.Config} then non-portable behaviour results. * * @author Mark Struberg * @author Gerhard Petracek @@ -174,10 +174,10 @@ default boolean isScannable() { /** * The callback should get invoked if an attribute change got detected inside the ConfigSource. * - * @param callback will be set by the {@link javax.config.Config} after this + * @param callback will be set by the {@link jakarta.config.Config} after this * {@code ConfigSource} got created and before any configured values * get served. - * @return ChangeSupport informing the {@link javax.config.Config} implementation about support for changes by this source + * @return ChangeSupport informing the {@link jakarta.config.Config} implementation about support for changes by this source * @see ChangeSupport */ default ChangeSupport setAttributeChangeCallback(Consumer> callback) { @@ -189,7 +189,7 @@ default ChangeSupport setAttributeChangeCallback(Consumer> callback) /** * What kind of change support this config source has. *

- * {@link javax.config.Config} implementations may use this information for internal optimizations. + * {@link jakarta.config.Config} implementations may use this information for internal optimizations. */ enum ChangeSupport { /** diff --git a/api/src/main/java/javax/config/spi/ConfigSourceProvider.java b/api/src/main/java/jakarta/config/spi/ConfigSourceProvider.java similarity index 94% rename from api/src/main/java/javax/config/spi/ConfigSourceProvider.java rename to api/src/main/java/jakarta/config/spi/ConfigSourceProvider.java index e9e29ba..cd1f52a 100644 --- a/api/src/main/java/javax/config/spi/ConfigSourceProvider.java +++ b/api/src/main/java/jakarta/config/spi/ConfigSourceProvider.java @@ -27,7 +27,8 @@ * *******************************************************************************/ -package javax.config.spi; +package jakarta.config.spi; + /** *

Implement this interfaces to provide multiple ConfigSources. @@ -40,7 +41,7 @@ * *

A ConfigSourceProvider will get picked up via the * {@link java.util.ServiceLoader} mechanism and can be registered by providing a - * {@code META-INF/services/javax.config.spi.ConfigSourceProvider} file which contains + * {@code META-INF/services/ConfigSourceProvider} file which contains * the fully qualified classname of the custom ConfigSourceProvider. * * @author Mark Struberg @@ -55,7 +56,7 @@ public interface ConfigSourceProvider { * For each e.g. property file, we return a single ConfigSource or an empty list if no ConfigSource exists. * * @param forClassLoader the classloader which should be used if any is needed - * @return the {@link ConfigSource ConfigSources} to register within the {@link javax.config.Config}. + * @return the {@link ConfigSource ConfigSources} to register within the {@link jakarta.config.Config}. */ Iterable getConfigSources(ClassLoader forClassLoader); } diff --git a/api/src/main/java/javax/config/spi/Converter.java b/api/src/main/java/jakarta/config/spi/Converter.java similarity index 97% rename from api/src/main/java/javax/config/spi/Converter.java rename to api/src/main/java/jakarta/config/spi/Converter.java index a2d7fa6..a850178 100644 --- a/api/src/main/java/javax/config/spi/Converter.java +++ b/api/src/main/java/jakarta/config/spi/Converter.java @@ -27,7 +27,7 @@ * *******************************************************************************/ -package javax.config.spi; +package jakarta.config.spi; /** *

Interface for converting configured values from String to any Java type. @@ -45,7 +45,7 @@ * *

Custom Converters will get picked up via the {@link java.util.ServiceLoader} mechanism and and can be registered by * providing a file
- * META-INF/services/javax.config.spi.Converter
+ * META-INF/services/Converter
* which contains the fully qualified {@code Converter} implementation class name as content. * *

A Converter can specify a {@code javax.annotation.Priority}. @@ -103,7 +103,7 @@ * *

If a Converter implements the {@link AutoCloseable} interface * then the {@link AutoCloseable#close()} method will be called when - * the underlying {@link javax.config.Config} is being released. + * the underlying {@link jakarta.config.Config} is being released. * * @author Ron Smeral * @author Mark Struberg diff --git a/api/src/main/java/javax/config/spi/package-info.java b/api/src/main/java/jakarta/config/spi/package-info.java similarity index 83% rename from api/src/main/java/javax/config/spi/package-info.java rename to api/src/main/java/jakarta/config/spi/package-info.java index 32de65b..7a2be46 100644 --- a/api/src/main/java/javax/config/spi/package-info.java +++ b/api/src/main/java/jakarta/config/spi/package-info.java @@ -20,13 +20,13 @@ /** *

This package contains classes which are used to extend the standard functionality in a portable way. - *

A user can provide own {@link javax.config.spi.ConfigSource ConfigSources} and - * {@link javax.config.spi.Converter Converters} to extend the information available in the Config. + *

A user can provide own {@link jakarta.config.spi.ConfigSource ConfigSources} and + * {@link jakarta.config.spi.Converter Converters} to extend the information available in the Config. * - *

The package also contains the class {@link javax.config.spi.ConfigProviderResolver} + *

The package also contains the class {@link jakarta.config.spi.ConfigProviderResolver} * which is used to pick up the actual implementation. *

Usage

- *

This is used to build up a builder and manually add {@link javax.config.spi.ConfigSource ConfigSources}..

+ *

This is used to build up a builder and manually add {@link jakarta.config.spi.ConfigSource ConfigSources}..

* * *
    @@ -49,4 +49,4 @@ * */ @org.osgi.annotation.versioning.Version("1.1") -package javax.config.spi; +package jakarta.config.spi; diff --git a/pom.xml b/pom.xml index 1e30752..b2125d1 100644 --- a/pom.xml +++ b/pom.xml @@ -16,13 +16,11 @@ 4.0.0 - javax.config - javaconfig-parent + jakarta.config + jakartaconfig-parent 1.0-SNAPSHOT pom - JSR-382 Configuration API for Java v1.0 - Parent POM - - https://jcp.org/en/jsr/detail?id=382 + Configuration API for Jakarta v1.0 - Parent POM UTF-8 diff --git a/spec/pom.xml b/spec/pom.xml index e444117..294818d 100644 --- a/spec/pom.xml +++ b/spec/pom.xml @@ -17,8 +17,8 @@ 4.0.0 - javax.config - javaconfig-parent + jakarta.config + jakartaconfig-parent 1.0-SNAPSHOT diff --git a/spec/src/main/asciidoc/configsources.asciidoc b/spec/src/main/asciidoc/configsources.asciidoc index 67142eb..1aa0694 100644 --- a/spec/src/main/asciidoc/configsources.asciidoc +++ b/spec/src/main/asciidoc/configsources.asciidoc @@ -77,7 +77,7 @@ The first environment variable that is found is returned by this `ConfigSource`. <> are discovered using the `java.util.ServiceLoader` mechanism. -To add a custom `ConfigSource`, implement the interface `javax.config.spi.ConfigSource`. +To add a custom `ConfigSource`, implement the interface `jakarta.config.spi.ConfigSource`. [source, java] ---- @@ -112,7 +112,7 @@ public class CustomDbConfigSource implements ConfigSource { ---- -Then register your implementation in a resource file `/META-INF/services/javax.config.spi.ConfigSource` by including the fully-qualified class name of the custom implementation in the file. +Then register your implementation in a resource file `/META-INF/services/jakarta.config.spi.ConfigSource` by including the fully-qualified class name of the custom implementation in the file. === Custom ConfigSources via ConfigSourceProvider @@ -121,15 +121,15 @@ If you need dynamic <> you can also register a `Conf This is useful if you need to dynamically pick up multiple <> of the same kind; for example, to pick up all `myproject.properties` resources from all the JARs in your classpath. -A custom `ConfigSourceProvider` must implement the interface `javax.config.spi.ConfigSourceProvider`. -Register your implementation in a resource file `/META-INF/services/javax.config.spi.ConfigSourceProvider` by including the fully-qualified class name of the custom implementation/s in the file. +A custom `ConfigSourceProvider` must implement the interface `jakarta.config.spi.ConfigSourceProvider`. +Register your implementation in a resource file `/META-INF/services/jakarta.config.spi.ConfigSourceProvider` by including the fully-qualified class name of the custom implementation/s in the file. An example which registers all YAML files with the name `exampleconfig.yaml`: [source, java] ---- public class ExampleYamlConfigSourceProvider - implements javax.config.spi.ConfigSourceProvider { + implements jakarta.config.spi.ConfigSourceProvider { @Override public List getConfigSources(ClassLoader forClassLoader) { List configSources = new ArrayList<>(); diff --git a/spec/src/main/asciidoc/converters.asciidoc b/spec/src/main/asciidoc/converters.asciidoc index 510626f..58087a8 100644 --- a/spec/src/main/asciidoc/converters.asciidoc +++ b/spec/src/main/asciidoc/converters.asciidoc @@ -42,9 +42,9 @@ All built-in `Converter` have the `@Priority` of `1`. === Adding custom Converters -A custom `Converter` must implement the generic interface `javax.config.spi.Converter`. +A custom `Converter` must implement the generic interface `jakarta.config.spi.Converter`. The Type parameter of the interface is the target type the String is converted to. -You have to register your implementation in a file `/META-INF/services/javax.config.spi.Converter` with the fully qualified class name of the custom implementation. +You have to register your implementation in a file `/META-INF/services/jakarta.config.spi.Converter` with the fully qualified class name of the custom implementation. A custom `Converter` can define a priority with the `@javax.annotation.Priority` annotation. If a Priority annotation isn't applied, a default priority of 100 is assumed. diff --git a/tck/pom.xml b/tck/pom.xml index 3c82aef..1f06e41 100644 --- a/tck/pom.xml +++ b/tck/pom.xml @@ -17,12 +17,12 @@ 4.0.0 - javax.config - javaconfig-parent + jakarta.config + jakartaconfig-parent 1.0-SNAPSHOT - javax.config + jakarta.config javaconfig-tck @@ -45,7 +45,7 @@ - javax.config + jakarta.config javaconfig-api ${project.version} provided diff --git a/tck/running_the_tck.asciidoc b/tck/running_the_tck.asciidoc index 68754ba..01415b3 100644 --- a/tck/running_the_tck.asciidoc +++ b/tck/running_the_tck.asciidoc @@ -30,13 +30,13 @@ To enable the tests in your project you need to add the following dependency to - javax.config + jakarta.config javaconfig-api ${javaconfig.version} - javax.config + jakarta.config javaconfig-tck ${javaconfig.version} test @@ -119,7 +119,7 @@ If you don't want to use a tck-suite.xml file, you can also just use in line sur maven-surefire-plugin - javax.config:javaconfig-tck + jakarta.config:javaconfig-tck diff --git a/tck/src/main/java/org/eclipse/configjsr/ArrayConverterTest.java b/tck/src/main/java/org/eclipse/configjsr/ArrayConverterTest.java index 0c0f967..935e75d 100644 --- a/tck/src/main/java/org/eclipse/configjsr/ArrayConverterTest.java +++ b/tck/src/main/java/org/eclipse/configjsr/ArrayConverterTest.java @@ -33,11 +33,11 @@ import java.util.List; import java.util.Set; -import javax.config.spi.Converter; +import jakarta.config.spi.Converter; import javax.inject.Inject; -import javax.config.Config; -import javax.config.inject.ConfigProperty; +import jakarta.config.Config; +import jakarta.config.inject.ConfigProperty; import org.eclipse.configjsr.converters.Pizza; import org.eclipse.configjsr.converters.PizzaConverter; import org.jboss.arquillian.container.test.api.Deployment; diff --git a/tck/src/main/java/org/eclipse/configjsr/AutoDiscoveredConfigSourceTest.java b/tck/src/main/java/org/eclipse/configjsr/AutoDiscoveredConfigSourceTest.java index be2fc24..a2e8122 100644 --- a/tck/src/main/java/org/eclipse/configjsr/AutoDiscoveredConfigSourceTest.java +++ b/tck/src/main/java/org/eclipse/configjsr/AutoDiscoveredConfigSourceTest.java @@ -19,10 +19,10 @@ *******************************************************************************/ package org.eclipse.configjsr; -import javax.config.Config; -import javax.config.spi.ConfigProviderResolver; -import javax.config.spi.ConfigSource; -import javax.config.spi.Converter; +import jakarta.config.Config; +import jakarta.config.spi.ConfigProviderResolver; +import jakarta.config.spi.ConfigSource; +import jakarta.config.spi.Converter; import org.eclipse.configjsr.configsources.CustomDbConfigSource; import org.eclipse.configjsr.converters.Pizza; import org.eclipse.configjsr.converters.PizzaConverter; diff --git a/tck/src/main/java/org/eclipse/configjsr/CDIPlainInjectionTest.java b/tck/src/main/java/org/eclipse/configjsr/CDIPlainInjectionTest.java index 4aed84d..5c8fc33 100644 --- a/tck/src/main/java/org/eclipse/configjsr/CDIPlainInjectionTest.java +++ b/tck/src/main/java/org/eclipse/configjsr/CDIPlainInjectionTest.java @@ -22,8 +22,8 @@ import java.util.HashMap; import java.util.Map; -import javax.config.inject.ConfigProperty; -import javax.config.spi.ConfigSource; +import jakarta.config.inject.ConfigProperty; +import jakarta.config.spi.ConfigSource; import javax.enterprise.context.Dependent; import javax.enterprise.inject.spi.CDI; import javax.inject.Inject; diff --git a/tck/src/main/java/org/eclipse/configjsr/CDIPropertyNameMatchingTest.java b/tck/src/main/java/org/eclipse/configjsr/CDIPropertyNameMatchingTest.java index 83555f5..f1c53de 100644 --- a/tck/src/main/java/org/eclipse/configjsr/CDIPropertyNameMatchingTest.java +++ b/tck/src/main/java/org/eclipse/configjsr/CDIPropertyNameMatchingTest.java @@ -23,7 +23,7 @@ import static org.hamcrest.Matchers.equalTo; import static org.hamcrest.Matchers.is; -import javax.config.inject.ConfigProperty; +import jakarta.config.inject.ConfigProperty; import javax.enterprise.context.Dependent; import javax.enterprise.inject.spi.CDI; import javax.inject.Inject; diff --git a/tck/src/main/java/org/eclipse/configjsr/ConfigAccessorTest.java b/tck/src/main/java/org/eclipse/configjsr/ConfigAccessorTest.java index 38a433a..37abaa3 100644 --- a/tck/src/main/java/org/eclipse/configjsr/ConfigAccessorTest.java +++ b/tck/src/main/java/org/eclipse/configjsr/ConfigAccessorTest.java @@ -21,9 +21,9 @@ import java.time.Duration; import java.time.temporal.ChronoUnit; -import javax.config.Config; -import javax.config.ConfigAccessor; -import javax.config.spi.ConfigSource; +import jakarta.config.Config; +import jakarta.config.ConfigAccessor; +import jakarta.config.spi.ConfigSource; import javax.inject.Inject; import org.eclipse.configjsr.base.AbstractTest; diff --git a/tck/src/main/java/org/eclipse/configjsr/ConfigProviderTest.java b/tck/src/main/java/org/eclipse/configjsr/ConfigProviderTest.java index 9ee35ce..1081435 100644 --- a/tck/src/main/java/org/eclipse/configjsr/ConfigProviderTest.java +++ b/tck/src/main/java/org/eclipse/configjsr/ConfigProviderTest.java @@ -28,10 +28,10 @@ import java.util.Properties; import java.util.concurrent.atomic.AtomicBoolean; -import javax.config.Config; +import jakarta.config.Config; import javax.inject.Inject; -import javax.config.spi.ConfigSource; +import jakarta.config.spi.ConfigSource; import org.eclipse.configjsr.base.AbstractTest; import org.hamcrest.CoreMatchers; import org.hamcrest.MatcherAssert; diff --git a/tck/src/main/java/org/eclipse/configjsr/ConverterTest.java b/tck/src/main/java/org/eclipse/configjsr/ConverterTest.java index 6186555..92e72ea 100644 --- a/tck/src/main/java/org/eclipse/configjsr/ConverterTest.java +++ b/tck/src/main/java/org/eclipse/configjsr/ConverterTest.java @@ -29,12 +29,12 @@ import java.time.OffsetDateTime; import java.time.OffsetTime; -import javax.config.Config; -import javax.config.inject.ConfigProperty; -import javax.config.spi.ConfigProviderResolver; -import javax.config.spi.ConfigSource; -import javax.config.spi.ConfigSourceProvider; -import javax.config.spi.Converter; +import jakarta.config.Config; +import jakarta.config.inject.ConfigProperty; +import jakarta.config.spi.ConfigProviderResolver; +import jakarta.config.spi.ConfigSource; +import jakarta.config.spi.ConfigSourceProvider; +import jakarta.config.spi.Converter; import javax.inject.Inject; import org.eclipse.configjsr.base.AbstractTest; diff --git a/tck/src/main/java/org/eclipse/configjsr/CustomConfigSourceTest.java b/tck/src/main/java/org/eclipse/configjsr/CustomConfigSourceTest.java index 4aa0387..7073192 100644 --- a/tck/src/main/java/org/eclipse/configjsr/CustomConfigSourceTest.java +++ b/tck/src/main/java/org/eclipse/configjsr/CustomConfigSourceTest.java @@ -19,12 +19,12 @@ */ package org.eclipse.configjsr; -import javax.config.spi.ConfigProviderResolver; +import jakarta.config.spi.ConfigProviderResolver; import javax.inject.Inject; -import javax.config.Config; -import javax.config.spi.ConfigSource; -import javax.config.spi.ConfigSourceProvider; +import jakarta.config.Config; +import jakarta.config.spi.ConfigSource; +import jakarta.config.spi.ConfigSourceProvider; import org.eclipse.configjsr.configsources.CustomConfigSourceProvider; import org.eclipse.configjsr.configsources.CustomDbConfigSource; import org.jboss.arquillian.container.test.api.Deployment; diff --git a/tck/src/main/java/org/eclipse/configjsr/DynamicConfigSourceTest.java b/tck/src/main/java/org/eclipse/configjsr/DynamicConfigSourceTest.java index 2f705b5..c534ad9 100644 --- a/tck/src/main/java/org/eclipse/configjsr/DynamicConfigSourceTest.java +++ b/tck/src/main/java/org/eclipse/configjsr/DynamicConfigSourceTest.java @@ -24,9 +24,9 @@ import java.time.Duration; import java.time.temporal.ChronoUnit; -import javax.config.Config; -import javax.config.ConfigAccessor; -import javax.config.spi.ConfigSource; +import jakarta.config.Config; +import jakarta.config.ConfigAccessor; +import jakarta.config.spi.ConfigSource; import javax.inject.Inject; import org.eclipse.configjsr.dynamic.DynamicChangeConfigSource; diff --git a/tck/src/main/java/org/eclipse/configjsr/EmptyValuesBean.java b/tck/src/main/java/org/eclipse/configjsr/EmptyValuesBean.java index 161b07b..bbd4957 100644 --- a/tck/src/main/java/org/eclipse/configjsr/EmptyValuesBean.java +++ b/tck/src/main/java/org/eclipse/configjsr/EmptyValuesBean.java @@ -19,7 +19,7 @@ */ package org.eclipse.configjsr; -import javax.config.inject.ConfigProperty; +import jakarta.config.inject.ConfigProperty; import javax.enterprise.context.ApplicationScoped; import javax.inject.Inject; diff --git a/tck/src/main/java/org/eclipse/configjsr/EmptyValuesTest.java b/tck/src/main/java/org/eclipse/configjsr/EmptyValuesTest.java index 757dc57..599b48f 100644 --- a/tck/src/main/java/org/eclipse/configjsr/EmptyValuesTest.java +++ b/tck/src/main/java/org/eclipse/configjsr/EmptyValuesTest.java @@ -19,7 +19,7 @@ */ package org.eclipse.configjsr; -import javax.config.Config; +import jakarta.config.Config; import org.jboss.arquillian.container.test.api.Deployment; import org.jboss.arquillian.testng.Arquillian; import org.jboss.shrinkwrap.api.Archive; diff --git a/tck/src/main/java/org/eclipse/configjsr/ImplicitConverterTest.java b/tck/src/main/java/org/eclipse/configjsr/ImplicitConverterTest.java index 4c15c91..bbda509 100644 --- a/tck/src/main/java/org/eclipse/configjsr/ImplicitConverterTest.java +++ b/tck/src/main/java/org/eclipse/configjsr/ImplicitConverterTest.java @@ -19,7 +19,7 @@ package org.eclipse.configjsr; -import javax.config.Config; +import jakarta.config.Config; import javax.inject.Inject; import org.eclipse.configjsr.converters.implicit.ConvTestTypeWCharSequenceCt; diff --git a/tck/src/main/java/org/eclipse/configjsr/OptionalValuesBean.java b/tck/src/main/java/org/eclipse/configjsr/OptionalValuesBean.java index 23b159e..19f4517 100644 --- a/tck/src/main/java/org/eclipse/configjsr/OptionalValuesBean.java +++ b/tck/src/main/java/org/eclipse/configjsr/OptionalValuesBean.java @@ -28,7 +28,7 @@ import javax.enterprise.context.Dependent; import javax.inject.Inject; -import javax.config.inject.ConfigProperty; +import jakarta.config.inject.ConfigProperty; @Dependent public class OptionalValuesBean { diff --git a/tck/src/main/java/org/eclipse/configjsr/broken/ConfigOwner.java b/tck/src/main/java/org/eclipse/configjsr/broken/ConfigOwner.java index 2884108..35ff039 100644 --- a/tck/src/main/java/org/eclipse/configjsr/broken/ConfigOwner.java +++ b/tck/src/main/java/org/eclipse/configjsr/broken/ConfigOwner.java @@ -22,7 +22,7 @@ import javax.enterprise.context.RequestScoped; import javax.inject.Inject; -import javax.config.inject.ConfigProperty; +import jakarta.config.inject.ConfigProperty; /** * A bean contains a config property injection * diff --git a/tck/src/main/java/org/eclipse/configjsr/broken/CustomConverterBean.java b/tck/src/main/java/org/eclipse/configjsr/broken/CustomConverterBean.java index 3375a85..0d3ea0b 100644 --- a/tck/src/main/java/org/eclipse/configjsr/broken/CustomConverterBean.java +++ b/tck/src/main/java/org/eclipse/configjsr/broken/CustomConverterBean.java @@ -22,7 +22,7 @@ import javax.enterprise.context.RequestScoped; import javax.inject.Inject; -import javax.config.inject.ConfigProperty; +import jakarta.config.inject.ConfigProperty; /** * A bean contains a config property injection, which converts to CustomType * diff --git a/tck/src/main/java/org/eclipse/configjsr/configsources/ConfigurableConfigSource.java b/tck/src/main/java/org/eclipse/configjsr/configsources/ConfigurableConfigSource.java index 7e39302..0a97260 100644 --- a/tck/src/main/java/org/eclipse/configjsr/configsources/ConfigurableConfigSource.java +++ b/tck/src/main/java/org/eclipse/configjsr/configsources/ConfigurableConfigSource.java @@ -25,8 +25,8 @@ import java.util.Set; import java.util.function.Consumer; -import javax.config.Config; -import javax.config.spi.ConfigSource; +import jakarta.config.Config; +import jakarta.config.spi.ConfigSource; /** * A ConfigSource which can be used to play through multiple diff --git a/tck/src/main/java/org/eclipse/configjsr/configsources/CustomConfigSourceProvider.java b/tck/src/main/java/org/eclipse/configjsr/configsources/CustomConfigSourceProvider.java index e5261c2..e14d978 100644 --- a/tck/src/main/java/org/eclipse/configjsr/configsources/CustomConfigSourceProvider.java +++ b/tck/src/main/java/org/eclipse/configjsr/configsources/CustomConfigSourceProvider.java @@ -25,8 +25,8 @@ import java.util.Enumeration; import java.util.List; -import javax.config.spi.ConfigSource; -import javax.config.spi.ConfigSourceProvider; +import jakarta.config.spi.ConfigSource; +import jakarta.config.spi.ConfigSourceProvider; /** diff --git a/tck/src/main/java/org/eclipse/configjsr/configsources/CustomDbConfigSource.java b/tck/src/main/java/org/eclipse/configjsr/configsources/CustomDbConfigSource.java index 94e1c5d..57a6984 100644 --- a/tck/src/main/java/org/eclipse/configjsr/configsources/CustomDbConfigSource.java +++ b/tck/src/main/java/org/eclipse/configjsr/configsources/CustomDbConfigSource.java @@ -22,7 +22,7 @@ import java.util.HashMap; import java.util.Map; -import javax.config.spi.ConfigSource; +import jakarta.config.spi.ConfigSource; /** * @author Mark Struberg diff --git a/tck/src/main/java/org/eclipse/configjsr/configsources/SampleYamlConfigSource.java b/tck/src/main/java/org/eclipse/configjsr/configsources/SampleYamlConfigSource.java index 6f1bf29..de44bd3 100644 --- a/tck/src/main/java/org/eclipse/configjsr/configsources/SampleYamlConfigSource.java +++ b/tck/src/main/java/org/eclipse/configjsr/configsources/SampleYamlConfigSource.java @@ -23,7 +23,7 @@ import java.util.HashMap; import java.util.Map; -import javax.config.spi.ConfigSource; +import jakarta.config.spi.ConfigSource; /** * @author Mark Struberg diff --git a/tck/src/main/java/org/eclipse/configjsr/converters/DuckConverter.java b/tck/src/main/java/org/eclipse/configjsr/converters/DuckConverter.java index c84a793..e48a60c 100644 --- a/tck/src/main/java/org/eclipse/configjsr/converters/DuckConverter.java +++ b/tck/src/main/java/org/eclipse/configjsr/converters/DuckConverter.java @@ -19,7 +19,7 @@ */ package org.eclipse.configjsr.converters; -import javax.config.spi.Converter; +import jakarta.config.spi.Converter; /** * @author Mark Struberg diff --git a/tck/src/main/java/org/eclipse/configjsr/converters/PizzaConverter.java b/tck/src/main/java/org/eclipse/configjsr/converters/PizzaConverter.java index 11f92f9..e7d3e1e 100644 --- a/tck/src/main/java/org/eclipse/configjsr/converters/PizzaConverter.java +++ b/tck/src/main/java/org/eclipse/configjsr/converters/PizzaConverter.java @@ -19,7 +19,7 @@ */ package org.eclipse.configjsr.converters; -import javax.config.spi.Converter; +import jakarta.config.spi.Converter; /** * @author Emily Jiang diff --git a/tck/src/main/java/org/eclipse/configjsr/converters/UpperCaseDuckConverter.java b/tck/src/main/java/org/eclipse/configjsr/converters/UpperCaseDuckConverter.java index 40fa182..879d586 100644 --- a/tck/src/main/java/org/eclipse/configjsr/converters/UpperCaseDuckConverter.java +++ b/tck/src/main/java/org/eclipse/configjsr/converters/UpperCaseDuckConverter.java @@ -20,7 +20,7 @@ package org.eclipse.configjsr.converters; import javax.annotation.Priority; -import javax.config.spi.Converter; +import jakarta.config.spi.Converter; /** * Always create a duck with an upper case name diff --git a/tck/src/main/java/org/eclipse/configjsr/dynamic/DynamicChangeConfigSource.java b/tck/src/main/java/org/eclipse/configjsr/dynamic/DynamicChangeConfigSource.java index b64f280..d367ad2 100644 --- a/tck/src/main/java/org/eclipse/configjsr/dynamic/DynamicChangeConfigSource.java +++ b/tck/src/main/java/org/eclipse/configjsr/dynamic/DynamicChangeConfigSource.java @@ -25,7 +25,7 @@ import java.util.concurrent.atomic.AtomicInteger; import java.util.function.Consumer; -import javax.config.spi.ConfigSource; +import jakarta.config.spi.ConfigSource; /** * A ConfigSource which changes it's values in the background every 10 ms. diff --git a/tck/src/main/resources/internal/META-INF/services/javax.config.spi.ConfigSource b/tck/src/main/resources/internal/META-INF/services/jakarta.config.spi.ConfigSource similarity index 100% rename from tck/src/main/resources/internal/META-INF/services/javax.config.spi.ConfigSource rename to tck/src/main/resources/internal/META-INF/services/jakarta.config.spi.ConfigSource