sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From desruisse...@apache.org
Subject [sis] branch 1.0-RC updated: Remove an interface not needed for 1.0 release. It will give us more time to experiment it. Fix a version number in root pom.xml.
Date Mon, 16 Sep 2019 09:20:27 GMT
This is an automated email from the ASF dual-hosted git repository.

desruisseaux pushed a commit to branch 1.0-RC
in repository https://gitbox.apache.org/repos/asf/sis.git


The following commit(s) were added to refs/heads/1.0-RC by this push:
     new 266a579  Remove an interface not needed for 1.0 release. It will give us more time
to experiment it. Fix a version number in root pom.xml.
266a579 is described below

commit 266a57915b68d9ac92be1dccd00b8f28bb166fc5
Author: Martin Desruisseaux <martin.desruisseaux@geomatys.com>
AuthorDate: Mon Sep 16 11:19:01 2019 +0200

    Remove an interface not needed for 1.0 release. It will give us more time to experiment
it.
    Fix a version number in root pom.xml.
---
 pom.xml                                            |   2 +-
 .../sis/storage/WritableGridCoverageResource.java  | 106 ---------------------
 2 files changed, 1 insertion(+), 107 deletions(-)

diff --git a/pom.xml b/pom.xml
index b1e576b..7027572 100644
--- a/pom.xml
+++ b/pom.xml
@@ -560,7 +560,7 @@
     <maven.compiler.source>8</maven.compiler.source>
     <maven.compiler.target>8</maven.compiler.target>
     <sis.plugin.version>${project.version}</sis.plugin.version>
-    <sis.non-free.version>1.0-M1</sis.non-free.version>                 <!--
Used only if "non-free" profile is enabled. -->
+    <sis.non-free.version>1.0</sis.non-free.version>                 <!--
Used only if "non-free" profile is enabled. -->
     <geoapi.version>3.0.1</geoapi.version>
     <jaxb.version>2.3.2</jaxb.version>
   </properties>
diff --git a/storage/sis-storage/src/main/java/org/apache/sis/storage/WritableGridCoverageResource.java
b/storage/sis-storage/src/main/java/org/apache/sis/storage/WritableGridCoverageResource.java
deleted file mode 100644
index e377c97..0000000
--- a/storage/sis-storage/src/main/java/org/apache/sis/storage/WritableGridCoverageResource.java
+++ /dev/null
@@ -1,106 +0,0 @@
-/*
- * Licensed to the Apache Software Foundation (ASF) under one or more
- * contributor license agreements.  See the NOTICE file distributed with
- * this work for additional information regarding copyright ownership.
- * The ASF licenses this file to You under the Apache License, Version 2.0
- * (the "License"); you may not use this file except in compliance with
- * the License.  You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-package org.apache.sis.storage;
-
-import org.apache.sis.coverage.grid.GridCoverage;
-import org.apache.sis.coverage.grid.GridGeometry;
-
-
-/**
- * A {@link GridCoverageResource} with writing capabilities. {@code WritableGridCoverageResource}
inherits the reading
- * capabilities from its parent and adds a {@linkplain #write write} operation. Some aspects
of the write operation can
- * be controlled by options, which may be {@link DataStore}-specific.
- *
- * @author  Johann Sorel (Geomatys)
- * @version 1.0
- * @since   1.0
- * @module
- */
-public interface WritableGridCoverageResource extends GridCoverageResource {
-    /**
-     * Configuration of the process of writing a coverage in a data store.
-     * By default, the {@linkplain #write write operation} is conservative: no operation
is executed
-     * if it would result in data lost. {@code Option} allows to modify this behavior for
example by
-     * allowing the {@linkplain CommonOption#TRUNCATE replacement} of previous data.
-     * Options can also configure other aspects like compression, version or encryption.
-     *
-     * <p>Some options may be {@link DataStore}-specific.
-     * Options that may apply to any data store are provided in the {@link CommonOption}
enumeration.
-     * Other options may be defined by the {@linkplain DataStoreProvider} of specific formats.</p>
-     *
-     * @author  Johann Sorel (Geomatys)
-     * @version 1.0
-     * @since   1.0
-     * @module
-     */
-    interface Option {}
-
-    /**
-     * Write options that may apply to any data store. The coverage {@linkplain #write write
operation}
-     * is configured by instances of {@link Option}, sometime in a {@link DataStore}-specific
basis.
-     * This {@code CommonOption} enumeration provides options that do not depend on the data
store.
-     *
-     * @author  Johann Sorel (Geomatys)
-     * @version 1.0
-     * @since   1.0
-     * @module
-     */
-    enum CommonOption implements Option {
-        /**
-         * Instructs the write operation to replace existing coverage if one exists.
-         * By default the {@linkplain #write write operation} does not overwrite existing
data.
-         * If this option is specified, then there is a choice:
-         *
-         * <ul>
-         *   <li>If a coverage already exists in the {@link GridCoverageResource},
then it will be erased.
-         *       The existing data will be replaced by the new coverage.</li>
-         *   <li>If there are no existing coverage in the {@link GridCoverageResource},
-         *       then the new coverage will be inserted as if this option was not provided.</li>
-         * </ul>
-         */
-        TRUNCATE,
-
-        /**
-         * Updates or appends existing coverage with new data.
-         * If a coverage already exists when the {@linkplain #write write operation} is
executed with this option, then:
-         *
-         * <ul>
-         *   <li>Areas of the provided {@link GridCoverage} that are within the existing
{@link GridGeometry}
-         *       will overwrite the existing data.</li>
-         *   <li>Areas outside the existing {@link GridGeometry} will result in expanding
the grid geometry
-         *       with the new data.</li>
-         * </ul>
-         *
-         * If there are no previous coverage, then the new coverage is inserted as if this
option was not provided.
-         */
-        UPDATE
-    }
-
-    /**
-     * Writes a new coverage in the data store for this resource. If a coverage already exists
for this resource,
-     * then the behavior of this method is determined by the given options. If no option
is specified, the default
-     * behavior is to fail if writing a coverage would cause an existing coverage to be overwritten.
-     * This behavior can be modified by requesting the {@linkplain CommonOption#TRUNCATE
replacement}
-     * or {@linkplain CommonOption#UPDATE update} of existing coverages.
-     *
-     * @param  coverage  new data to write in the data store for this resource.
-     * @param  options   configuration of the write operation. May be {@link DataStore}-specific
options
-     *                   (e.g. for compression, encryption, <i>etc</i>).
-     * @throws DataStoreException if an error occurred while writing data in the underlying
data store.
-     */
-    void write(GridCoverage coverage, Option... options) throws DataStoreException;
-}


Mime
View raw message