Deprecated extensions for future removal

Deprecated GAE, GWT, OSGi and RDF extensions for removal in next major release.
restlet · Oct 28, 2024 · 42d09a7 · 42d09a7
1 parent 37d5d73
commit 42d09a7
Show file tree

Hide file tree

Showing 57 changed files with 109 additions and 9 deletions.
diff --git a/changes.md b/changes.md
@@ -20,6 +20,7 @@ Changes log
       - Removed incubator to rely instead on pull requests.
       - Renamed extension Inject into Guice as it isn't truly generic.
       - Updated the links in all Javadocs file for accuracy.
+      - Deprecated GAE, GWT, OSGi and RDF extensions for removal in next major release.
 
 - 2.5 Milestone 1 (03/09/2020)
     - Bugs fixed

diff --git a/org.restlet.java/org.restlet.ext.gae/src/main/java/org/restlet/ext/gae/GaeAuthenticator.java b/org.restlet.java/org.restlet.ext.gae/src/main/java/org/restlet/ext/gae/GaeAuthenticator.java
@@ -25,7 +25,9 @@
  * UserService.
  * 
  * @author Matt Kennedy
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class GaeAuthenticator extends Authenticator {
     /**
      * The GAE UserService that provides facilities to check whether a user has

diff --git a/org.restlet.java/org.restlet.ext.gae/src/main/java/org/restlet/ext/gae/GaeEnroler.java b/org.restlet.java/org.restlet.ext.gae/src/main/java/org/restlet/ext/gae/GaeEnroler.java
@@ -21,7 +21,9 @@
  * {@link ClientInfo} if the GAE API reports that the user is an administrator.
  * 
  * @author Matt Kennedy
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class GaeEnroler implements Enroler {
 
     /** The Administrator role. */

diff --git a/org.restlet.java/org.restlet.ext.gae/src/main/java/org/restlet/ext/gae/package.html b/org.restlet.java/org.restlet.ext.gae/src/main/java/org/restlet/ext/gae/package.html
@@ -5,5 +5,6 @@
 @since Restlet 2.1
 @see <a href="@home-uri@">Google App Engine</a>
 @see <a href="http://restlet.org/learn/guide/2.2/extensions/gae">User Guide - GAE extension</a>
+@deprecated Will be removed in next major release.
 </BODY>
 </HTML>
diff --git a/org.restlet.java/org.restlet.ext.gwt/src/main/java/org/restlet/ext/gwt/GwtConverter.java b/org.restlet.java/org.restlet.ext.gwt/src/main/java/org/restlet/ext/gwt/GwtConverter.java
@@ -30,7 +30,9 @@
  * serialization format.
  * 
  * @author Jerome Louvel
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class GwtConverter extends ConverterHelper {
 
     /** GWT variant. */

diff --git a/...tlet.java/org.restlet.ext.gwt/src/main/java/org/restlet/ext/gwt/ObjectRepresentation.java b/...tlet.java/org.restlet.ext.gwt/src/main/java/org/restlet/ext/gwt/ObjectRepresentation.java
@@ -28,7 +28,9 @@
  * @author Jerome Louvel
  * @param <T>
  *            The class to serialize.
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class ObjectRepresentation<T> extends StringRepresentation {
 
     /** The wrapped object. */

diff --git a/...java/org.restlet.ext.gwt/src/main/java/org/restlet/ext/gwt/SimpleSerializationPolicy.java b/...java/org.restlet.ext.gwt/src/main/java/org/restlet/ext/gwt/SimpleSerializationPolicy.java
@@ -17,7 +17,9 @@
  * fields.
  * 
  * @author Jerome Louvel
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class SimpleSerializationPolicy extends SerializationPolicy {
 
     private static final SimpleSerializationPolicy instance = new SimpleSerializationPolicy();

diff --git a/....restlet.ext.gwt/src/main/java/org/restlet/ext/gwt/SimpleSerializationPolicyProvider.java b/....restlet.ext.gwt/src/main/java/org/restlet/ext/gwt/SimpleSerializationPolicyProvider.java
@@ -17,7 +17,9 @@
  * {@link SimpleSerializationPolicy} default instance all the time.
  * 
  * @author Jerome Louvel
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class SimpleSerializationPolicyProvider implements
         SerializationPolicyProvider {
 

diff --git a/org.restlet.java/org.restlet.ext.gwt/src/main/java/org/restlet/ext/gwt/package.html b/org.restlet.java/org.restlet.ext.gwt/src/main/java/org/restlet/ext/gwt/package.html
@@ -1,9 +1,10 @@
 <HTML>
 <BODY>
-Server-side integration with GWT @minor-version@. 
+Server-side integration with GWT. 
 
 @since Restlet 1.1
 @see <a href="@home-uri@">Google Web Toolkit</a>
 @see <a href="http://restlet.org/learn/guide/2.2/extensions/gwt">User Guide - GWT extension</a>
+@deprecated Will be removed in next major release.
 </BODY>
 </HTML>
diff --git a/...let.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/ApplicationProvider.java b/...let.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/ApplicationProvider.java
@@ -26,7 +26,9 @@
  * 
  * @author Bryan Hunt
  * @author Wolfgang Werner
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public interface ApplicationProvider {
     /**
      * The key constant that may be used to look up the

diff --git a/...java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/BaseApplicationProvider.java b/...java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/BaseApplicationProvider.java
@@ -57,8 +57,9 @@
  * </p>
  * 
  * @author Bryan Hunt
- * 
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class BaseApplicationProvider implements ApplicationProvider {
     private String alias;
 

diff --git a/...t.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/BaseDirectoryProvider.java b/...t.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/BaseDirectoryProvider.java
@@ -66,8 +66,9 @@
  * </p>
  * 
  * @author Bryan Hunt
- * 
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class BaseDirectoryProvider extends BaseRestletProvider implements
         DirectoryProvider {
     private boolean deeplyAccessible = true;

diff --git a/...tlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/BaseFilterProvider.java b/...tlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/BaseFilterProvider.java
@@ -57,8 +57,9 @@
  * </p>
  * 
  * @author Bryan Hunt
- * 
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public abstract class BaseFilterProvider extends BaseRestletProvider implements
         FilterProvider {
     private Filter filter;

diff --git a/...et.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/BaseResourceProvider.java b/...et.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/BaseResourceProvider.java
@@ -61,8 +61,9 @@
  * </p>
  * 
  * @author Bryan Hunt
- * 
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public abstract class BaseResourceProvider extends BaseRestletProvider
         implements ResourceProvider {
     private Finder finder;

diff --git a/...let.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/BaseRestletProvider.java b/...let.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/BaseRestletProvider.java
@@ -18,8 +18,9 @@
  * but instead extend an appropriate base provider.
  * 
  * @author Bryan Hunt
- * 
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public abstract class BaseRestletProvider implements RestletProvider {
     private FilterProvider filterProvider;
 

diff --git a/...tlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/BaseRouterProvider.java b/...tlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/BaseRouterProvider.java
@@ -53,8 +53,9 @@
  * </p>
  * 
  * @author Bryan Hunt
- * 
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class BaseRouterProvider extends BaseRestletProvider implements
         RouterProvider {
     private RestletProvider defaultRestletProvider;

diff --git a/...stlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/DirectoryProvider.java b/...stlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/DirectoryProvider.java
@@ -17,7 +17,9 @@
  * implementation of {@link DirectoryProvider}.
  * 
  * @author Bryan Hunt
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public interface DirectoryProvider extends RestletProvider {
     /**
      * 

diff --git a/org.restlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/DynamicFinder.java b/org.restlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/DynamicFinder.java
@@ -20,7 +20,9 @@
  * 
  * @author Bryan Hunt
  * @author Wolfgang Werner
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class DynamicFinder extends Finder {
     private Bundle bundle;
 

diff --git a/org.restlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/FilterProvider.java b/org.restlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/FilterProvider.java
@@ -19,7 +19,9 @@
  * {@link FilterProvider} if you need complete control.
  * 
  * @author Bryan Hunt
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public interface FilterProvider extends RestletProvider {
     /**
      * 

diff --git a/...estlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/ObapClientHelper.java b/...estlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/ObapClientHelper.java
@@ -35,7 +35,9 @@
  * Connector to the resources accessed via bundles.
  * 
  * @author Thierry Boileau
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class ObapClientHelper extends LocalClientHelper {
 
     /** Map of registered bundles. */

diff --git a/...estlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/ResourceProvider.java b/...estlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/ResourceProvider.java
@@ -25,7 +25,9 @@
  * 
  * @author Bryan Hunt
  * @author Wolfgang Werner
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public interface ResourceProvider extends RestletProvider {
     /**
      * 

diff --git a/...restlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/RestletProvider.java b/...restlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/RestletProvider.java
@@ -18,7 +18,9 @@
  * specialized provider interfaces.
  * 
  * @author Bryan Hunt
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public interface RestletProvider {
     /**
      * 

diff --git a/org.restlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/RouterProvider.java b/org.restlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/RouterProvider.java
@@ -17,7 +17,8 @@
  * implementation of {@link RouterProvider}.
  * 
  * @author Bryan Hunt
- * 
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public interface RouterProvider extends RestletProvider {
 }
diff --git a/...tlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/internal/Activator.java b/...tlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/internal/Activator.java
@@ -24,7 +24,9 @@
  * 
  * @author Thierry Boileau
  * @See {@link ObapClientHelper}
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class Activator implements BundleActivator {
 
     private static Logger logger = Logger.getLogger("org.restlet.ext.osgi");

diff --git a/org.restlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/package.html b/org.restlet.java/org.restlet.ext.osgi/src/main/java/org/restlet/ext/osgi/package.html
@@ -6,5 +6,6 @@
 @author Bryan Hunt
 @see <a href="@home-uri@">OSGi Web site</a>
 @see <a href="http://restlet.org/learn/guide/2.2/extensions/osgi">User Guide - OSGi extension</a>
+@deprecated Will be removed in next major release.
 </BODY>
 </HTML>
diff --git a/org.restlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/Couple.java b/org.restlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/Couple.java
@@ -22,7 +22,9 @@
  *            The first object's type.
  * @param <U>
  *            The second object's type.
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class Couple<T, U> {
 
     /** The first object. */

diff --git a/org.restlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/Graph.java b/org.restlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/Graph.java
@@ -20,7 +20,9 @@
  * model.
  * 
  * @author Jerome Louvel
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class Graph extends CopyOnWriteArraySet<Link> {
 
     /** The serialization unique identifier. */

diff --git a/org.restlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/GraphBuilder.java b/org.restlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/GraphBuilder.java
@@ -14,7 +14,9 @@
 /**
  * Graph handler used when parsing an RDF representation. It completes the inner
  * set of links with all detected ones.
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class GraphBuilder extends GraphHandler {
 
     /** The inner graph of links. */

diff --git a/org.restlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/GraphHandler.java b/org.restlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/GraphHandler.java
@@ -16,7 +16,9 @@
 /**
  * Handler for the content of a {@link Graph}. List of callbacks used when
  * parsing or writing a representation of a RDF graph.
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public abstract class GraphHandler {
 
     /**

diff --git a/org.restlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/Link.java b/org.restlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/Link.java
@@ -23,7 +23,9 @@
  * 
  * @author Jerome Louvel
  * @see <a href="http://www.w3.org/TR/rdf-concepts/">RDF concepts</a>
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class Link {
 
     /**

diff --git a/org.restlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/Literal.java b/org.restlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/Literal.java
@@ -19,7 +19,9 @@
  * @author Jerome Louvel
  * @see <a href="http://www.w3.org/TR/rdf-concepts/#section-Graph-Literal">RDF
  *      literals</a>
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class Literal {
 
     /** The optional datatype reference. */

diff --git a/...restlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/RdfClientResource.java b/...restlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/RdfClientResource.java
@@ -33,7 +33,9 @@
  * navigate the Web of data.
  * 
  * @author Jerome Louvel
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class RdfClientResource extends ClientResource {
 
     /** The links cache. */

diff --git a/org.restlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/RdfConverter.java b/org.restlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/RdfConverter.java
@@ -24,7 +24,9 @@
  * Converter between the Graph and RDF Representation classes.
  * 
  * @author Thierry Boileau
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class RdfConverter extends ConverterHelper {
 
     private static final VariantInfo VARIANT_RDF_N3 = new VariantInfo(

diff --git a/...restlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/RdfRepresentation.java b/...restlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/RdfRepresentation.java
@@ -34,7 +34,9 @@
  * deserialize a {@link Graph}.
  * 
  * @author Jerome Louvel
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class RdfRepresentation extends WriterRepresentation {
 
     /** The inner graph of links. */

diff --git a/org.restlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/Triple.java b/org.restlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/Triple.java
@@ -24,7 +24,9 @@
  *            The second object's type.
  * @param <V>
  *            The third object's type.
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class Triple<T, U, V> {
 
     /** The first object. */

diff --git a/...let.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/internal/RdfConstants.java b/...let.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/internal/RdfConstants.java
@@ -15,7 +15,9 @@
  * Constants related to RDF documents.
  * 
  * @author Thierry Boileau
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class RdfConstants {
 
     /** List "first". */

diff --git a/...estlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/internal/RdfReader.java b/...estlet.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/internal/RdfReader.java
@@ -17,7 +17,9 @@
 /**
  * Super class of all RDF readers.
  * 
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public abstract class RdfReader {
     /** The graph handler invoked when parsing. */
     private GraphHandler graphHandler;

diff --git a/....java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/internal/n3/FormulaToken.java b/....java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/internal/n3/FormulaToken.java
@@ -19,7 +19,9 @@
  * feature is not supported yet.
  * 
  * @author Thierry Boileau
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class FormulaToken extends LexicalUnit {
 
     public FormulaToken(RdfN3Reader contentHandler, Context context)

diff --git a/...t.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/internal/n3/RdfN3Reader.java b/...t.java/org.restlet.ext.rdf/src/main/java/org/restlet/ext/rdf/internal/n3/RdfN3Reader.java
@@ -32,7 +32,9 @@
  * Handler of RDF content according to the N3 notation.
  * 
  * @author Thierry Boileau
+ * @deprecated Will be removed in next major release.
  */
+@Deprecated
 public class RdfN3Reader extends RdfTurtleReader {
 
     /**