parallel/spmd/MultiDataInfo.java

package appl.parallel.spmd;

import java.io.Serializable;
import java.util.Vector;

/**
 * Instances of this class encapsulate information about multiple objects
 * of the same type, e.g. lists of grids. In contrast to the MultiDataObject there
 * are no objects stored, but only the IDs of the objects. That simplifies the
 * the synchronization of multidata information over a network.
 *

 *
 * @author Dominik Appl
 */
public class MultiDataInfo implements Serializable {
        Vector<Integer> ids = new Vector<Integer>();

        String name;

        /**
         * This constant is used as a divider for adding multiple data associated with the same
         * name.
         * The dividing should be as follows: name + MULTISPLITCONSTANT + index
         */
        public static final String MULTISPLITCONSTANT = ";)|(;";

        public MultiDataInfo(int[] ids,  String name){
                this.name = name;
                for (int i : ids) {
                        this.ids.add(i);
                }
        }

        /**
         * Adds a new Element with the specified id.
         * @param id The ID of the new element.
         * @return the name of the new Element
         *
         */
        public String addElement(int id){
                ids.add(id);
                return getNameWithIdx(getCount()-1, name);
        }


        public int getMultiID(int idx){
                return ids.get(idx);
        }

        /**
         * Generates a identification String based only on the given name and the given idx.
         * It can be used for identification of the same data over multiple resources
         *
         * @param idx the index of the element in the multidata
         * @param name the name of the element
         * @return the identification string
         *
         * @see #getIndexFromNameWithIdx(String)
         *
         */
        public static String getNameWithIdx(int idx, String name){
                return  name + MULTISPLITCONSTANT + idx;
        }


        /**
         * Extracts the the the index out of a identification
         * @param identificationName the identification
         * @return the index
         *
         * @see #getNameWithIdx(int, String)
         */
        public static int getIndexFromNameWithIdx(String identificationName){
                String index = identificationName.split(MULTISPLITCONSTANT)[1];
                int i = Integer.valueOf(index);
                System.out.println("MulitDataInfo: Returning " + i);
                return i;
        }

        /**
         * Generates a new id for a given index, based on the id of the first element
         * in the multidata.
         * @param idx the index for which a new id should be generated
         * @return the new id
         */
        public int getNewIDForIndex(int idx){
                return getMultiID(0) * (-1) - idx;
        }

        /**
         * @return the number of elements currently in the multi-info
         */
        public int getCount(){
                return ids.size();
        }

        /**
         * @return the name associated with this multi-id
         */
        public String getName(){
                return name;
        }
}
1	mojays	2	package appl.parallel.spmd;
2
3			import java.io.Serializable;
4			import java.util.Vector;
5
6			/**
7			* Instances of this class encapsulate information about multiple objects
8			* of the same type, e.g. lists of grids. In contrast to the MultiDataObject there
9			* are no objects stored, but only the IDs of the objects. That simplifies the
10			* the synchronization of multidata information over a network.
11			*
12
13			*
14			* @author Dominik Appl
15			*/
16			public class MultiDataInfo implements Serializable {
17			Vector<Integer> ids = new Vector<Integer>();
18
19			String name;
20
21			/**
22			* This constant is used as a divider for adding multiple data associated with the same
23			* name.
24			* The dividing should be as follows: name + MULTISPLITCONSTANT + index
25			*/
26			public static final String MULTISPLITCONSTANT = ";)\|(;";
27
28			public MultiDataInfo(int[] ids, String name){
29			this.name = name;
30			for (int i : ids) {
31			this.ids.add(i);
32			}
33			}
34
35			/**
36			* Adds a new Element with the specified id.
37			* @param id The ID of the new element.
38			* @return the name of the new Element
39			*
40			*/
41			public String addElement(int id){
42			ids.add(id);
43			return getNameWithIdx(getCount()-1, name);
44			}
45
46
47			public int getMultiID(int idx){
48			return ids.get(idx);
49			}
50
51			/**
52			* Generates a identification String based only on the given name and the given idx.
53			* It can be used for identification of the same data over multiple resources
54			*
55			* @param idx the index of the element in the multidata
56			* @param name the name of the element
57			* @return the identification string
58			*
59			* @see #getIndexFromNameWithIdx(String)
60			*
61			*/
62			public static String getNameWithIdx(int idx, String name){
63			return name + MULTISPLITCONSTANT + idx;
64			}
65
66
67			/**
68			* Extracts the the the index out of a identification
69			* @param identificationName the identification
70			* @return the index
71			*
72			* @see #getNameWithIdx(int, String)
73			*/
74			public static int getIndexFromNameWithIdx(String identificationName){
75			String index = identificationName.split(MULTISPLITCONSTANT)[1];
76			int i = Integer.valueOf(index);
77			System.out.println("MulitDataInfo: Returning " + i);
78			return i;
79			}
80
81			/**
82			* Generates a new id for a given index, based on the id of the first element
83			* in the multidata.
84			* @param idx the index for which a new id should be generated
85			* @return the new id
86			*/
87			public int getNewIDForIndex(int idx){
88			return getMultiID(0) * (-1) - idx;
89			}
90
91			/**
92			* @return the number of elements currently in the multi-info
93			*/
94			public int getCount(){
95			return ids.size();
96			}
97
98			/**
99			* @return the name associated with this multi-id
100			*/
101			public String getName(){
102			return name;
103			}
104			}