Merge pull request #110 from sbesson/s3_deprecation

Deprecate the S3 interfaces, implementations and services

Author: sbesson

src/main/java/loci/common/S3Handle.java

@@ -54,12 +54,15 @@
 /**
  * Provides random access to S3 buckets using the IRandomAccess interface.
  * Instances of S3Handle are read-only.
+ * @deprecated The S3 implementations and services will be removed from
+ * the ome-common library in version 7.0.0
  *
  * @see IRandomAccess
  * @see StreamHandle
  * @see java.net.URLConnection
  *
  */
+@Deprecated
 public class S3Handle extends StreamHandle {
 
   /**

src/main/java/loci/common/services/S3ClientService.java

@@ -37,7 +37,10 @@
 
 /**
  * An S3 client
+ * @deprecated The S3 implementations and services will be removed from
+ * the ome-common library in version 7.0.0
  */
+@Deprecated
 public interface S3ClientService extends Service {
 
   /**

src/main/java/loci/common/services/S3ClientServiceException.java

@@ -34,7 +34,10 @@
 
 /**
  * Exception thrown when internal error specific to the S3 client is raised
+ * @deprecated The S3 implementations and services will be removed from
+ * the ome-common library in version 7.0.0
  */
+@Deprecated
 public class S3ClientServiceException extends ServiceException
 {
   /**

src/main/java/loci/common/services/S3ClientServiceImpl.java

@@ -43,7 +43,10 @@
 
 /**
  * An S3 client
+ * @deprecated The S3 implementations and services will be removed from
+ * the ome-common library in version 7.0.0
  */
+@Deprecated
 public class S3ClientServiceImpl extends AbstractService implements S3ClientService {
 
   /**

src/main/java/loci/common/services/S3ClientStat.java

@@ -34,7 +34,10 @@
 
 /**
  * Object stat (attributes) information
+ * @deprecated The S3 implementations and services will be removed from
+ * the ome-common library in version 7.0.0
  */
+@Deprecated
 public class S3ClientStat {
   /**
    * Create stat object storing length of object

src/main/java/loci/common/services/services.properties

@@ -54,6 +54,8 @@ loci.formats.services.JPEGTurboService=loci.formats.services.JPEGTurboServiceImp
 loci.formats.services.EXIFService=loci.formats.services.EXIFServiceImpl
 loci.formats.services.JPEGXRService=loci.formats.services.JPEGXRServiceImpl
 # Minio S3 client service
+# Deprecated: the S3 implementations and services will be removed from
+# the ome-common library in version 7.0.0
 loci.common.services.S3ClientService=loci.common.services.S3ClientServiceImpl
 # OME Codecs JAI Image I/O service
 ome.codecs.services.JAIIIOService=ome.codecs.services.JAIIIOServiceImpl

src/test/java/loci/common/utests/S3ClientServiceTest.java

@@ -58,9 +58,12 @@
 
 /**
  * Unit tests for the loci.common.service.S3ClientServiceImpl class.
+ * @deprecated The S3 implementations and services will be removed from
+ * the ome-common library in version 7.0.0
  *
  * @see loci.common.URLHandle
  */
+@Deprecated
 @Test(groups="readTests")
 public class S3ClientServiceTest {
 

src/test/java/loci/common/utests/S3HandleTest.java

@@ -51,9 +51,12 @@
 
 /**
  * Unit tests for the loci.common.S3Handle class.
+ * @deprecated The S3 implementations and services will be removed from
+ * the ome-common library in version 7.0.0
  *
  * @see loci.common.URLHandle
  */
+@Deprecated
 @Test(groups="readTests")
 public class S3HandleTest {