TransformationCatalogTextParser (PEGASUS)

java.lang.Object
- edu.isi.pegasus.planner.parser.TransformationCatalogTextParser

public class TransformationCatalogTextParser
extends Object

Parses the input stream and generates the TransformationStore as output. This parser is able to parse the Transformation Catalog specification in the following format

 tr example::keg:1.0 {
 
  #specify profiles that apply for all the sites for the transformation
  #in each site entry the profile can be overriden
  profile env "APP_HOME" "/tmp/karan"
  profile env "JAVA_HOME" "/bin/java.1.5"
 
  site isi {
   profile env "me" "with"
   profile condor "more" "test"
   profile env "JAVA_HOME" "/bin/java.1.6"
   pfn "/path/to/keg"
   arch  "x86"
   os    "linux"
   osrelease "fc"
   osversion "4"
   type "installed"            
  }
 
  site wind {
   profile env "me" "with"
   profile condor "more" "test"
   pfn "/path/to/keg"
   arch  "x86"
   os    "linux"
   osrelease "fc"
   osversion "4"
   type "STAGEABLE"
  }
 }

Version:: $Revision$
Author:: Karan Vahi, Jens V??ckler
See Also:: TransformationCatalogTextScanner

Field Summary

Fields
Modifier and Type	Field and Description
`private LogManager`	`mLogger` The transformation to the logger used to log messages.
`private Token`	`mLookAhead` Stores the look-ahead symbol.
`private TransformationCatalogTextScanner`	`mScanner` The access to the lexical scanner is stored here.

Constructor Summary

Constructors
Constructor and Description
`TransformationCatalogTextParser(Reader r, LogManager logger)` Initializes the parser with an input stream to read from.

Method Summary

Methods
Modifier and Type	Method and Description
`private Profile`	`getProfile()` Parses a single line and returns a profile.
`private Profiles`	`getProfilesForTransformation()` Returns a list of profiles that have to be applied to the entries for all the sites corresponding to a transformation.
`private String`	`getQuotedValue(String key)` Parses a quoted value and strips out the enclosing quotes.
`private String`	`getSite()` Returns the site transformation for a site, and moves the scanner to hold the next `TransformationCatalogReservedWord`.
`private String`	`getTransformation()` Returns the transformation name, and moves the scanner to hold the next `TransformationCatalogReservedWord`.
`private TransformationCatalogEntry`	`getTransformationCatalogEntry(String transformation, Profiles profiles, boolean modifyFileURL)` Constructs a single transformation catalog entry and returns it.
`static void`	`main(String[] args)` Test function.
`String`	`niceString(String input)` Remove potential leading and trainling quotes from a string.
`TransformationStore`	`parse(boolean modifyFileURL)` Parses the complete input stream, into the PoolConfig data object that holds the contents of all the sites referred to in the stream.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - mScanner
```
private TransformationCatalogTextScanner mScanner
```
    The access to the lexical scanner is stored here.
  - mLookAhead
```
private Token mLookAhead
```
    Stores the look-ahead symbol.
  - mLogger
```
private LogManager mLogger
```
    The transformation to the logger used to log messages.
- Constructor Detail
  - TransformationCatalogTextParser
```
public TransformationCatalogTextParser(Reader r,
                               LogManager logger)
                                throws IOException,
                                       ScannerException
```
    Initializes the parser with an input stream to read from.
    
    Parameters:
    r - is the stream opened for reading.
    logger - the transformation to the logger.
    
    Throws:
    
    IOException
    
    ScannerException
- Method Detail
  - parse
```
public TransformationStore parse(boolean modifyFileURL)
                          throws IOException,
                                 ScannerException
```
    Parses the complete input stream, into the PoolConfig data object that holds the contents of all the sites referred to in the stream.
    
    Parameters:
    modifyFileURL - Boolean indicating whether to modify the file URL or not
    
    Returns:
    TransformationStore
    
    Throws:
    
    IOException
    
    ScannerException
    
    Exception
    See Also:
    org.griphyn.cPlanner.classes.PoolConfig
  - niceString
```
public String niceString(String input)
```
    Remove potential leading and trainling quotes from a string.
    
    Parameters:
    input - is a string which may have leading and trailing quotes
    
    Returns:
    a string that is either identical to the input, or a substring thereof.
  - getTransformationCatalogEntry
```
private TransformationCatalogEntry getTransformationCatalogEntry(String transformation,
                                                       Profiles profiles,
                                                       boolean modifyFileURL)
                                                          throws IOException,
                                                                 ScannerException
```
    Constructs a single transformation catalog entry and returns it.
    
    Parameters:
    entry - the TransformationCatalogEntry object that is to be populated.
    profiles - the profiles that apply to all the entries
    modifyFileURL - Boolean indicating whether to modify the file URL or not
    Returns: the transformation catalog entry object. Throws: even - more mystery IOException ScannerException
  getTransformation private String getTransformation() throws IOException, ScannerException Returns the transformation name, and moves the scanner to hold the next TransformationCatalogReservedWord. Returns: the transformation name Throws: plenty IOException ScannerException getSite private String getSite() throws IOException, ScannerException Returns the site transformation for a site, and moves the scanner to hold the next TransformationCatalogReservedWord. Returns: the transformation name Throws: plenty IOException ScannerException getProfilesForTransformation private Profiles getProfilesForTransformation() throws IOException, ScannerException Returns a list of profiles that have to be applied to the entries for all the sites corresponding to a transformation. Returns: Profiles specified Throws: IOException ScannerException getProfile private Profile getProfile() throws ScannerException, IOException Parses a single line and returns a profile. Returns: Profile Throws: ScannerException IOException getQuotedValue private String getQuotedValue(String key) throws IOException Parses a quoted value and strips out the enclosing quotes. Parameters: key - the key for which we need to associated the quoted value Returns: quoted value. Throws: IOException main public static void main(String[] args) throws ScannerException Test function. Parameters: args - Throws: ScannerException

Class TransformationCatalogTextParser

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

mScanner

mLookAhead

mLogger

Constructor Detail

TransformationCatalogTextParser

Method Detail

parse

niceString

getTransformationCatalogEntry

getTransformation

getSite

getProfilesForTransformation

getProfile

getQuotedValue

main