org.gridlab.gat
Class GAT

java.lang.Object
  extended by org.gridlab.gat.GAT

public class GAT
extends Object

The GAT class is used to create GAT objects.


Constructor Summary
GAT()
           
 
Method Summary
static AdvertService createAdvertService()
          Create an AdvertService object using the default GATContext.
static AdvertService createAdvertService(GATContext gatContext)
          Create an AdvertService object using the passed GATContext.
static AdvertService createAdvertService(GATContext gatContext, Preferences preferences)
          Create an AdvertService object using the passed GATContext and additional Preferences.
static AdvertService createAdvertService(Preferences preferences)
          Create an AdvertService object using the default GATContext and additional Preferences.
static Endpoint createEndpoint()
          Create an Endpoint for a Pipe using the default GATContext.
static Endpoint createEndpoint(GATContext gatContext)
          Create an Endpoint for a Pipe using the passed GATContext.
static Endpoint createEndpoint(GATContext gatContext, Preferences preferences)
          Create an Endpoint for a Pipe using the default GATContext and additional Preferences.
static Endpoint createEndpoint(Preferences preferences)
          Create an Endpoint for a Pipe using the default GATContext and additional Preferences.
static File createFile(GATContext gatContext, Preferences preferences, String location)
          Constructs a File instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext.
static File createFile(GATContext gatContext, Preferences preferences, URI location)
          Constructs a File instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the passed GATContext.
static File createFile(GATContext gatContext, String location)
          Constructs a File instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext.
static File createFile(GATContext gatContext, URI location)
          Constructs a File instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the passed GATContext.
static File createFile(Preferences preferences, String location)
          Constructs a File instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext with additional Preferences.
static File createFile(Preferences preferences, URI location)
          Constructs a File instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext with additional Preferences.
static File createFile(String location)
          Constructs a File instance which corresponds to the physical file identified by the passed URI, (in String format) and whose access rights are determined by the default GATContext.
static File createFile(URI location)
          Constructs a File instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext.
static FileInputStream createFileInputStream(File file)
          Constructs a FileInputStream instance which corresponds to the physical file identified by the passed File and whose access rights are determined by the GATContext of this File.
static FileInputStream createFileInputStream(GATContext gatContext, File file)
          Constructs a FileInputStream instance which corresponds to the physical file identified by the passed File and whose access rights are determined by the passed GATContext.
static FileInputStream createFileInputStream(GATContext gatContext, Preferences preferences, File file)
          Constructs a FileInputStream instance which corresponds to the physical file identified by the passed file and whose access rights are determined by the passed GATContext with additional Preferences.
static FileInputStream createFileInputStream(GATContext gatContext, Preferences preferences, String location)
          Constructs a FileInputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext with additional Preferences.
static FileInputStream createFileInputStream(GATContext gatContext, Preferences preferences, URI location)
          Constructs a FileInputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the passed GATContext with additional Preferences.
static FileInputStream createFileInputStream(GATContext gatContext, String location)
          Constructs a FileInputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext.
static FileInputStream createFileInputStream(GATContext gatContext, URI location)
          Constructs a FileInputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the passed GATContext.
static FileInputStream createFileInputStream(Preferences preferences, File file)
          Constructs a FileInputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the GATContext of this File and additional Preferences.
static FileInputStream createFileInputStream(Preferences preferences, String location)
          Constructs a FileInputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the default GATContext with additional Preferences.
static FileInputStream createFileInputStream(Preferences preferences, URI location)
          Constructs a FileInputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext with additional Preferences.
static FileInputStream createFileInputStream(String location)
          Constructs a FileInputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the default GATContext.
static FileInputStream createFileInputStream(URI location)
          Constructs a FileInputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext.
static FileOutputStream createFileOutputStream(File file)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed File and whose access rights are determined by the GATContext of this File.
static FileOutputStream createFileOutputStream(File file, boolean append)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed File and whose access rights are determined by the GATContext of this File.
static FileOutputStream createFileOutputStream(GATContext gatContext, File file)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed File and whose access rights are determined by the passed GATContext.
static FileOutputStream createFileOutputStream(GATContext gatContext, File file, boolean append)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed File and whose access rights are determined by the passed GATContext.
static FileOutputStream createFileOutputStream(GATContext gatContext, Preferences preferences, File file)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed File and whose access rights are determined by the passed GATContext and additional Preferences.
static FileOutputStream createFileOutputStream(GATContext gatContext, Preferences preferences, File file, boolean append)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed file and whose access rights are determined by the passed GATContext and additional Preferences.
static FileOutputStream createFileOutputStream(GATContext gatContext, Preferences preferences, String location)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext and additional Preferences.
static FileOutputStream createFileOutputStream(GATContext gatContext, Preferences preferences, String location, boolean append)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext and additional Preferences.
static FileOutputStream createFileOutputStream(GATContext gatContext, Preferences preferences, URI location)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the passed GATContext.
static FileOutputStream createFileOutputStream(GATContext gatContext, Preferences preferences, URI location, boolean append)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the passed GATContext and additional Preferences.
static FileOutputStream createFileOutputStream(GATContext gatContext, String location)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext.
static FileOutputStream createFileOutputStream(GATContext gatContext, String location, boolean append)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext.
static FileOutputStream createFileOutputStream(GATContext gatContext, URI location)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the passed GATContext.
static FileOutputStream createFileOutputStream(GATContext gatContext, URI location, boolean append)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the passed GATContext.
static FileOutputStream createFileOutputStream(Preferences preferences, File file)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed File and whose access rights are determined by the GATContext of this File and additional Preferences.
static FileOutputStream createFileOutputStream(Preferences preferences, File file, boolean append)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed File and whose access rights are determined by the GATContext of this File and additional Preferences.
static FileOutputStream createFileOutputStream(Preferences preferences, String location)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the default GATContext and additional Preferences.
static FileOutputStream createFileOutputStream(Preferences preferences, String location, boolean append)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext and additional Preferences.
static FileOutputStream createFileOutputStream(Preferences preferences, URI location)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext and additional Preferences.
static FileOutputStream createFileOutputStream(Preferences preferences, URI location, boolean append)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext and additional Preferences.
static FileOutputStream createFileOutputStream(String location)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the default GATContext.
static FileOutputStream createFileOutputStream(String location, boolean append)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext.
static FileOutputStream createFileOutputStream(URI location)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext.
static FileOutputStream createFileOutputStream(URI location, boolean append)
          Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext.
static LogicalFile createLogicalFile(GATContext gatContext, Preferences preferences, String name, int mode)
          This method creates a LogicalFile corresponding to the passed URI (in String format) instance using a specified GATContext with additional Preferences.
static LogicalFile createLogicalFile(GATContext gatContext, String name, int mode)
          This method creates a LogicalFile corresponding to the passed URI (in String format) instance using a specified GATContext.
static LogicalFile createLogicalFile(Preferences preferences, String name, int mode)
          This method creates a LogicalFile corresponding to the passed URI (in String format) instance using the default GATContext with additional Preferences.
static LogicalFile createLogicalFile(String name, int mode)
          This method creates a LogicalFile corresponding to the passed URI (in String format) instance using the default GATContext.
static Monitorable createMonitorable()
          Create a (default) Monitorable object using the default GATContext
static Monitorable createMonitorable(GATContext gatContext)
          Create a (default) Monitorable object using the passed GATContext.
static Monitorable createMonitorable(GATContext gatContext, Preferences preferences)
          Create a (default) Monitorable object using the passed GATContext and additional Preferences.
static Monitorable createMonitorable(Preferences preferences)
          Create a (default) Monitorable object using the default GATContext and additional Preferences.
static RandomAccessFile createRandomAccessFile(GATContext gatContext, Preferences preferences, String location, String mode)
          Constructs a RandomAccessFile instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext and additional Preferences.
static RandomAccessFile createRandomAccessFile(GATContext gatContext, Preferences preferences, URI location, String mode)
          Constructs a RandomAccessFile instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the passed GATContext and additional Preferences.
static RandomAccessFile createRandomAccessFile(GATContext gatContext, String location, String mode)
          Constructs a RandomAccessFile instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext.
static RandomAccessFile createRandomAccessFile(GATContext gatContext, URI location, String mode)
          Constructs a RandomAccessFile instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the passed GATContext.
static RandomAccessFile createRandomAccessFile(Preferences preferences, String location, String mode)
          Constructs a RandomAccessFile instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the default GATContext and additional Preferences.
static RandomAccessFile createRandomAccessFile(Preferences preferences, URI location, String mode)
          Constructs a RandomAccessFile instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext and additional Preferences.
static RandomAccessFile createRandomAccessFile(String location, String mode)
          Constructs a RandomAccessFile instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the default GATContext.
static RandomAccessFile createRandomAccessFile(URI location, String mode)
          Constructs a RandomAccessFile instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext.
static ResourceBroker createResourceBroker(GATContext gatContext, Preferences preferences, URI brokerURI)
          This method constructs a ResourceBroker instance corresponding to the passed GATContext and additional Preferences.
static ResourceBroker createResourceBroker(GATContext gatContext, URI brokerURI)
          This method constructs a ResourceBroker instance corresponding to the passed GATContext.
static ResourceBroker createResourceBroker(Preferences preferences, URI brokerURI)
          This method constructs a ResourceBroker instance corresponding to the default GATContext and additional Preferences.
static ResourceBroker createResourceBroker(URI brokerURI)
          This method constructs a ResourceBroker instance corresponding to the default GATContext.
static SteeringManager createSteeringManager()
          Create a SteeringManager object using the default GATContext.
static SteeringManager createSteeringManager(GATContext gatContext)
          Create a SteeringManager object using the passed GATContext.
static SteeringManager createSteeringManager(GATContext gatContext, Preferences preferences)
          Create a SteeringManager object using the passed GATContext and additional Preferences.
static SteeringManager createSteeringManager(Preferences preferences)
          Create a SteeringManager object using the default GATContext and additional Preferences.
static void end()
          This method shuts down the GAT properly and will stop all threads of external libraries used by the GAT.
static AdaptorInfo[] getAdaptorInfos(String type)
          Returns for a given type the information of the adaptors implementing this type.
static String[] getAdaptorTypes()
          Returns all the adaptor types provided by the current set of adaptors in the 'gat.adaptor.path'.
static GATContext getDefaultGATContext()
          Gets the default GATContext.
static void setDefaultGATContext(GATContext context)
          Sets the default GATContext to the new value.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

GAT

public GAT()
Method Detail

createFile

public static File createFile(URI location)
                       throws GATObjectCreationException
Constructs a File instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext.

Parameters:
location - A URI which represents the URI corresponding to the physical file.
Returns:
The File object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFile

public static File createFile(String location)
                       throws GATObjectCreationException
Constructs a File instance which corresponds to the physical file identified by the passed URI, (in String format) and whose access rights are determined by the default GATContext.

Parameters:
location - A String which represents the URI corresponding to the physical file.
Returns:
The File object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFile

public static File createFile(Preferences preferences,
                              URI location)
                       throws GATObjectCreationException
Constructs a File instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext with additional Preferences.

Parameters:
location - A URI which represents the URI corresponding to the physical file.
preferences - A Preferences which is used to determine the user's preferences for this File, these Preferences are added to the Preferences from GATContext.getPreferences(), possibly overriding them.
Returns:
The File object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFile

public static File createFile(Preferences preferences,
                              String location)
                       throws GATObjectCreationException
Constructs a File instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext with additional Preferences.

Parameters:
location - A String which represents the URI corresponding to the physical file.
preferences - A Preferences which is used to determine the user's preferences for this File, these Preferences are added to the Preferences from GATContext.getPreferences(), possibly overriding them.
Returns:
The File object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFile

public static File createFile(GATContext gatContext,
                              URI location)
                       throws GATObjectCreationException
Constructs a File instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the passed GATContext.

Parameters:
location - A URI which represents the URI corresponding to the physical file.
gatContext - A GATContext which is used to determine the access rights for this File.
Returns:
The File object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFile

public static File createFile(GATContext gatContext,
                              String location)
                       throws GATObjectCreationException
Constructs a File instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext.

Parameters:
location - A URI (in String format) which represents the URI corresponding to the physical file.
gatContext - A GATContext which is used to determine the access rights for this File.
Returns:
The File object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFile

public static File createFile(GATContext gatContext,
                              Preferences preferences,
                              String location)
                       throws GATObjectCreationException
Constructs a File instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext.

Parameters:
location - A URI (in String format) which represents the URI corresponding to the physical file.
gatContext - A GATContext which is used to determine the access rights for this File.
preferences - A Preferences which is used to determine the user's preferences for this File, these Preferences are added to the Preferences from GATContext.getPreferences(), possibly overriding them.
Returns:
The File object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFile

public static File createFile(GATContext gatContext,
                              Preferences preferences,
                              URI location)
                       throws GATObjectCreationException
Constructs a File instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the passed GATContext.

Parameters:
location - A URI which represents the URI corresponding to the physical file.
gatContext - A GATContext which is used to determine the access rights for this File.
preferences - A Preferences which is used to determine the user's preferences for this File, these Preferences are added to the Preferences from GATContext.getPreferences(), possibly overriding them.
Returns:
The File object
Throws:
GATObjectCreationException - Thrown upon creation problems

createLogicalFile

public static LogicalFile createLogicalFile(String name,
                                            int mode)
                                     throws GATObjectCreationException
This method creates a LogicalFile corresponding to the passed URI (in String format) instance using the default GATContext.

Parameters:
name - The name in the logical name space
mode - The mode to use for opening this logical file. Choose from LogicalFile.OPEN, LogicalFile.CREATE, LogicalFile.TRUNCATE
Returns:
The LogicalFile object
Throws:
GATObjectCreationException - Thrown upon creation problems

createLogicalFile

public static LogicalFile createLogicalFile(Preferences preferences,
                                            String name,
                                            int mode)
                                     throws GATObjectCreationException
This method creates a LogicalFile corresponding to the passed URI (in String format) instance using the default GATContext with additional Preferences.

Parameters:
preferences - The additional Preferences
name - The name in the logical name space
mode - The mode to use for opening this logical file. Choose from LogicalFile.OPEN, LogicalFile.CREATE, LogicalFile.TRUNCATE
Returns:
The LogicalFile object
Throws:
GATObjectCreationException - Thrown upon creation problems

createLogicalFile

public static LogicalFile createLogicalFile(GATContext gatContext,
                                            String name,
                                            int mode)
                                     throws GATObjectCreationException
This method creates a LogicalFile corresponding to the passed URI (in String format) instance using a specified GATContext.

Parameters:
gatContext - The GATContext
name - The name in the logical name space
mode - The mode to use for opening this logical file. Choose from LogicalFile.OPEN, LogicalFile.CREATE, LogicalFile.TRUNCATE
Returns:
The LogicalFile object
Throws:
GATObjectCreationException - Thrown upon creation problems

createLogicalFile

public static LogicalFile createLogicalFile(GATContext gatContext,
                                            Preferences preferences,
                                            String name,
                                            int mode)
                                     throws GATObjectCreationException
This method creates a LogicalFile corresponding to the passed URI (in String format) instance using a specified GATContext with additional Preferences.

Parameters:
gatContext - The GATContext
preferences - The additional Preferences
name - The name in the logical name space
mode - The mode to use for opening this logical file. Choose from LogicalFile.OPEN, LogicalFile.CREATE, LogicalFile.TRUNCATE
Returns:
The LogicalFile object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileInputStream

public static FileInputStream createFileInputStream(URI location)
                                             throws GATObjectCreationException
Constructs a FileInputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext.

Parameters:
location - location of the File to read from
Returns:
The FileInputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileInputStream

public static FileInputStream createFileInputStream(Preferences preferences,
                                                    URI location)
                                             throws GATObjectCreationException
Constructs a FileInputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext with additional Preferences.

Parameters:
location - location of the File to read from
preferences - The additional Preferences
Returns:
The FileInputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileInputStream

public static FileInputStream createFileInputStream(GATContext gatContext,
                                                    URI location)
                                             throws GATObjectCreationException
Constructs a FileInputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the passed GATContext.

Parameters:
location - location of the File to read from
gatContext - A GATContext which is used to determine the access rights for this File.
Returns:
The FileInputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileInputStream

public static FileInputStream createFileInputStream(GATContext gatContext,
                                                    Preferences preferences,
                                                    URI location)
                                             throws GATObjectCreationException
Constructs a FileInputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the passed GATContext with additional Preferences.

Parameters:
location - URI of the location of the File to read from
gatContext - A GATContext which is used to determine the access rights for this File.
preferences - A Preferences which is used to determine the user's preferences for this File.
Returns:
The FileInputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileInputStream

public static FileInputStream createFileInputStream(File file)
                                             throws GATObjectCreationException
Constructs a FileInputStream instance which corresponds to the physical file identified by the passed File and whose access rights are determined by the GATContext of this File. In order to create a FileInputStream with the default GATContext, use this code:

GAT.createFileInputStream(GAT.getDefaultGATContext(), file)

Parameters:
file - the File to read from
Returns:
The FileInputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileInputStream

public static FileInputStream createFileInputStream(Preferences preferences,
                                                    File file)
                                             throws GATObjectCreationException
Constructs a FileInputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the GATContext of this File and additional Preferences. In order to create a FileInputStream with the default GATContext, use this code:

GAT.createFileInputStream(GAT.getDefaultGATContext(), preferences, file)

Parameters:
file - the File to read from
preferences - The additional Preferences
Returns:
The FileInputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileInputStream

public static FileInputStream createFileInputStream(GATContext gatContext,
                                                    File file)
                                             throws GATObjectCreationException
Constructs a FileInputStream instance which corresponds to the physical file identified by the passed File and whose access rights are determined by the passed GATContext.

Parameters:
file - the File to read from
gatContext - A GATContext which is used to determine the access rights for this File.
Returns:
The FileInputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileInputStream

public static FileInputStream createFileInputStream(GATContext gatContext,
                                                    Preferences preferences,
                                                    File file)
                                             throws GATObjectCreationException
Constructs a FileInputStream instance which corresponds to the physical file identified by the passed file and whose access rights are determined by the passed GATContext with additional Preferences.

Parameters:
file - the File to read from
gatContext - A GATContext which is used to determine the access rights for this File.
preferences - The additional Preferences
Returns:
The FileInputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileInputStream

public static FileInputStream createFileInputStream(String location)
                                             throws GATObjectCreationException
Constructs a FileInputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the default GATContext.

Parameters:
location - location of the File to read from
Returns:
The FileInputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileInputStream

public static FileInputStream createFileInputStream(Preferences preferences,
                                                    String location)
                                             throws GATObjectCreationException
Constructs a FileInputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the default GATContext with additional Preferences.

Parameters:
preferences - the additional Preferences
location - location of the File to read from
Returns:
The FileInputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileInputStream

public static FileInputStream createFileInputStream(GATContext gatContext,
                                                    String location)
                                             throws GATObjectCreationException
Constructs a FileInputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext.

Parameters:
location - URI (in String format) of the location of the File to read from
gatContext - A GATContext which is used to determine the access rights for this File.
Returns:
The FileInputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileInputStream

public static FileInputStream createFileInputStream(GATContext gatContext,
                                                    Preferences preferences,
                                                    String location)
                                             throws GATObjectCreationException
Constructs a FileInputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext with additional Preferences.

Parameters:
location - URI (in String format) of the location of the File to read from
gatContext - A GATContext which is used to determine the access rights for this File.
preferences - The additional Preferences
Returns:
The FileInputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(String location)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the default GATContext. This stream overwrites the existing file.

Parameters:
location - URI (in String format) of the location of the File to write to
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(Preferences preferences,
                                                      String location)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the default GATContext and additional Preferences. This stream overwrites the existing file.

Parameters:
preferences - The additional Preferences
location - URI (in String format) of the location of the File to write to
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(GATContext gatContext,
                                                      String location)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext. This stream overwrites the existing file.

Parameters:
location - URI (in String format) of the location of the File to write to
gatContext - A GATContext which is used to determine the access rights for this File.
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(GATContext gatContext,
                                                      Preferences preferences,
                                                      String location)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext and additional Preferences. This stream overwrites the existing file.

Parameters:
location - URI (in String format) of the location of the file to write to
gatContext - A GATContext which is used to determine the access rights for this File.
preferences - The additional Preferences
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(String location,
                                                      boolean append)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext.

Parameters:
location - URI (in String format) of the location of the file to write to
append - if true, then bytes will be written to the end of the file rather than the beginning
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(Preferences preferences,
                                                      String location,
                                                      boolean append)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext and additional Preferences.

Parameters:
preferences - The additional Preferences
location - URI (in String format) of the location of the file to write to
append - if true, then bytes will be written to the end of the file rather than the beginning
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(GATContext gatContext,
                                                      String location,
                                                      boolean append)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext.

Parameters:
location - URI (in String format) of the location of the file to write to
gatContext - A GATContext which is used to determine the access rights for this File.
append - if true, then bytes will be written to the end of the file rather than the beginning
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(GATContext gatContext,
                                                      Preferences preferences,
                                                      String location,
                                                      boolean append)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext and additional Preferences.

Parameters:
location - URI (in String format) of the location of the file to write to
gatContext - A GATContext which is used to determine the access rights for this File.
preferences - The additional Preferences
append - if true, then bytes will be written to the end of the file rather than the beginning
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(File file)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed File and whose access rights are determined by the GATContext of this File. This stream overwrites the existing file. In order to create a FileOutputStream with the default GATContext, use this code:

GAT.createFileOutputStream(GAT.getDefaultGATContext(), file)

Parameters:
file - the File to write to
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(File file,
                                                      boolean append)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed File and whose access rights are determined by the GATContext of this File. In order to create a FileOutputStream with the default GATContext, use this code:

GAT.createFileOutputStream(GAT.getDefaultGATContext(), file, append)

Parameters:
file - the File to write to
append - true if the output stream should append, false for overwrite
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(Preferences preferences,
                                                      File file)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed File and whose access rights are determined by the GATContext of this File and additional Preferences. This stream overwrites the existing file. In order to create a FileOutputStream with the default GATContext, use this code:

GAT.createFileOutputStream(GAT.getDefaultGATContext(), preferences, file)

Parameters:
preferences - the additional Preferences
file - the File to write to
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(Preferences preferences,
                                                      File file,
                                                      boolean append)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed File and whose access rights are determined by the GATContext of this File and additional Preferences. In order to create a FileOutputStream with the default GATContext, use this code:

GAT.createFileOutputStream(GAT.getDefaultGATContext(), preferences, file, append)

Parameters:
preferences - the additional Preferences
file - the File to write to
append - true if the output stream should append, false for overwrite
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(GATContext gatContext,
                                                      File file)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed File and whose access rights are determined by the passed GATContext. This stream overwrites the existing file.

Parameters:
file - the <@link File> to write to
gatContext - A GATContext which is used to determine the access rights for this File.
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(GATContext gatContext,
                                                      Preferences preferences,
                                                      File file)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed File and whose access rights are determined by the passed GATContext and additional Preferences. This stream overwrites the existing file.

Parameters:
file - the <@link File> to write to
gatContext - A GATContext which is used to determine the access rights for this File.
preferences - the additional Preferences
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(GATContext gatContext,
                                                      File file,
                                                      boolean append)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed File and whose access rights are determined by the passed GATContext.

Parameters:
file - the <@link File> to write to
gatContext - A GATContext which is used to determine the access rights for this File.
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(GATContext gatContext,
                                                      Preferences preferences,
                                                      File file,
                                                      boolean append)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed file and whose access rights are determined by the passed GATContext and additional Preferences.

Parameters:
file - the <@link File> to write to
gatContext - A GATContext which is used to determine the access rights for this File.
preferences - the additional Preferences
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(URI location)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext. This stream overwrites the existing file.

Parameters:
location - URI of the location the <@link File> to write to
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(Preferences preferences,
                                                      URI location)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext and additional Preferences. This stream overwrites the existing file.

Parameters:
location - URI of the location the <@link File> to write to
preferences - the additional Preferences
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(GATContext gatContext,
                                                      URI location)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the passed GATContext. This stream overwrites the existing file.

Parameters:
location - URI of the location the <@link File> to write to
gatContext - A GATContext which is used to determine the access rights for this File.
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(GATContext gatContext,
                                                      Preferences preferences,
                                                      URI location)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the passed GATContext. This stream overwrites the existing file.

Parameters:
location - URI of the location the <@link File> to write to
gatContext - A GATContext which is used to determine the access rights for this File.
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(URI location,
                                                      boolean append)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext.

Parameters:
location - URI of the location the <@link File> to write to
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(Preferences preferences,
                                                      URI location,
                                                      boolean append)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext and additional Preferences.

Parameters:
location - URI of the location the <@link File> to write to
preferences - the additional Preferences
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(GATContext gatContext,
                                                      URI location,
                                                      boolean append)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the passed GATContext.

Parameters:
location - URI of the location the <@link File> to write to
gatContext - A GATContext which is used to determine the access rights for this File.
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createFileOutputStream

public static FileOutputStream createFileOutputStream(GATContext gatContext,
                                                      Preferences preferences,
                                                      URI location,
                                                      boolean append)
                                               throws GATObjectCreationException
Constructs a FileOutputStream instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the passed GATContext and additional Preferences.

Parameters:
location - URI of the location the <@link File> to write to
gatContext - A GATContext which is used to determine the access rights for this File.
preferences - the additional Preferences
Returns:
The FileOutputStream object
Throws:
GATObjectCreationException - Thrown upon creation problems

createEndpoint

public static Endpoint createEndpoint(GATContext gatContext,
                                      Preferences preferences)
                               throws GATObjectCreationException
Create an Endpoint for a Pipe using the default GATContext and additional Preferences.

Parameters:
gatContext - A GATContext which is used to determine the access rights for this File.
preferences - the additional Preferences
Returns:
The Endpoint object
Throws:
GATObjectCreationException - Thrown upon creation problems

createEndpoint

public static Endpoint createEndpoint(GATContext gatContext)
                               throws GATObjectCreationException
Create an Endpoint for a Pipe using the passed GATContext.

Parameters:
gatContext - A GATContext which is used to determine the access rights for this File.
Returns:
The Endpoint object
Throws:
GATObjectCreationException - Thrown upon creation problems

createEndpoint

public static Endpoint createEndpoint(Preferences preferences)
                               throws GATObjectCreationException
Create an Endpoint for a Pipe using the default GATContext and additional Preferences.

Parameters:
preferences - the additional Preferences
Returns:
The Endpoint object
Throws:
GATObjectCreationException - Thrown upon creation problems

createEndpoint

public static Endpoint createEndpoint()
                               throws GATObjectCreationException
Create an Endpoint for a Pipe using the default GATContext.

Returns:
The Endpoint object
Throws:
GATObjectCreationException - Thrown upon creation problems

createAdvertService

public static AdvertService createAdvertService(GATContext gatContext,
                                                Preferences preferences)
                                         throws GATObjectCreationException
Create an AdvertService object using the passed GATContext and additional Preferences.

Parameters:
gatContext - A GATContext which is used to determine the access rights.
preferences - the additional Preferences
Returns:
The AdvertService object
Throws:
GATObjectCreationException - Thrown upon creation problems

createAdvertService

public static AdvertService createAdvertService(GATContext gatContext)
                                         throws GATObjectCreationException
Create an AdvertService object using the passed GATContext.

Parameters:
gatContext - A GATContext which is used to determine the access rights.
Returns:
The AdvertService object
Throws:
GATObjectCreationException - Thrown upon creation problems

createAdvertService

public static AdvertService createAdvertService(Preferences preferences)
                                         throws GATObjectCreationException
Create an AdvertService object using the default GATContext and additional Preferences.

Parameters:
preferences - the additional Preferences
Returns:
The AdvertService object
Throws:
GATObjectCreationException - Thrown upon creation problems

createAdvertService

public static AdvertService createAdvertService()
                                         throws GATObjectCreationException
Create an AdvertService object using the default GATContext.

Returns:
The AdvertService object
Throws:
GATObjectCreationException - Thrown upon creation problems

createMonitorable

public static Monitorable createMonitorable()
                                     throws GATObjectCreationException
Create a (default) Monitorable object using the default GATContext

Returns:
The default Monitorable object
Throws:
GATObjectCreationException - Thrown upon creation problems

createMonitorable

public static Monitorable createMonitorable(Preferences preferences)
                                     throws GATObjectCreationException
Create a (default) Monitorable object using the default GATContext and additional Preferences.

Parameters:
preferences - The additional Preferences
Returns:
The default Monitorable object
Throws:
GATObjectCreationException - Thrown upon creation problems

createMonitorable

public static Monitorable createMonitorable(GATContext gatContext)
                                     throws GATObjectCreationException
Create a (default) Monitorable object using the passed GATContext.

Parameters:
gatContext - A GATContext object
Returns:
The default Monitorable object
Throws:
GATObjectCreationException - Thrown upon creation problems

createMonitorable

public static Monitorable createMonitorable(GATContext gatContext,
                                            Preferences preferences)
                                     throws GATObjectCreationException
Create a (default) Monitorable object using the passed GATContext and additional Preferences.

Parameters:
gatContext - A GATContext object
preferences - The additional Preferences
Returns:
The default Monitorable object
Throws:
GATObjectCreationException - Thrown upon creation problems

createSteeringManager

public static SteeringManager createSteeringManager()
                                             throws GATObjectCreationException
Create a SteeringManager object using the default GATContext.

Returns:
The SteeringManager
Throws:
GATObjectCreationException - Thrown upon creation problems

createSteeringManager

public static SteeringManager createSteeringManager(Preferences preferences)
                                             throws GATObjectCreationException
Create a SteeringManager object using the default GATContext and additional Preferences.

Parameters:
preferences - The additional Preferences
Returns:
The SteeringManager
Throws:
GATObjectCreationException - Thrown upon creation problems

createSteeringManager

public static SteeringManager createSteeringManager(GATContext gatContext)
                                             throws GATObjectCreationException
Create a SteeringManager object using the passed GATContext.

Parameters:
gatContext - A GATContext object
Returns:
The SteeringManager
Throws:
GATObjectCreationException - Thrown upon creation problems

createSteeringManager

public static SteeringManager createSteeringManager(GATContext gatContext,
                                                    Preferences preferences)
                                             throws GATObjectCreationException
Create a SteeringManager object using the passed GATContext and additional Preferences.

Parameters:
gatContext - A GATContext object
preferences - The additional Preferences
Returns:
The SteeringManager
Throws:
GATObjectCreationException - Thrown upon creation problems

createRandomAccessFile

public static RandomAccessFile createRandomAccessFile(String location,
                                                      String mode)
                                               throws GATObjectCreationException
Constructs a RandomAccessFile instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the default GATContext.

Parameters:
location - a URI (in String format) for the file to access.
mode - The mode to open the file with. See RandomAccessFile for details.
Returns:
The RandomAccessFile object
Throws:
GATObjectCreationException - Thrown upon creation problems

createRandomAccessFile

public static RandomAccessFile createRandomAccessFile(Preferences preferences,
                                                      String location,
                                                      String mode)
                                               throws GATObjectCreationException
Constructs a RandomAccessFile instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the default GATContext and additional Preferences.

Parameters:
preferences - The additional Preferences
location - a URI (in String format) for the file to access.
mode - The mode to open the file with. See RandomAccessFile for details.
Returns:
The RandomAccessFile object
Throws:
GATObjectCreationException - Thrown upon creation problems

createRandomAccessFile

public static RandomAccessFile createRandomAccessFile(GATContext gatContext,
                                                      String location,
                                                      String mode)
                                               throws GATObjectCreationException
Constructs a RandomAccessFile instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext.

Parameters:
gatContext - A GATContext which is used to determine the access rights for this File.
location - a URI (in String format) for the file to access.
mode - The mode to open the file with. See RandomAccessFile for details.
Returns:
The RandomAccessFile object
Throws:
GATObjectCreationException - Thrown upon creation problems

createRandomAccessFile

public static RandomAccessFile createRandomAccessFile(GATContext gatContext,
                                                      Preferences preferences,
                                                      String location,
                                                      String mode)
                                               throws GATObjectCreationException
Constructs a RandomAccessFile instance which corresponds to the physical file identified by the passed URI (in String format) and whose access rights are determined by the passed GATContext and additional Preferences.

Parameters:
gatContext - A GATContext which is used to determine the access rights for this File.
preferences - The additional Preferences
location - the URI (in String format) of the file to access
mode - The mode to open the file with. See RandomAccessFile for details.
Returns:
The RandomAccessFile object
Throws:
GATObjectCreationException - Thrown upon creation problems

createRandomAccessFile

public static RandomAccessFile createRandomAccessFile(URI location,
                                                      String mode)
                                               throws GATObjectCreationException
Constructs a RandomAccessFile instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext.

Parameters:
location - a URI for the file to access.
mode - The mode to open the file with. See RandomAccessFile for details.
Returns:
The RandomAccessFile object
Throws:
GATObjectCreationException - Thrown upon creation problems

createRandomAccessFile

public static RandomAccessFile createRandomAccessFile(Preferences preferences,
                                                      URI location,
                                                      String mode)
                                               throws GATObjectCreationException
Constructs a RandomAccessFile instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the default GATContext and additional Preferences.

Parameters:
preferences - The additional Preferences
location - a URI for the file to access.
mode - The mode to open the file with. See RandomAccessFile for details.
Returns:
The RandomAccessFile object
Throws:
GATObjectCreationException - Thrown upon creation problems

createRandomAccessFile

public static RandomAccessFile createRandomAccessFile(GATContext gatContext,
                                                      URI location,
                                                      String mode)
                                               throws GATObjectCreationException
Constructs a RandomAccessFile instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the passed GATContext.

Parameters:
gatContext - A GATContext which is used to determine the access rights for this File.
location - a URI for the file to access.
mode - The mode to open the file with. See RandomAccessFile for details.
Returns:
The RandomAccessFile object
Throws:
GATObjectCreationException - Thrown upon creation problems

createRandomAccessFile

public static RandomAccessFile createRandomAccessFile(GATContext gatContext,
                                                      Preferences preferences,
                                                      URI location,
                                                      String mode)
                                               throws GATObjectCreationException
Constructs a RandomAccessFile instance which corresponds to the physical file identified by the passed URI and whose access rights are determined by the passed GATContext and additional Preferences.

Parameters:
gatContext - A GATContext which is used to determine the access rights for this File.
preferences - The additional Preferences
location - the URISyntaxException of the file to access
mode - The mode to open the file with. See RandomAccessFile for details.
Returns:
The RandomAccessFile object
Throws:
GATObjectCreationException - Thrown upon creation problems

createResourceBroker

public static ResourceBroker createResourceBroker(URI brokerURI)
                                           throws GATObjectCreationException
This method constructs a ResourceBroker instance corresponding to the default GATContext.

Returns:
The ResourceBroker object
Throws:
GATObjectCreationException - Thrown upon creation problems

createResourceBroker

public static ResourceBroker createResourceBroker(Preferences preferences,
                                                  URI brokerURI)
                                           throws GATObjectCreationException
This method constructs a ResourceBroker instance corresponding to the default GATContext and additional Preferences.

Parameters:
preferences - the additional Preferences
Returns:
The ResourceBroker object
Throws:
GATObjectCreationException - Thrown upon creation problems

createResourceBroker

public static ResourceBroker createResourceBroker(GATContext gatContext,
                                                  URI brokerURI)
                                           throws GATObjectCreationException
This method constructs a ResourceBroker instance corresponding to the passed GATContext.

Parameters:
gatContext - A GATContext which will be used to broker resources
Returns:
The ResourceBroker object
Throws:
GATObjectCreationException - Thrown upon creation problems

createResourceBroker

public static ResourceBroker createResourceBroker(GATContext gatContext,
                                                  Preferences preferences,
                                                  URI brokerURI)
                                           throws GATObjectCreationException
This method constructs a ResourceBroker instance corresponding to the passed GATContext and additional Preferences.

Parameters:
gatContext - A GATContext which will be used to broker resources
preferences - The additional Preferences
Returns:
The ResourceBroker object
Throws:
GATObjectCreationException - Thrown upon creation problems

getAdaptorInfos

public static AdaptorInfo[] getAdaptorInfos(String type)
                                     throws GATInvocationException
Returns for a given type the information of the adaptors implementing this type.

Parameters:
type - an adaptor type
Returns:
for a given type the information of the adaptors implementing this type.
Throws:
GATInvocationException

getAdaptorTypes

public static String[] getAdaptorTypes()
                                throws GATInvocationException
Returns all the adaptor types provided by the current set of adaptors in the 'gat.adaptor.path'.

Returns:
all the adaptor types provided by the current set of adaptors in the 'gat.adaptor.path'.
Throws:
GATInvocationException

end

public static void end()
This method shuts down the GAT properly and will stop all threads of external libraries used by the GAT. This method should be invoked at the end of a program that uses JavaGAT.


setDefaultGATContext

public static void setDefaultGATContext(GATContext context)
Sets the default GATContext to the new value. This will replace the previous value.

Parameters:
context - the new GATContext

getDefaultGATContext

public static GATContext getDefaultGATContext()
Gets the default GATContext.

Returns:
the default GATContext