parallel/data/PartitionDataHandler.java

package appl.parallel.data;

import java.awt.Rectangle;

import appl.data.LoadingException;
import appl.parallel.client.ClientDataServer;
import appl.parallel.spmd.split.DataPartition;

/**
 * Responsible for loading and unloading data partitions
 * 
 * @author Dominik Appl
 */
public interface PartitionDataHandler extends DataLoadHandler, Cloneable {

        /**
         * sets the bounds of the data to be unloaded so that not all data is
         * unloaded to the destination. This is for example useful if there is a
         * neighborhood region which should not be uploaded to the destination.
         * 
         * @param bounds
         */
        public void setUnloadBounds(Rectangle bounds);

        public void setBasePartition(DataPartition data);

        public void setRootID(int rootID);

        /**
         * @param rootID
         *            the id of the data
         * @param partitionBounds
         *            the bounds of the partition to be retrieved on server side
         * @param unloadBounds
         *            the bounds of the partition which is to be uploaded to the
         *            client after calculation
         * @return the new instance
         */
        public PartitionDataHandler newInstance(int rootID,
                        ClientDataServer spmdClient, Rectangle partitionBounds,
                        Rectangle unloadBounds);

        public DataPartition load() throws LoadingException;

        public PartitionDataHandler clone();

        /**
         * sets a local spmd client which MAY be used by the handler for local
         * access
         * 
         * @param localSPMDClient
         */
        public void setSPMDClient(ClientDataServer localSPMDClient);

}
1	mojays	2	package appl.parallel.data;
2
3			import java.awt.Rectangle;
4
5			import appl.data.LoadingException;
6			import appl.parallel.client.ClientDataServer;
7			import appl.parallel.spmd.split.DataPartition;
8
9			/**
10			* Responsible for loading and unloading data partitions
11			*
12			* @author Dominik Appl
13			*/
14			public interface PartitionDataHandler extends DataLoadHandler, Cloneable {
15
16			/**
17			* sets the bounds of the data to be unloaded so that not all data is
18			* unloaded to the destination. This is for example useful if there is a
19			* neighborhood region which should not be uploaded to the destination.
20			*
21			* @param bounds
22			*/
23			public void setUnloadBounds(Rectangle bounds);
24
25			public void setBasePartition(DataPartition data);
26
27			public void setRootID(int rootID);
28
29			/**
30			* @param rootID
31			* the id of the data
32			* @param partitionBounds
33			* the bounds of the partition to be retrieved on server side
34			* @param unloadBounds
35			* the bounds of the partition which is to be uploaded to the
36			* client after calculation
37			* @return the new instance
38			*/
39			public PartitionDataHandler newInstance(int rootID,
40			ClientDataServer spmdClient, Rectangle partitionBounds,
41			Rectangle unloadBounds);
42
43			public DataPartition load() throws LoadingException;
44
45			public PartitionDataHandler clone();
46
47			/**
48			* sets a local spmd client which MAY be used by the handler for local
49			* access
50			*
51			* @param localSPMDClient
52			*/
53			public void setSPMDClient(ClientDataServer localSPMDClient);
54
55			}