sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From desruisse...@apache.org
Subject svn commit: r1498890 - in /sis/branches/JDK7: core/sis-metadata/src/main/java/org/apache/sis/metadata/ModifiableMetadata.java storage/sis-storage/src/main/java/org/apache/sis/storage/DataStoreProvider.java
Date Tue, 02 Jul 2013 11:45:16 GMT
Author: desruisseaux
Date: Tue Jul  2 11:45:16 2013
New Revision: 1498890

URL: http://svn.apache.org/r1498890
Log:
Added warnings about methods that are likely to change.

Modified:
    sis/branches/JDK7/core/sis-metadata/src/main/java/org/apache/sis/metadata/ModifiableMetadata.java
    sis/branches/JDK7/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStoreProvider.java

Modified: sis/branches/JDK7/core/sis-metadata/src/main/java/org/apache/sis/metadata/ModifiableMetadata.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-metadata/src/main/java/org/apache/sis/metadata/ModifiableMetadata.java?rev=1498890&r1=1498889&r2=1498890&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-metadata/src/main/java/org/apache/sis/metadata/ModifiableMetadata.java
[UTF-8] (original)
+++ sis/branches/JDK7/core/sis-metadata/src/main/java/org/apache/sis/metadata/ModifiableMetadata.java
[UTF-8] Tue Jul  2 11:45:16 2013
@@ -125,6 +125,13 @@ public abstract class ModifiableMetadata
      * Returns {@code true} if this metadata is modifiable. This method returns
      * {@code false} if {@link #freeze()} has been invoked on this object.
      *
+     * <table width="80%" align="center" cellpadding="18" border="4" bgcolor="#FFE0B0">
+     *   <tr><td>
+     *     <b>Warning:</b> this method is likely to change. SIS 0.4 will probably
uses a "state" enumeration
+     *     (modifiable, appendable, etc.).
+     *   </td></tr>
+     * </table>
+     *
      * @return {@code true} if this metadata is modifiable.
      *
      * @see #freeze()
@@ -162,6 +169,13 @@ public abstract class ModifiableMetadata
      *       {@linkplain #freeze() freeze} the clone before to return it.</li>
      * </ul>
      *
+     * <table width="80%" align="center" cellpadding="18" border="4" bgcolor="#FFE0B0">
+     *   <tr><td>
+     *     <b>Warning:</b> this method is likely to change. SIS 0.4 will probably
uses a "state" enumeration
+     *     (modifiable, appendable, etc.).
+     *   </td></tr>
+     * </table>
+     *
      * @return An unmodifiable copy of this metadata.
      */
     public AbstractMetadata unmodifiable() {
@@ -200,6 +214,13 @@ public abstract class ModifiableMetadata
      * <p>Subclasses usually don't need to override this method since the default implementation
      * performs its work using Java reflection.</p>
      *
+     * <table width="80%" align="center" cellpadding="18" border="4" bgcolor="#FFE0B0">
+     *   <tr><td>
+     *     <b>Warning:</b> this method is likely to change. SIS 0.4 will probably
uses a "state" enumeration
+     *     (modifiable, appendable, etc.).
+     *   </td></tr>
+     * </table>
+     *
      * @see #isModifiable()
      * @see #checkWritePermission()
      */

Modified: sis/branches/JDK7/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStoreProvider.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStoreProvider.java?rev=1498890&r1=1498889&r2=1498890&view=diff
==============================================================================
--- sis/branches/JDK7/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStoreProvider.java
[UTF-8] (original)
+++ sis/branches/JDK7/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStoreProvider.java
[UTF-8] Tue Jul  2 11:45:16 2013
@@ -66,6 +66,13 @@ public abstract class DataStoreProvider 
      * {@link java.nio.ByteBuffer#mark()}, {@link java.io.InputStream#mark(int)} and
      * {@link javax.imageio.stream.ImageInputStream#mark()}.
      *
+     * <table width="80%" align="center" cellpadding="18" border="4" bgcolor="#FFE0B0">
+     *   <tr><td>
+     *     <b>Warning:</b> this method is likely to change. SIS 0.4 will probably
return a set of enumeration
+     *     values describing how the file can be open (read, write, append) similar to JDK7
open mode.
+     *   </td></tr>
+     * </table>
+     *
      * @param  storage Information about the storage (URL, stream, JDBC connection, <i>etc</i>).
      * @return {@link Boolean#TRUE} if the given storage seems to be usable by the {@code
DataStore} instances
      *         create by this provider, {@link Boolean#FALSE} if the {@code DataStore} will
not be able to use



Mime
View raw message