parallel/server/PartitionDataServer.java

package appl.parallel.server;

import java.awt.Rectangle;
import java.rmi.Remote;
import java.rmi.RemoteException;
import java.util.HashMap;
import java.util.Vector;

import appl.parallel.client.DataServer;
import appl.parallel.spmd.MultiDataInfo;
import appl.parallel.spmd.MultiDataObject;
import appl.parallel.spmd.split.DataPartition;
import appl.parallel.spmd.split.PartitionInfo;
import appl.parallel.spmd.split.SinglePartitionInfo;
import appl.parallel.spmd.split.SplittableResource;

/**
 * Manages data and partitions on servers. The method descriptions for details.
 * 
 * @see PartitionDataManager
 *
 * @author Dominik Appl
 */
public interface PartitionDataServer extends Remote, DataServer {

        /**
         * gets the data with the id of a SplittableRessource
         *
         * @param id
         *            the {@link SplittableResource#getRootID() ID} of a the base data
         * @param bounds
         *            the bounds of the partition to retrieve (using global
         *            coordinates)
         * @return the partition
         * @throws RemoteException
         */
        public DataPartition getPartition(int id, Rectangle bounds)
                        throws RemoteException;

        /**
         * sets the data with the id of a SplittableRessource
         *
         * @param id
         *            the {@link SplittableResource#getRootID() ID} of a the base data
         * @param bounds
         *            the locatition where the partition is to be updated (using
         *            global coordinates)
         * @param updateData
         *            the updateData (which may only a partitial update, depending
         *            on the bounds set with the last parameter)
         * @throws RemoteException
         */
        public void updatePartition(int id, DataPartition updateData,
                        Rectangle bounds) throws RemoteException;

        /**
         * Unloads the specified resource to the source it was loaded from
         *
         * @param rootID
         *            the id of the resource
         */
        public void unloadToSource(int rootID) throws RemoteException;

        /**
         * requests an update for the neighborhood region for the given resource
         *
         * @param rootID
         */
        public void updateFromNeighbors(int rootID) throws RemoteException;

        /**
         * Adds or updates BaseParameters
         */
        public void updateBaseParameter(HashMap<String, Object> newParameters)
                        throws RemoteException;

        /**
         * Adds {@link PartitionInfo}s to the server. They are submitted in a
         * vector to avoid multiple remote calls.
         *
         * @param singlePartitionInfos
         * @throws RemoteException
         */
        public void addPartitionInfos(
                        Vector<SinglePartitionInfo> singlePartitionInfos)
                        throws RemoteException;

        /**
         * Adds {@link MultiDataInfo}s to the server.
         *
         * @param toTransferMultiDataObjects
         */
        public void addMultiDataInfos(
                        HashMap<String, MultiDataInfo> toTransferMultiDataObjects)
                        throws RemoteException;

        /**
         * @param name
         *            the name of the associated multi data
         * @return the {@link MultiDataInfo} info
         * @throws RemoteException
         */
        public MultiDataInfo getMultiDataInfo(String name) throws RemoteException;

        /**
         * @param name
         *            the name of the multiDataObject
         * @return the MultiDataObject associated with that name
         * @throws RemoteException
         */
        public MultiDataObject getMultiDataObject(String name)
                        throws RemoteException;

        /**
         * @param rootID
         *            the id of the according partition
         * @return the the {@link PartitionInfo}
         * @throws RemoteException
         */
        public SinglePartitionInfo getPartitionInfo(int rootID)
                        throws RemoteException;

}
1	mojays	2	package appl.parallel.server;
2
3			import java.awt.Rectangle;
4			import java.rmi.Remote;
5			import java.rmi.RemoteException;
6			import java.util.HashMap;
7			import java.util.Vector;
8
9			import appl.parallel.client.DataServer;
10			import appl.parallel.spmd.MultiDataInfo;
11			import appl.parallel.spmd.MultiDataObject;
12			import appl.parallel.spmd.split.DataPartition;
13			import appl.parallel.spmd.split.PartitionInfo;
14			import appl.parallel.spmd.split.SinglePartitionInfo;
15			import appl.parallel.spmd.split.SplittableResource;
16
17			/**
18			* Manages data and partitions on servers. The method descriptions for details.
19			*
20			* @see PartitionDataManager
21			*
22			* @author Dominik Appl
23			*/
24			public interface PartitionDataServer extends Remote, DataServer {
25
26			/**
27			* gets the data with the id of a SplittableRessource
28			*
29			* @param id
30			* the {@link SplittableResource#getRootID() ID} of a the base data
31			* @param bounds
32			* the bounds of the partition to retrieve (using global
33			* coordinates)
34			* @return the partition
35			* @throws RemoteException
36			*/
37			public DataPartition getPartition(int id, Rectangle bounds)
38			throws RemoteException;
39
40			/**
41			* sets the data with the id of a SplittableRessource
42			*
43			* @param id
44			* the {@link SplittableResource#getRootID() ID} of a the base data
45			* @param bounds
46			* the locatition where the partition is to be updated (using
47			* global coordinates)
48			* @param updateData
49			* the updateData (which may only a partitial update, depending
50			* on the bounds set with the last parameter)
51			* @throws RemoteException
52			*/
53			public void updatePartition(int id, DataPartition updateData,
54			Rectangle bounds) throws RemoteException;
55
56			/**
57			* Unloads the specified resource to the source it was loaded from
58			*
59			* @param rootID
60			* the id of the resource
61			*/
62			public void unloadToSource(int rootID) throws RemoteException;
63
64			/**
65			* requests an update for the neighborhood region for the given resource
66			*
67			* @param rootID
68			*/
69			public void updateFromNeighbors(int rootID) throws RemoteException;
70
71			/**
72			* Adds or updates BaseParameters
73			*/
74			public void updateBaseParameter(HashMap<String, Object> newParameters)
75			throws RemoteException;
76
77			/**
78			* Adds {@link PartitionInfo}s to the server. They are submitted in a
79			* vector to avoid multiple remote calls.
80			*
81			* @param singlePartitionInfos
82			* @throws RemoteException
83			*/
84			public void addPartitionInfos(
85			Vector<SinglePartitionInfo> singlePartitionInfos)
86			throws RemoteException;
87
88			/**
89			* Adds {@link MultiDataInfo}s to the server.
90			*
91			* @param toTransferMultiDataObjects
92			*/
93			public void addMultiDataInfos(
94			HashMap<String, MultiDataInfo> toTransferMultiDataObjects)
95			throws RemoteException;
96
97			/**
98			* @param name
99			* the name of the associated multi data
100			* @return the {@link MultiDataInfo} info
101			* @throws RemoteException
102			*/
103			public MultiDataInfo getMultiDataInfo(String name) throws RemoteException;
104
105			/**
106			* @param name
107			* the name of the multiDataObject
108			* @return the MultiDataObject associated with that name
109			* @throws RemoteException
110			*/
111			public MultiDataObject getMultiDataObject(String name)
112			throws RemoteException;
113
114			/**
115			* @param rootID
116			* the id of the according partition
117			* @return the the {@link PartitionInfo}
118			* @throws RemoteException
119			*/
120			public SinglePartitionInfo getPartitionInfo(int rootID)
121			throws RemoteException;
122
123			}