parallel/client/DataServer.java

package appl.parallel.client;

import java.awt.Rectangle;
import java.rmi.Remote;
import java.rmi.RemoteException;

import appl.parallel.spmd.split.DataPartition;
import appl.parallel.spmd.split.SplittableResource;

/**
 * A {@link DataServer} shares resources over a network. For
 * {@link SplittableResource}s it allows also the retrieval of
 * {@link DataPartition}s. The data is retrieved using a unique id identifying
 * the resource.
 *
 * @author Dominik Appl
 */
public interface DataServer extends Remote {

        /**
         * 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 location 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;

        /**
         * Returns the whole Partition with the given ID
         *
         * @param id
         *            the id of the partition
         * @return the partition
         * @throws RemoteException
         *             if the connection to the server fails
         */
        public DataPartition getData(int id) throws RemoteException;

        /**
         * Adds a Partition to the server
         *
         * @param partition
         *            the partition to add
         * @throws RemoteException
         */
        public void addData(DataPartition partition) throws RemoteException;

        /**
         * Removes the partition with the specified id.
         *
         * @param id
         *            id of the partition to remove
         * @throws RemoteException
         */
        public void removeData(int id) throws RemoteException;

}
1	package appl.parallel.client;
2
3	import java.awt.Rectangle;
4	import java.rmi.Remote;
5	import java.rmi.RemoteException;
6
7	import appl.parallel.spmd.split.DataPartition;
8	import appl.parallel.spmd.split.SplittableResource;
9
10	/**
11	* A {@link DataServer} shares resources over a network. For
12	* {@link SplittableResource}s it allows also the retrieval of
13	* {@link DataPartition}s. The data is retrieved using a unique id identifying
14	* the resource.
15	*
16	* @author Dominik Appl
17	*/
18	public interface DataServer extends Remote {
19
20	/**
21	* gets the data with the id of a SplittableRessource
22	*
23	* @param id
24	* the {@link SplittableResource#getRootID() ID} of a the base
25	* data
26	* @param bounds
27	* the bounds of the partition to retrieve (using global
28	* coordinates)
29	* @return the partition
30	* @throws RemoteException
31	*/
32	public DataPartition getPartition(int id, Rectangle bounds)
33	throws RemoteException;
34
35	/**
36	* sets the data with the id of a SplittableRessource
37	*
38	* @param id
39	* the {@link SplittableResource#getRootID() ID} of a the base
40	* data
41	* @param bounds
42	* the location where the partition is to be updated (using
43	* global coordinates)
44	* @param updateData
45	* the updateData (which may only a partitial update, depending
46	* on the bounds set with the last parameter)
47	* @throws RemoteException
48	*/
49	public void updatePartition(int id, DataPartition updateData,
50	Rectangle bounds) throws RemoteException;
51
52	/**
53	* Returns the whole Partition with the given ID
54	*
55	* @param id
56	* the id of the partition
57	* @return the partition
58	* @throws RemoteException
59	* if the connection to the server fails
60	*/
61	public DataPartition getData(int id) throws RemoteException;
62
63	/**
64	* Adds a Partition to the server
65	*
66	* @param partition
67	* the partition to add
68	* @throws RemoteException
69	*/
70	public void addData(DataPartition partition) throws RemoteException;
71
72	/**
73	* Removes the partition with the specified id.
74	*
75	* @param id
76	* id of the partition to remove
77	* @throws RemoteException
78	*/
79	public void removeData(int id) throws RemoteException;
80
81	}