001: /*
002: * Globus Toolkit Public License (GTPL)
003: *
004: * Copyright (c) 1999 University of Chicago and The University of
005: * Southern California. All Rights Reserved.
006: *
007: * 1) The "Software", below, refers to the Globus Toolkit (in either
008: * source-code, or binary form and accompanying documentation) and a
009: * "work based on the Software" means a work based on either the
010: * Software, on part of the Software, or on any derivative work of
011: * the Software under copyright law: that is, a work containing all
012: * or a portion of the Software either verbatim or with
013: * modifications. Each licensee is addressed as "you" or "Licensee."
014: *
015: * 2) The University of Southern California and the University of
016: * Chicago as Operator of Argonne National Laboratory are copyright
017: * holders in the Software. The copyright holders and their third
018: * party licensors hereby grant Licensee a royalty-free nonexclusive
019: * license, subject to the limitations stated herein and
020: * U.S. Government license rights.
021: *
022: * 3) A copy or copies of the Software may be given to others, if you
023: * meet the following conditions:
024: *
025: * a) Copies in source code must include the copyright notice and
026: * this license.
027: *
028: * b) Copies in binary form must include the copyright notice and
029: * this license in the documentation and/or other materials
030: * provided with the copy.
031: *
032: * 4) All advertising materials, journal articles and documentation
033: * mentioning features derived from or use of the Software must
034: * display the following acknowledgement:
035: *
036: * "This product includes software developed by and/or derived from
037: * the Globus project (http://www.globus.org/)."
038: *
039: * In the event that the product being advertised includes an intact
040: * Globus distribution (with copyright and license included) then
041: * this clause is waived.
042: *
043: * 5) You are encouraged to package modifications to the Software
044: * separately, as patches to the Software.
045: *
046: * 6) You may make modifications to the Software, however, if you
047: * modify a copy or copies of the Software or any portion of it,
048: * thus forming a work based on the Software, and give a copy or
049: * copies of such work to others, either in source code or binary
050: * form, you must meet the following conditions:
051: *
052: * a) The Software must carry prominent notices stating that you
053: * changed specified portions of the Software.
054: *
055: * b) The Software must display the following acknowledgement:
056: *
057: * "This product includes software developed by and/or derived
058: * from the Globus Project (http://www.globus.org/) to which the
059: * U.S. Government retains certain rights."
060: *
061: * 7) You may incorporate the Software or a modified version of the
062: * Software into a commercial product, if you meet the following
063: * conditions:
064: *
065: * a) The commercial product or accompanying documentation must
066: * display the following acknowledgment:
067: *
068: * "This product includes software developed by and/or derived
069: * from the Globus Project (http://www.globus.org/) to which the
070: * U.S. Government retains a paid-up, nonexclusive, irrevocable
071: * worldwide license to reproduce, prepare derivative works, and
072: * perform publicly and display publicly."
073: *
074: * b) The user of the commercial product must be given the following
075: * notice:
076: *
077: * "[Commercial product] was prepared, in part, as an account of
078: * work sponsored by an agency of the United States Government.
079: * Neither the United States, nor the University of Chicago, nor
080: * University of Southern California, nor any contributors to
081: * the Globus Project or Globus Toolkit nor any of their employees,
082: * makes any warranty express or implied, or assumes any legal
083: * liability or responsibility for the accuracy, completeness, or
084: * usefulness of any information, apparatus, product, or process
085: * disclosed, or represents that its use would not infringe
086: * privately owned rights.
087: *
088: * IN NO EVENT WILL THE UNITED STATES, THE UNIVERSITY OF CHICAGO
089: * OR THE UNIVERSITY OF SOUTHERN CALIFORNIA OR ANY CONTRIBUTORS
090: * TO THE GLOBUS PROJECT OR GLOBUS TOOLKIT BE LIABLE FOR ANY
091: * DAMAGES, INCLUDING DIRECT, INCIDENTAL, SPECIAL, OR CONSEQUENTIAL
092: * DAMAGES RESULTING FROM EXERCISE OF THIS LICENSE AGREEMENT OR
093: * THE USE OF THE [COMMERCIAL PRODUCT]."
094: *
095: * 8) LICENSEE AGREES THAT THE EXPORT OF GOODS AND/OR TECHNICAL DATA
096: * FROM THE UNITED STATES MAY REQUIRE SOME FORM OF EXPORT CONTROL
097: * LICENSE FROM THE U.S. GOVERNMENT AND THAT FAILURE TO OBTAIN SUCH
098: * EXPORT CONTROL LICENSE MAY RESULT IN CRIMINAL LIABILITY UNDER U.S.
099: * LAWS.
100: *
101: * 9) Portions of the Software resulted from work developed under a
102: * U.S. Government contract and are subject to the following license:
103: * the Government is granted for itself and others acting on its
104: * behalf a paid-up, nonexclusive, irrevocable worldwide license in
105: * this computer software to reproduce, prepare derivative works, and
106: * perform publicly and display publicly.
107: *
108: * 10) The Software was prepared, in part, as an account of work
109: * sponsored by an agency of the United States Government. Neither
110: * the United States, nor the University of Chicago, nor The
111: * University of Southern California, nor any contributors to the
112: * Globus Project or Globus Toolkit, nor any of their employees,
113: * makes any warranty express or implied, or assumes any legal
114: * liability or responsibility for the accuracy, completeness, or
115: * usefulness of any information, apparatus, product, or process
116: * disclosed, or represents that its use would not infringe privately
117: * owned rights.
118: *
119: * 11) IN NO EVENT WILL THE UNITED STATES, THE UNIVERSITY OF CHICAGO OR
120: * THE UNIVERSITY OF SOUTHERN CALIFORNIA OR ANY CONTRIBUTORS TO THE
121: * GLOBUS PROJECT OR GLOBUS TOOLKIT BE LIABLE FOR ANY DAMAGES,
122: * INCLUDING DIRECT, INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES
123: * RESULTING FROM EXERCISE OF THIS LICENSE AGREEMENT OR THE USE OF
124: * THE SOFTWARE.
125: *
126: * END OF LICENSE
127: */
128:
129: package org.griphyn.cPlanner.classes;
130:
131: import org.griphyn.cPlanner.common.LogManager;
132:
133: import org.globus.replica.rls.RLSClient;
134: import org.globus.replica.rls.RLSString2Bulk;
135:
136: /**
137: * A class that stores the results
138: * of querying an LRC. It includes
139: * whether the operation was a success
140: * or not and in addition the value
141: * of the pool attribute.
142: *
143: * @author Gaurang Mehta
144: * @author Karan Vahi
145: * @version $Revision: 50 $
146: *
147: * @see org.globus.replica.rls.RLSString2Bulk
148: */
149:
150: public class LRCResult extends Data {
151:
152: /**
153: * The lfn for which the LRC
154: * was queried.
155: */
156: public String lfn;
157:
158: /**
159: * The pfn associated
160: * with the lfn, if an
161: * entry found in the LRC.
162: * Else it can be null.
163: */
164: public String pfn;
165:
166: /**
167: * The pool attribute associated
168: * with the pfn returned.
169: * This should be set to null
170: * if pfn is not found.
171: */
172: public String pool;
173:
174: /**
175: * The status of the operation.
176: * Whether it was a sucess or not.
177: * The status are defined in
178: * RLSClient.java
179: *
180: * @see org.globus.replica.rls.RLSClient
181: */
182: public int LRCExitStatus;
183:
184: /**
185: * The default constructor
186: */
187: public LRCResult() {
188: lfn = new String();
189: pfn = new String();
190: pool = new String();
191: LRCExitStatus = 0;
192: }
193:
194: /**
195: * The overloaded constructor.
196: * Takes in RLSString2Bulk
197: * object.
198: */
199: public LRCResult(RLSString2Bulk s2, String poolAtt) {
200: lfn = s2.s1;
201: pfn = s2.s2;
202: LRCExitStatus = s2.rc;
203: pool = poolAtt;
204: }
205:
206: /**
207: * Returns a clone of the
208: * existing object.
209: */
210: public Object clone() {
211: LRCResult res = new LRCResult();
212:
213: res.lfn = this .lfn;
214: res.pfn = this .pfn;
215: res.pool = this .pool;
216: res.LRCExitStatus = this .LRCExitStatus;
217:
218: return res;
219: }
220:
221: /**
222: * Returns a textual description
223: * of the object.
224: */
225: public String toString() {
226: String str = "\n lfn: " + lfn + " exit status: "
227: + getErrorMessage() + " pfn: " + pfn + " pool: " + pool;
228: return str;
229:
230: }
231:
232: /**
233: * Returns the error/status
234: * message according to
235: * the LRCExitStatus.
236: */
237: public String getErrorMessage() {
238: RLSClient rls = null;
239:
240: try {
241: rls = new RLSClient();
242: } catch (Exception e) {
243: mLogger.log("Exception while initialising to RLS"
244: + e.getMessage(), LogManager.ERROR_MESSAGE_LEVEL);
245: }
246: String err = rls.getErrorMessage(this.LRCExitStatus);
247:
248: return err;
249: }
250:
251: }
|