init

src/org/cloudbus/cloudsim/Storage.java

@@ -0,0 +1,197 @@
+/*
+ * Title:        CloudSim Toolkit
+ * Description:  CloudSim (Cloud Simulation) Toolkit for Modeling and Simulation of Clouds
+ * Licence:      GPL - http://www.gnu.org/copyleft/gpl.html
+ *
+ * Copyright (c) 2009-2012, The University of Melbourne, Australia
+ */
+
+package org.cloudbus.cloudsim;
+
+import java.util.List;
+
+/**
+ * An interface which defines the desired functionality of a storage system in a Data Cloud. The
+ * classes that implement this interface should simulate the characteristics of different storage
+ * systems by setting the capacity of the storage and the maximum transfer rate. The transfer rate
+ * defines the time required to execute some common operations on the storage, e.g. storing a file,
+ * getting a file and deleting a file.
+ * 
+ * @author Uros Cibej
+ * @author Anthony Sulistio
+ * @since CloudSim Toolkit 1.0
+ */
+public interface Storage {
+
+	/**
+	 * Gets the name of the storage.
+	 * 
+	 * @return the name of this storage
+	 */
+	String getName();
+
+	/**
+	 * Gets the total capacity of the storage in MByte.
+	 * 
+	 * @return the capacity of the storage in MB
+	 */
+	double getCapacity();
+
+	/**
+	 * Gets the current size of the storage in MByte.
+	 * 
+	 * @return the current size of the storage in MB
+	 */
+	double getCurrentSize();
+
+	/**
+	 * Gets the maximum transfer rate of the storage in MByte/sec.
+	 * 
+	 * @return the maximum transfer rate in MB/sec
+	 */
+	double getMaxTransferRate();
+
+	/**
+	 * Gets the available space on this storage in MByte.
+	 * 
+	 * @return the available space in MB
+	 */
+	double getAvailableSpace();
+
+	/**
+	 * Sets the maximum transfer rate of this storage system in MByte/sec.
+	 * 
+	 * @param rate the maximum transfer rate in MB/sec
+	 * @return <tt>true</tt> if the setting succeeded, <tt>false</tt> otherwise
+	 */
+	boolean setMaxTransferRate(int rate);
+
+	/**
+	 * Checks if the storage is full or not.
+	 * 
+	 * @return <tt>true</tt> if the storage is full, <tt>false</tt> otherwise
+	 */
+	boolean isFull();
+
+	/**
+	 * Gets the number of files stored on this storage.
+	 * 
+	 * @return the number of stored files
+	 */
+	int getNumStoredFile();
+
+	/**
+	 * Makes a reservation of the space on the storage to store a file.
+	 * 
+	 * @param fileSize the size to be reserved in MB
+	 * @return <tt>true</tt> if reservation succeeded, <tt>false</tt> otherwise
+	 */
+	boolean reserveSpace(int fileSize);
+
+	/**
+	 * Adds a file for which the space has already been reserved. The time taken (in seconds) for
+	 * adding the specified file can also be found using
+	 * {@link gridsim.datagrid.File#getTransactionTime()}.
+	 * 
+	 * @param file the file to be added
+	 * @return the time (in seconds) required to add the file
+	 */
+	double addReservedFile(File file);
+
+	/**
+	 * Checks whether there is enough space on the storage for a certain file.
+	 * 
+	 * @param fileSize a FileAttribute object to compare to
+	 * @return <tt>true</tt> if enough space available, <tt>false</tt> otherwise
+	 */
+	boolean hasPotentialAvailableSpace(int fileSize);
+
+	/**
+	 * Gets the file with the specified name. The time taken (in seconds) for getting the specified
+	 * file can also be found using {@link gridsim.datagrid.File#getTransactionTime()}.
+	 * 
+	 * @param fileName the name of the needed file
+	 * @return the file with the specified filename
+	 */
+	File getFile(String fileName);
+
+	/**
+	 * Gets the list of file names located on this storage.
+	 * 
+	 * @return a List of file names
+	 */
+	List<String> getFileNameList();
+
+	/**
+	 * Adds a file to the storage. The time taken (in seconds) for adding the specified file can
+	 * also be found using {@link gridsim.datagrid.File#getTransactionTime()}.
+	 * 
+	 * @param file the file to be added
+	 * @return the time taken (in seconds) for adding the specified file
+	 */
+	double addFile(File file);
+
+	/**
+	 * Adds a set of files to the storage. The time taken (in seconds) for adding each file can also
+	 * be found using {@link gridsim.datagrid.File#getTransactionTime()}.
+	 * 
+	 * @param list the files to be added
+	 * @return the time taken (in seconds) for adding the specified files
+	 */
+	double addFile(List<File> list);
+
+	/**
+	 * Removes a file from the storage. The time taken (in seconds) for deleting the specified file
+	 * can be found using {@link gridsim.datagrid.File#getTransactionTime()}.
+	 * 
+	 * @param fileName the name of the file to be removed
+	 * @return the deleted file.
+	 */
+	File deleteFile(String fileName);
+
+	/**
+	 * Removes a file from the storage. The time taken (in seconds) for deleting the specified file
+	 * can also be found using {@link gridsim.datagrid.File#getTransactionTime()}.
+	 * 
+	 * @param fileName the name of the file to be removed
+	 * @param file the file which is removed from the storage is returned through this parameter
+	 * @return the time taken (in seconds) for deleting the specified file
+	 */
+	double deleteFile(String fileName, File file);
+
+	/**
+	 * Removes a file from the storage. The time taken (in seconds) for deleting the specified file
+	 * can also be found using {@link gridsim.datagrid.File#getTransactionTime()}.
+	 * 
+	 * @param file the file which is removed from the storage is returned through this parameter
+	 * @return the time taken (in seconds) for deleting the specified file
+	 */
+	double deleteFile(File file);
+
+	/**
+	 * Checks whether a file is stored in the storage or not.
+	 * 
+	 * @param fileName the name of the file we are looking for
+	 * @return <tt>true</tt> if the file is in the storage, <tt>false</tt> otherwise
+	 */
+	boolean contains(String fileName);
+
+	/**
+	 * Checks whether a file is stored in the storage or not.
+	 * 
+	 * @param file the file we are looking for
+	 * @return <tt>true</tt> if the file is in the storage, <tt>false</tt> otherwise
+	 */
+	boolean contains(File file);
+
+	/**
+	 * Renames a file on the storage. The time taken (in seconds) for renaming the specified file
+	 * can also be found using {@link gridsim.datagrid.File#getTransactionTime()}.
+	 * 
+	 * @param file the file we would like to rename
+	 * @param newName the new name of the file
+	 * @return <tt>true</tt> if the renaming succeeded, <tt>false</tt> otherwise
+	 */
+	boolean renameFile(File file, String newName);
+
+}