| [Arakhnę-Dev] [130] Add @since tag. |
[ Thread Index |
Date Index
| More arakhne.org/dev Archives
]
Revision: 130
Author: galland
Date: 2010-02-12 22:44:34 +0100 (Fri, 12 Feb 2010)
Log Message:
-----------
Add @since tag.
Modified Paths:
--------------
trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/DynamicURLStreamHandlerFactory.java
trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ExternalizableResource.java
trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/FileSystem.java
trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/FileURLConnection.java
trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/FileURLStreamHandler.java
trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/FileURLStreamHandlerFactory.java
trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/MACNumber.java
trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ReflectionUtil.java
trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ResourceNotFoundException.java
trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ResourceURLConnection.java
trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ResourceURLStreamHandler.java
trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ResourceURLStreamHandlerFactory.java
trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/Resources.java
Modified: trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/DynamicURLStreamHandlerFactory.java
===================================================================
--- trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/DynamicURLStreamHandlerFactory.java 2010-02-12 21:44:13 UTC (rev 129)
+++ trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/DynamicURLStreamHandlerFactory.java 2010-02-12 21:44:34 UTC (rev 130)
@@ -48,6 +48,7 @@
* @version $Name$ $Revision$ $Date$
* @see URLStreamHandlerFactory
* @see URL#setURLStreamHandlerFactory(URLStreamHandlerFactory)
+ * @since 4.2
*/
public class DynamicURLStreamHandlerFactory
implements URLStreamHandlerFactory {
Modified: trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ExternalizableResource.java
===================================================================
--- trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ExternalizableResource.java 2010-02-12 21:44:13 UTC (rev 129)
+++ trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ExternalizableResource.java 2010-02-12 21:44:34 UTC (rev 130)
@@ -28,6 +28,7 @@
*
* @author Stéphane GALLAND <galland@xxxxxxxxxxx>
* @version $Name$ $Revision$ $Date$
+ * @since 4.2
*/
public interface ExternalizableResource {
Modified: trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/FileSystem.java
===================================================================
--- trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/FileSystem.java 2010-02-12 21:44:13 UTC (rev 129)
+++ trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/FileSystem.java 2010-02-12 21:44:34 UTC (rev 130)
@@ -218,25 +218,6 @@
*
* @param filename is the name to parse.
* @return the dirname of the specified file.
- * @see #shortBasename(String)
- * @see #largeBasename(String)
- * @see #basename(String)
- * @see #extension(String)
- * @deprecated use {@link #extension(File)} or {@link #extension(URL)}
- */
- @Deprecated
- public static String dirname(String filename) {
- if (filename==null) return null;
- int idx = filename.lastIndexOf(File.separatorChar);
- if (idx<0) return CURRENT_DIRECTORY;
- if (idx==0) return File.separator;
- return filename.substring(0,idx);
- }
-
- /** Replies the dirname of the specified file.
- *
- * @param filename is the name to parse.
- * @return the dirname of the specified file.
* @see #shortBasename(File)
* @see #largeBasename(File)
* @see #basename(File)
@@ -338,8 +319,6 @@
* @return the basename of the specified file without the last extension.
* @see #shortBasename(String)
* @see #largeBasename(String)
- * @see #dirname(String)
- * @see #extension(String)
*/
public static String basename(String filename) {
if (filename==null) return null;
@@ -444,27 +423,6 @@
*
* @param filename is the name to parse.
* @return the extension of the specified file
- * @deprecated use {@link #extension(File)} or {@link #extension(URL)}
- * @see #shortBasename(String)
- * @see #largeBasename(String)
- * @see #basename(String)
- * @see #dirname(String)
- * @see #extensions(String)
- */
- @Deprecated
- public static String extension(String filename) {
- try {
- return extension(new URL(filename));
- }
- catch(MalformedURLException _) {
- return extension(new File(filename));
- }
- }
-
- /** Reply the extension of the specified file.
- *
- * @param filename is the name to parse.
- * @return the extension of the specified file
* @see #shortBasename(File)
* @see #largeBasename(File)
* @see #basename(File)
@@ -501,23 +459,7 @@
*
* @param filename is the name to parse.
* @return the extensions of the specified file
- * @deprecated use {@link #extensions(File)} or {@link #extensions(URL)}
*/
- @Deprecated
- public static String[] extensions(String filename) {
- try {
- return extensions(new URL(filename));
- }
- catch(MalformedURLException _) {
- return extensions(new File(filename));
- }
- }
-
- /** Reply all the extensions of the specified file.
- *
- * @param filename is the name to parse.
- * @return the extensions of the specified file
- */
public static String[] extensions(File filename) {
if (filename==null) return new String[0];
String largeBasename = largeBasename(filename);
@@ -547,23 +489,7 @@
*
* @param filename is the name to parse.
* @return the parts of a path.
- * @deprecated use {@link #split(File)} or {@link #split(URL)}
*/
- @Deprecated
- public static String[] split(String filename) {
- try {
- return split(new URL(filename));
- }
- catch(MalformedURLException _) {
- return split(new File(filename));
- }
- }
-
- /** Replies the parts of a path.
- *
- * @param filename is the name to parse.
- * @return the parts of a path.
- */
public static String[] split(File filename) {
if (filename==null) return new String[0];
return filename.getPath().split("["+File.separatorChar+"]"); //$NON-NLS-1$ //$NON-NLS-2$
@@ -584,32 +510,6 @@
return path.split("["+URL_PATH_SEPARATOR_CHAR+"]"); //$NON-NLS-1$ //$NON-NLS-2$
}
- /** Join the parts of a path with the current OS directory separator.
- *
- * @param elements are the path's elements to join.
- * @return the result of the join of the path's elements.
- * @deprecated use {@link #split(File)} or {@link #split(URL)}
- */
- @Deprecated
- public static String join(String... elements) {
- StringBuffer buf = new StringBuffer();
- boolean first = true;
- boolean empty;
- for(String elt : elements) {
- empty = (elt==null || elt.length()==0);
- if (first && empty) {
- buf.append(File.separatorChar);
- }
- else if (!empty) {
- if (buf.length()>0 && buf.charAt(buf.length()-1)!=File.separatorChar)
- buf.append(File.separatorChar);
- buf.append(elt);
- }
- first = false;
- }
- return buf.toString();
- }
-
/** Join the parts of a path and append them to the given File.
*
* @param fileBase is the file to put as prefix.
@@ -748,27 +648,7 @@
* @param extension is the extension to test.
* @return <code>true</code> if the given filename has the given extension,
* otherwise <code>false</code>
- * @deprecated use {@link #hasExtension(File,String)} or {@link #hasExtension(URL,String)}
*/
- @Deprecated
- public static boolean hasExtension(String filename, String extension) {
- try {
- return hasExtension(new URL(filename), extension);
- }
- catch(MalformedURLException _) {
- return hasExtension(new File(filename), extension);
- }
- }
-
- /** Replies if the specified file has the specified extension.
- * <p>
- * The test is dependent of the case-sensitive attribute of operating system.
- *
- * @param filename is the filename to parse
- * @param extension is the extension to test.
- * @return <code>true</code> if the given filename has the given extension,
- * otherwise <code>false</code>
- */
public static boolean hasExtension(File filename, String extension) {
if (filename==null) return false;
String extent = extension;
@@ -806,23 +686,7 @@
*
* @param filename is the filename to parse.
* @return the filename without the extension.
- * @deprecated use {@link #removeExtension(File)} or {@link #removeExtension(URL)}
*/
- @Deprecated
- public static String removeExtension(String filename) {
- try {
- return removeExtension(new URL(filename)).toExternalForm();
- }
- catch(MalformedURLException _) {
- return removeExtension(new File(filename)).getPath();
- }
- }
-
- /** Remove the extension from the specified filename.
- *
- * @param filename is the filename to parse.
- * @return the filename without the extension.
- */
public static File removeExtension(File filename) {
if (filename==null) return null;
File dir = filename.getParentFile();
@@ -870,24 +734,6 @@
}
/** Replace the extension of the specified filename by the given extension.
- * If the filename has no extension, the specifiedone will be added.
- *
- * @param filename is the filename to parse.
- * @param extension is the extension to remove if it is existing.
- * @return the filename without the extension.
- * @deprecated use {@link #replaceExtension(File,String)} or {@link #replaceExtension(URL,String)}
- */
- @Deprecated
- public static String replaceExtension(String filename, String extension) {
- try {
- return replaceExtension(new URL(filename), extension).toExternalForm();
- }
- catch(MalformedURLException _) {
- return replaceExtension(new File(filename), extension).getPath();
- }
- }
-
- /** Replace the extension of the specified filename by the given extension.
* If the filename has no extension, the specified one will be added.
*
* @param filename is the filename to parse.
@@ -1206,20 +1052,7 @@
* @param url is the URL to convert.
* @return the file.
* @throws IllegalArgumentException is the URL was malformed.
- * @deprecated see {@link #convertUrlToFile(URL)}
- * @see #convertUrlToFile(URL)
*/
- @Deprecated
- public static File UrlToFile(URL url) {
- return convertUrlToFile(url);
- }
-
- /** Convert an URL which represents a local file into a File.
- *
- * @param url is the URL to convert.
- * @return the file.
- * @throws IllegalArgumentException is the URL was malformed.
- */
public static File convertUrlToFile(URL url) {
URI uri;
try {
Modified: trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/FileURLConnection.java
===================================================================
--- trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/FileURLConnection.java 2010-02-12 21:44:13 UTC (rev 129)
+++ trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/FileURLConnection.java 2010-02-12 21:44:34 UTC (rev 130)
@@ -56,6 +56,7 @@
* @author Stéphane GALLAND <galland@xxxxxxxxxxx>
* @version $Name$ $Revision$ $Date$
* @see URLConnection
+ * @since 4.2
*/
class FileURLConnection extends URLConnection {
Modified: trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/FileURLStreamHandler.java
===================================================================
--- trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/FileURLStreamHandler.java 2010-02-12 21:44:13 UTC (rev 129)
+++ trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/FileURLStreamHandler.java 2010-02-12 21:44:34 UTC (rev 130)
@@ -44,6 +44,7 @@
* @version $Name$ $Revision$ $Date$
* @see URLStreamHandler
* @see FileURLStreamHandlerFactory
+ * @since 4.2
*/
class FileURLStreamHandler extends URLStreamHandler {
Modified: trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/FileURLStreamHandlerFactory.java
===================================================================
--- trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/FileURLStreamHandlerFactory.java 2010-02-12 21:44:13 UTC (rev 129)
+++ trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/FileURLStreamHandlerFactory.java 2010-02-12 21:44:34 UTC (rev 130)
@@ -39,6 +39,7 @@
* @version $Name$ $Revision$ $Date$
* @see URLStreamHandlerFactory
* @see URL#setURLStreamHandlerFactory(URLStreamHandlerFactory)
+ * @since 4.2
*/
public class FileURLStreamHandlerFactory
implements URLStreamHandlerFactory {
Modified: trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/MACNumber.java
===================================================================
--- trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/MACNumber.java 2010-02-12 21:44:13 UTC (rev 129)
+++ trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/MACNumber.java 2010-02-12 21:44:34 UTC (rev 130)
@@ -35,6 +35,7 @@
* @author Stéphane GALLAND <galland@xxxxxxxxxxx>
* @version $Name$ $Revision$ $Date$
* @see NetworkInterface
+ * @since 4.2
*/
public final class MACNumber {
Modified: trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ReflectionUtil.java
===================================================================
--- trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ReflectionUtil.java 2010-02-12 21:44:13 UTC (rev 129)
+++ trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ReflectionUtil.java 2010-02-12 21:44:34 UTC (rev 130)
@@ -497,6 +497,7 @@
* @param highestType is the highest type to explore in type hierarchy.
* @param interfaceType indicates the type of the replied interfaces.
* @return the implemented interfaces.
+ * @since 5.0
*/
public static <T> Set<Class<?>> getAllDirectInterfaces(Class<? extends T> lowestType, Class<T> highestType, Class<?> interfaceType) {
assert(lowestType!=null);
@@ -523,6 +524,7 @@
* @param <T> is the type of the lowest class.
* @param className is the type of the lowest class.
* @return the list of superclasses.
+ * @since 5.0
*/
public static <T> Collection<Class<? super T>> getSuperClasses(Class<T> className) {
assert(className!=null);
Modified: trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ResourceNotFoundException.java
===================================================================
--- trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ResourceNotFoundException.java 2010-02-12 21:44:13 UTC (rev 129)
+++ trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ResourceNotFoundException.java 2010-02-12 21:44:34 UTC (rev 130)
@@ -28,6 +28,7 @@
*
* @author Stéphane GALLAND <galland@xxxxxxxxxxx>
* @version $Name$ $Revision$ $Date$
+ * @since 4.2
*/
public class ResourceNotFoundException extends IOException {
Modified: trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ResourceURLConnection.java
===================================================================
--- trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ResourceURLConnection.java 2010-02-12 21:44:13 UTC (rev 129)
+++ trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ResourceURLConnection.java 2010-02-12 21:44:34 UTC (rev 130)
@@ -41,6 +41,7 @@
* @author Stéphane GALLAND <galland@xxxxxxxxxxx>
* @version $Name$ $Revision$ $Date$
* @see URLConnection
+ * @since 4.2
*/
class ResourceURLConnection extends URLConnection {
Modified: trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ResourceURLStreamHandler.java
===================================================================
--- trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ResourceURLStreamHandler.java 2010-02-12 21:44:13 UTC (rev 129)
+++ trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ResourceURLStreamHandler.java 2010-02-12 21:44:34 UTC (rev 130)
@@ -43,6 +43,7 @@
* @version $Name$ $Revision$ $Date$
* @see URLStreamHandler
* @see ResourceURLStreamHandlerFactory
+ * @since 4.2
*/
class ResourceURLStreamHandler extends URLStreamHandler {
Modified: trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ResourceURLStreamHandlerFactory.java
===================================================================
--- trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ResourceURLStreamHandlerFactory.java 2010-02-12 21:44:13 UTC (rev 129)
+++ trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/ResourceURLStreamHandlerFactory.java 2010-02-12 21:44:34 UTC (rev 130)
@@ -38,6 +38,7 @@
* @version $Name$ $Revision$ $Date$
* @see URLStreamHandlerFactory
* @see URL#setURLStreamHandlerFactory(URLStreamHandlerFactory)
+ * @since 4.2
*/
public class ResourceURLStreamHandlerFactory
implements URLStreamHandlerFactory {
Modified: trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/Resources.java
===================================================================
--- trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/Resources.java 2010-02-12 21:44:13 UTC (rev 129)
+++ trunk/arakhneVmutils/java/src/main/java/org/arakhne/vmutil/Resources.java 2010-02-12 21:44:34 UTC (rev 130)
@@ -33,7 +33,7 @@
*
* @author Stéphane GALLAND <galland@xxxxxxxxxxx>
* @version $Name$ $Revision$ $Date$
- * @since since JDK 1.5
+ * @since 4.2
*/
public class Resources {