View Javadoc

1   /*
2    * Copyright (c) 2005 The University of Reading
3    * All rights reserved.
4    *
5    * Redistribution and use in source and binary forms, with or without
6    * modification, are permitted provided that the following conditions
7    * are met:
8    * 1. Redistributions of source code must retain the above copyright
9    *    notice, this list of conditions and the following disclaimer.
10   * 2. Redistributions in binary form must reproduce the above copyright
11   *    notice, this list of conditions and the following disclaimer in the
12   *    documentation and/or other materials provided with the distribution.
13   * 3. Neither the name of the University of Reading, nor the names of the
14   *    authors or contributors may be used to endorse or promote products
15   *    derived from this software without specific prior written permission.
16   * 
17   * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18   * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19   * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20   * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21   * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22   * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23   * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24   * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25   * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26   * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27   */
28  
29  package uk.ac.rdg.resc.jstyx.gridservice.client;
30  
31  import uk.ac.rdg.resc.jstyx.client.CStyxFile;
32  
33  /***
34   * Change listener that defines methods that are called when changes to a 
35   * Styx Grid Service occur
36   *
37   * @author Jon Blower
38   * $Revision: 409 $
39   * $Date: 2005-09-11 19:52:13 +0100 (Sun, 11 Sep 2005) $
40   * $Log$
41   * Revision 1.4  2005/09/11 18:52:13  jonblower
42   * Added error() method
43   *
44   * Revision 1.3  2005/07/28 16:38:58  jonblower
45   * Added material to comments
46   *
47   * Revision 1.2  2005/07/06 17:53:43  jonblower
48   * Implementing automatic update of SGS instances in SGS Explorer
49   *
50   * Revision 1.1  2005/03/16 22:16:44  jonblower
51   * Added Styx Grid Service classes to core module
52   *
53   * Revision 1.1  2005/02/16 19:22:29  jonblower
54   * Commit adding of SGS files to CVS
55   *
56   */
57  public interface SGSChangeListener
58  {
59      /***
60       * Fired when we have got the latest list of instances for this SGS.
61       * @param instances Array of CStyxFiles, one for each directory at the 
62       * root of each instance.  The <code>dirEntry</code>s of all the instances
63       * will have been set, so it is safe to call getDirEntry() on any of the
64       * CStyxFiles without worrying about the method blocking.
65       */
66      public void gotInstances(CStyxFile[] instances);
67      
68      /***
69       * Fired when an error has occurred
70       */
71      public void error(String message);
72      
73  }