SmartFrog 3.10.000

org.smartfrog.sfcore.reference
Class RemoteReferenceResolverHelperImpl

java.lang.Object
  extended by org.smartfrog.sfcore.reference.RemoteReferenceResolverHelperImpl
Direct Known Subclasses:
PrimImpl

public abstract class RemoteReferenceResolverHelperImpl
extends java.lang.Object


Constructor Summary
protected RemoteReferenceResolverHelperImpl()
           
 
Method Summary
abstract  Reference sfCompleteNameSafe()
          Returns the complete name for this component from the root of the application and does not throw any exception.
abstract  java.lang.Object sfResolve(Reference r)
          Resolves a given reference.
 java.lang.Object sfResolve(Reference reference, boolean mandatory)
          Resolves given reference and gets a java Object.
 boolean sfResolve(Reference reference, boolean defaultValue, boolean mandatory)
          Resolves given reference and gets a boolean.
 ComponentDescription sfResolve(Reference reference, ComponentDescription defaultValue, boolean mandatory)
          Resolves given reference and gets a SmartFrog ComponentDescription.
 Compound sfResolve(Reference reference, Compound defaultValue, boolean mandatory)
          Resolves given reference and gets a SmartFrog Compound.
 double sfResolve(Reference reference, double defaultValue, boolean mandatory)
          Resolves given reference and gets an double.
 double sfResolve(Reference reference, double defaultValue, java.lang.Double minValue, java.lang.Double maxValue, boolean mandatory)
          Resolves given reference and gets an double.
 java.io.File sfResolve(Reference reference, java.io.File defaultValue, boolean mandatory)
          Resolves given reference.
 float sfResolve(Reference reference, float defaultValue, boolean mandatory)
          Resolves given reference and gets an float.
 float sfResolve(Reference reference, float defaultValue, java.lang.Float minValue, java.lang.Float maxValue, boolean mandatory)
          Resolves given reference and gets an float.
 java.net.InetAddress sfResolve(Reference reference, java.net.InetAddress defaultValue, boolean mandatory)
          Resolves given reference and gets a java.net.InetAddress.
abstract  java.lang.Object sfResolve(Reference r, int index)
          Resolves given reference starting at given index.
 int sfResolve(Reference reference, int defaultValue, boolean mandatory)
          Resolves given reference and gets an int.
 int sfResolve(Reference reference, int defaultValue, java.lang.Integer minValue, java.lang.Integer maxValue, boolean mandatory)
          Resolves given reference and gets an int.
 long sfResolve(Reference reference, long defaultValue, boolean mandatory)
          Resolves given reference and gets an long.
 long sfResolve(Reference reference, long defaultValue, java.lang.Long minValue, java.lang.Long maxValue, boolean mandatory)
          Resolves given reference and gets an long.
 java.lang.Object sfResolve(Reference reference, java.lang.Object defaultValue, boolean mandatory)
          Resolves given reference and gets a java Object.
 Prim sfResolve(Reference reference, Prim defaultValue, boolean mandatory)
          Resolves given reference and gets a SmartFrog Prim.
 Reference sfResolve(Reference reference, Reference defaultValue, boolean mandatory)
          Resolves given reference and gets a SmartFrog Reference.
 java.lang.String[] sfResolve(Reference reference, java.lang.String[] defaultValue, boolean mandatory)
          Resolves given reference and gets a String[].
 java.lang.String sfResolve(Reference reference, java.lang.String defaultValue, boolean mandatory)
          Resolves given reference.
 java.net.URL sfResolve(Reference reference, java.net.URL defaultValue, boolean mandatory)
          Resolves given reference and gets a java.net.URL.
 java.util.Vector sfResolve(Reference reference, java.util.Vector defaultValue, boolean mandatory)
          Resolves given reference and gets a Vector.
 java.lang.Object sfResolve(java.lang.String referencePart)
          Resolves a referencePart given a string.
 java.lang.Object sfResolve(java.lang.String referencePart, boolean mandatory)
          Resolves a referencePart given a string and gets a java Object.
 boolean sfResolve(java.lang.String referencePart, boolean defaultValue, boolean mandatory)
          Resolves a referencePart given a string and gets a boolean.
 ComponentDescription sfResolve(java.lang.String referencePart, ComponentDescription defaultValue, boolean mandatory)
          Resolves a referencePart given a string and gets a SmartFrog ComponentDescription.
 Compound sfResolve(java.lang.String referencePart, Compound defaultValue, boolean mandatory)
          Resolves a referencePart given a string and gets a SmartFrog Compound.
 double sfResolve(java.lang.String referencePart, double defaultValue, boolean mandatory)
          Resolves a referencePart given a string and gets a double.
 double sfResolve(java.lang.String referencePart, double defaultValue, java.lang.Double minValue, java.lang.Double maxValue, boolean mandatory)
          Resolves a referencePart given a string and gets a double.
 java.io.File sfResolve(java.lang.String referencePart, java.io.File defaultValue, boolean mandatory)
          Resolves a referencePart given a String and gets a File.
 float sfResolve(java.lang.String referencePart, float defaultValue, boolean mandatory)
          Resolves a referencePart given a string and gets a float.
 float sfResolve(java.lang.String referencePart, float defaultValue, java.lang.Float minValue, java.lang.Float maxValue, boolean mandatory)
          Resolves a referencePart given a string and gets a float.
 java.net.InetAddress sfResolve(java.lang.String referencePart, java.net.InetAddress defaultValue, boolean mandatory)
          Resolves a referencePart given a string and gets a SmartFrog Reference.
 int sfResolve(java.lang.String referencePart, int defaultValue, boolean mandatory)
          Resolves a referencePart given a string and gets a int.
 int sfResolve(java.lang.String referencePart, int defaultValue, java.lang.Integer minValue, java.lang.Integer maxValue, boolean mandatory)
          Resolves a referencePart given a string and gets a int.
 long sfResolve(java.lang.String referencePart, long defaultValue, boolean mandatory)
          Resolves a referencePart given a string and gets a long.
 long sfResolve(java.lang.String referencePart, long defaultValue, java.lang.Long minValue, java.lang.Long maxValue, boolean mandatory)
          Resolves a referencePart given a string and gets a long.
 java.lang.Object sfResolve(java.lang.String referencePart, java.lang.Object defaultValue, boolean mandatory)
          Resolves a referencePart given a string and gets a java Object.
 Prim sfResolve(java.lang.String referencePart, Prim defaultValue, boolean mandatory)
          Resolves a referencePart given a string and gets a SmartFrog Prim.
 Reference sfResolve(java.lang.String referencePart, Reference defaultValue, boolean mandatory)
          Resolves a referencePart given a string and gets a SmartFrog Reference.
 java.lang.String[] sfResolve(java.lang.String referencePart, java.lang.String[] defaultValue, boolean mandatory)
          Resolves a referencePart given a string and gets a String[].
 java.lang.String sfResolve(java.lang.String referencePart, java.lang.String defaultValue, boolean mandatory)
          Resolves a referencePart given a string and gets a String.
 java.net.URL sfResolve(java.lang.String referencePart, java.net.URL defaultValue, boolean mandatory)
          Resolves a referencePart given a string and gets a SmartFrog Reference.
 java.util.Vector sfResolve(java.lang.String referencePart, java.util.Vector defaultValue, boolean mandatory)
          Resolves a referencePart given a string and gets a Vector.
 java.lang.Object sfResolveWithParser(java.lang.String reference)
          Resolves a reference given a string.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

RemoteReferenceResolverHelperImpl

protected RemoteReferenceResolverHelperImpl()
Method Detail

sfCompleteNameSafe

public abstract Reference sfCompleteNameSafe()
Returns the complete name for this component from the root of the application and does not throw any exception. If an exception is thrown it will return a new empty reference.

Returns:
reference of attribute names to this component or an empty reference

sfResolve

public abstract java.lang.Object sfResolve(Reference r)
                                    throws SmartFrogResolutionException,
                                           java.rmi.RemoteException
Resolves a given reference. Forwards to indexed resolve with index 0 and return resulting attribute value.

Parameters:
r - reference to resolve
Returns:
resolved reference
Throws:
SmartFrogResolutionException - occurred while resolving
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public abstract java.lang.Object sfResolve(Reference r,
                                           int index)
                                    throws SmartFrogResolutionException,
                                           java.rmi.RemoteException
Resolves given reference starting at given index. This is forwarded to the reference (and on to each reference part).

Parameters:
r - reference to resolve
index - index in reference to start resolving
Returns:
resolved reference
Throws:
SmartFrogResolutionException - error occurred while resolving
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public java.lang.Object sfResolve(java.lang.String referencePart)
                           throws SmartFrogResolutionException,
                                  java.rmi.RemoteException
Resolves a referencePart given a string. Utility method to auto-convert from string to reference. NOTE: To resolve a reference from a String using a reference cannonical representation it is neccesary to do: "return sfResolve(Reference.fromString(reference));"so that the parser is invoked.

Parameters:
referencePart - stringified reference
Returns:
java Object for attribute value
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolveWithParser

public java.lang.Object sfResolveWithParser(java.lang.String reference)
                                     throws SmartFrogResolutionException,
                                            java.rmi.RemoteException
Resolves a reference given a string. Utility method to auto-convert from string to reference. It can use cannonical representations that are resolved by the parser (parse = true).

Parameters:
reference - string field reference
Returns:
java Object for attribute value
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public java.lang.Object sfResolve(Reference reference,
                                  boolean mandatory)
                           throws SmartFrogResolutionException,
                                  java.rmi.RemoteException
Resolves given reference and gets a java Object. Utility method to resolve an attribute with a java Object value.

Parameters:
reference - reference
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
java Object for attribute value or null if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public java.lang.Object sfResolve(java.lang.String referencePart,
                                  boolean mandatory)
                           throws SmartFrogResolutionException,
                                  java.rmi.RemoteException
Resolves a referencePart given a string and gets a java Object.

Parameters:
referencePart - string field reference
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
Reference for attribute value, null if SFNull is found or null if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public boolean sfResolve(Reference reference,
                         boolean defaultValue,
                         boolean mandatory)
                  throws SmartFrogResolutionException,
                         java.rmi.RemoteException
Resolves given reference and gets a boolean. Utility method to resolve an attribute with a boolean value.

Parameters:
reference - reference
defaultValue - boolean default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a ResolutionException
Returns:
boolean for attribute value or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public int sfResolve(Reference reference,
                     int defaultValue,
                     boolean mandatory)
              throws SmartFrogResolutionException,
                     java.rmi.RemoteException
Resolves given reference and gets an int. Utility method to resolve an attribute with an int value.

Parameters:
reference - reference
defaultValue - int default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
int for attribute value or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public int sfResolve(Reference reference,
                     int defaultValue,
                     java.lang.Integer minValue,
                     java.lang.Integer maxValue,
                     boolean mandatory)
              throws SmartFrogResolutionException,
                     java.rmi.RemoteException
Resolves given reference and gets an int. Utility method to resolve an attribute with an int value.

Parameters:
reference - reference
defaultValue - int default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
minValue - allowed (included)
maxValue - allowed (included)
Returns:
int for attribute value or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable or resolved value < minValue or > maxValue
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public long sfResolve(Reference reference,
                      long defaultValue,
                      boolean mandatory)
               throws SmartFrogResolutionException,
                      java.rmi.RemoteException
Resolves given reference and gets an long. Utility method to resolve an attribute with an long value. Int values are "upcasted" to long.

Parameters:
reference - reference
defaultValue - long default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
long for attribute value or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public long sfResolve(Reference reference,
                      long defaultValue,
                      java.lang.Long minValue,
                      java.lang.Long maxValue,
                      boolean mandatory)
               throws SmartFrogResolutionException,
                      java.rmi.RemoteException
Resolves given reference and gets an long. Utility method to resolve an attribute with an long value. Int values are "upcasted" to long.

Parameters:
reference - reference
defaultValue - long default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
minValue - allowed (included)
maxValue - allowed (included)
Returns:
long for attribute value or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable or resolved value < minValue or > maxValue
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public float sfResolve(Reference reference,
                       float defaultValue,
                       boolean mandatory)
                throws SmartFrogResolutionException,
                       java.rmi.RemoteException
Resolves given reference and gets an float. Utility method to resolve an attribute with an float value. Integer values are "upcasted" to float.

Parameters:
reference - reference
defaultValue - float default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
float for attribute value or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public float sfResolve(Reference reference,
                       float defaultValue,
                       java.lang.Float minValue,
                       java.lang.Float maxValue,
                       boolean mandatory)
                throws SmartFrogResolutionException,
                       java.rmi.RemoteException
Resolves given reference and gets an float. Utility method to resolve an attribute with an float value. Int values are "upcasted" to float.

Parameters:
reference - reference
defaultValue - float default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
minValue - allowed (included)
maxValue - allowed (included)
Returns:
float for attribute value or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable or resolved value < minValue or > maxValue
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public double sfResolve(Reference reference,
                        double defaultValue,
                        boolean mandatory)
                 throws SmartFrogResolutionException,
                        java.rmi.RemoteException
Resolves given reference and gets an double. Utility method to resolve an attribute with an double value. Integer values are "upcasted" to double.

Parameters:
reference - reference
defaultValue - double default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
double for attribute value or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public double sfResolve(Reference reference,
                        double defaultValue,
                        java.lang.Double minValue,
                        java.lang.Double maxValue,
                        boolean mandatory)
                 throws SmartFrogResolutionException,
                        java.rmi.RemoteException
Resolves given reference and gets an double. Utility method to resolve an attribute with an double value. Int values are "upcasted" to double.

Parameters:
reference - reference
defaultValue - double default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
minValue - allowed (included)
maxValue - allowed (included)
Returns:
double for attribute value or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable or resolved value < minValue or > maxValue
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public java.lang.String sfResolve(Reference reference,
                                  java.lang.String defaultValue,
                                  boolean mandatory)
                           throws SmartFrogResolutionException,
                                  java.rmi.RemoteException
Resolves given reference. Utility method to resolve an attribute with a String value.

Parameters:
reference - reference
defaultValue - String default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
String for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public java.util.Vector sfResolve(Reference reference,
                                  java.util.Vector defaultValue,
                                  boolean mandatory)
                           throws SmartFrogResolutionException,
                                  java.rmi.RemoteException
Resolves given reference and gets a Vector. Utility method to resolve an attribute with a Vector value.

Parameters:
reference - reference
defaultValue - Vector default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
Vector for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public java.lang.String[] sfResolve(Reference reference,
                                    java.lang.String[] defaultValue,
                                    boolean mandatory)
                             throws SmartFrogResolutionException,
                                    java.rmi.RemoteException
Resolves given reference and gets a String[]. Utility method to resolve an attribute with a Vector value and returns a String[].

Parameters:
reference - reference
defaultValue - String[] default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
String[] for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public java.io.File sfResolve(Reference reference,
                              java.io.File defaultValue,
                              boolean mandatory)
                       throws SmartFrogResolutionException,
                              java.rmi.RemoteException
Resolves given reference. Utility method to resolve an attribute with a String value returning a File

Parameters:
reference - reference
defaultValue - File default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
java.io.File for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public ComponentDescription sfResolve(Reference reference,
                                      ComponentDescription defaultValue,
                                      boolean mandatory)
                               throws SmartFrogResolutionException,
                                      java.rmi.RemoteException
Resolves given reference and gets a SmartFrog ComponentDescription. Utility method to resolve an attribute with a SmartFrog ComponentDescription value.

Parameters:
reference - reference
defaultValue - SmartFrog ComponentDescription default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
SmartFrog ComponentDescription for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public Reference sfResolve(Reference reference,
                           Reference defaultValue,
                           boolean mandatory)
                    throws SmartFrogResolutionException,
                           java.rmi.RemoteException
Resolves given reference and gets a SmartFrog Reference. Utility method to resolve an attribute with a SmartFrog Reference value.

Parameters:
reference - reference
defaultValue - SmartFrog Reference default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
SmartFrog Reference for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public Prim sfResolve(Reference reference,
                      Prim defaultValue,
                      boolean mandatory)
               throws SmartFrogResolutionException,
                      java.rmi.RemoteException
Resolves given reference and gets a SmartFrog Prim. Utility method to resolve an attribute with a SmartFrog Prim value.

Parameters:
reference - reference
defaultValue - SmartFrog Prim default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
SmartFrog Prim for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public Compound sfResolve(Reference reference,
                          Compound defaultValue,
                          boolean mandatory)
                   throws SmartFrogResolutionException,
                          java.rmi.RemoteException
Resolves given reference and gets a SmartFrog Compound. Utility method to resolve an attribute with a SmartFrog Compound value.

Parameters:
reference - reference
defaultValue - SmartFrog Compound default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
SmartFrog Compound for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public java.net.InetAddress sfResolve(Reference reference,
                                      java.net.InetAddress defaultValue,
                                      boolean mandatory)
                               throws SmartFrogResolutionException,
                                      java.rmi.RemoteException
Resolves given reference and gets a java.net.InetAddress. Utility method to resolve an attribute with a SmartFrog java.net.InetAddress value.

Parameters:
reference - reference
defaultValue - java.net.InetAddress default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
java.net.InetAddress for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public java.net.URL sfResolve(Reference reference,
                              java.net.URL defaultValue,
                              boolean mandatory)
                       throws SmartFrogResolutionException,
                              java.rmi.RemoteException
Resolves given reference and gets a java.net.URL. Utility method to resolve an attribute with a SmartFrog java.net.URL value.

Parameters:
reference - reference
defaultValue - java.net.URL default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
java.net.URL for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public java.lang.Object sfResolve(Reference reference,
                                  java.lang.Object defaultValue,
                                  boolean mandatory)
                           throws SmartFrogResolutionException,
                                  java.rmi.RemoteException
Resolves given reference and gets a java Object. Utility method to resolve an attribute with a java Object value.

Parameters:
reference - reference
defaultValue - java Object default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
java Object for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public boolean sfResolve(java.lang.String referencePart,
                         boolean defaultValue,
                         boolean mandatory)
                  throws SmartFrogResolutionException,
                         java.rmi.RemoteException
Resolves a referencePart given a string and gets a boolean. Utility method to resolve an attribute with a boolean value.

Parameters:
referencePart - string field reference
defaultValue - boolean default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
boolean for attribute value or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public int sfResolve(java.lang.String referencePart,
                     int defaultValue,
                     boolean mandatory)
              throws SmartFrogResolutionException,
                     java.rmi.RemoteException
Resolves a referencePart given a string and gets a int. Utility method to resolve an attribute with an int value.

Parameters:
referencePart - string field reference
defaultValue - int default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
int for attribute value or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public int sfResolve(java.lang.String referencePart,
                     int defaultValue,
                     java.lang.Integer minValue,
                     java.lang.Integer maxValue,
                     boolean mandatory)
              throws SmartFrogResolutionException,
                     java.rmi.RemoteException
Resolves a referencePart given a string and gets a int. Utility method to resolve an attribute with an int value.

Parameters:
referencePart - string field reference
defaultValue - int default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
minValue - allowed (included)
maxValue - allowed (included)
Returns:
int for attribute value or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable or resolved value < minValue or > maxValue
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public long sfResolve(java.lang.String referencePart,
                      long defaultValue,
                      boolean mandatory)
               throws SmartFrogResolutionException,
                      java.rmi.RemoteException
Resolves a referencePart given a string and gets a long. Utility method to resolve an attribute with an long value. Int values are upcastted to long.

Parameters:
referencePart - string field reference
defaultValue - long default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
long for attribute value or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public long sfResolve(java.lang.String referencePart,
                      long defaultValue,
                      java.lang.Long minValue,
                      java.lang.Long maxValue,
                      boolean mandatory)
               throws SmartFrogResolutionException,
                      java.rmi.RemoteException
Resolves a referencePart given a string and gets a long. Utility method to resolve an attribute with an long value. Int values are upcastted to long.

Parameters:
referencePart - string field reference
defaultValue - long default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
minValue - allowed (included)
maxValue - allowed (included)
Returns:
long for attribute value or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable or resolved value < minValue or > maxValue
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public float sfResolve(java.lang.String referencePart,
                       float defaultValue,
                       boolean mandatory)
                throws SmartFrogResolutionException,
                       java.rmi.RemoteException
Resolves a referencePart given a string and gets a float. Utility method to resolve an attribute with an float value.

Parameters:
referencePart - string field reference
defaultValue - float default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
float for attribute value or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public float sfResolve(java.lang.String referencePart,
                       float defaultValue,
                       java.lang.Float minValue,
                       java.lang.Float maxValue,
                       boolean mandatory)
                throws SmartFrogResolutionException,
                       java.rmi.RemoteException
Resolves a referencePart given a string and gets a float. Utility method to resolve an attribute with an float value.

Parameters:
referencePart - string field reference
defaultValue - float default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
minValue - allowed (included)
maxValue - allowed (included)
Returns:
float for attribute value or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable or resolved value < minValue or > maxValue
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public double sfResolve(java.lang.String referencePart,
                        double defaultValue,
                        boolean mandatory)
                 throws SmartFrogResolutionException,
                        java.rmi.RemoteException
Resolves a referencePart given a string and gets a double. Utility method to resolve an attribute with an double value. Int values are upcasted to double.

Parameters:
referencePart - string field reference
defaultValue - double default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
double for attribute value or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public double sfResolve(java.lang.String referencePart,
                        double defaultValue,
                        java.lang.Double minValue,
                        java.lang.Double maxValue,
                        boolean mandatory)
                 throws SmartFrogResolutionException,
                        java.rmi.RemoteException
Resolves a referencePart given a string and gets a double. Utility method to resolve an attribute with an double value. Integer, Long and Float values are upcasted to double.

Parameters:
referencePart - string field reference
defaultValue - double default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
minValue - allowed (included)
maxValue - allowed (included)
Returns:
double for attribute value or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable or resolved value < minValue or > maxValue
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public java.lang.String sfResolve(java.lang.String referencePart,
                                  java.lang.String defaultValue,
                                  boolean mandatory)
                           throws SmartFrogResolutionException,
                                  java.rmi.RemoteException
Resolves a referencePart given a string and gets a String. Utility method to resolve an attribute with a String value.

Parameters:
referencePart - string field reference
defaultValue - String default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
String for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public java.util.Vector sfResolve(java.lang.String referencePart,
                                  java.util.Vector defaultValue,
                                  boolean mandatory)
                           throws SmartFrogResolutionException,
                                  java.rmi.RemoteException
Resolves a referencePart given a string and gets a Vector. Utility method * to resolve an attribute with a Vector value.

Parameters:
referencePart - string field reference
defaultValue - Vector default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
Vector for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public java.lang.String[] sfResolve(java.lang.String referencePart,
                                    java.lang.String[] defaultValue,
                                    boolean mandatory)
                             throws SmartFrogResolutionException,
                                    java.rmi.RemoteException
Resolves a referencePart given a string and gets a String[]. Utility method to resolve an attribute with a Vector value and returns a String[]

Parameters:
referencePart - string field reference
defaultValue - String[] default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
String[] for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public java.io.File sfResolve(java.lang.String referencePart,
                              java.io.File defaultValue,
                              boolean mandatory)
                       throws SmartFrogResolutionException,
                              java.rmi.RemoteException
Resolves a referencePart given a String and gets a File. Utility method to resolve an attribute with a String value returning a File

Parameters:
referencePart - string field reference
defaultValue - File default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
File for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public ComponentDescription sfResolve(java.lang.String referencePart,
                                      ComponentDescription defaultValue,
                                      boolean mandatory)
                               throws SmartFrogResolutionException,
                                      java.rmi.RemoteException
Resolves a referencePart given a string and gets a SmartFrog ComponentDescription. Utility method to resolve an attribute with a SmartFrog ComponentDescription value.

Parameters:
referencePart - string field reference
defaultValue - SmartFrog ComponentDescription default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
ComponentDescription for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public Reference sfResolve(java.lang.String referencePart,
                           Reference defaultValue,
                           boolean mandatory)
                    throws SmartFrogResolutionException,
                           java.rmi.RemoteException
Resolves a referencePart given a string and gets a SmartFrog Reference. Utility method to resolve an attribute with a SmartFrog ComponentDescription value.

Parameters:
referencePart - string field reference
defaultValue - SmartFrog Reference default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
Reference for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public Prim sfResolve(java.lang.String referencePart,
                      Prim defaultValue,
                      boolean mandatory)
               throws SmartFrogResolutionException,
                      java.rmi.RemoteException
Resolves a referencePart given a string and gets a SmartFrog Prim. Utility method to resolve an attribute with a SmartFrog ComponentDescription value.

Parameters:
referencePart - string field reference
defaultValue - SmartFrog Prim default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
Prim for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public Compound sfResolve(java.lang.String referencePart,
                          Compound defaultValue,
                          boolean mandatory)
                   throws SmartFrogResolutionException,
                          java.rmi.RemoteException
Resolves a referencePart given a string and gets a SmartFrog Compound. Utility method to resolve an attribute with a SmartFrog ComponentDescription value.

Parameters:
referencePart - string field reference
defaultValue - SmartFrog Compound default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
Compound for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public java.net.InetAddress sfResolve(java.lang.String referencePart,
                                      java.net.InetAddress defaultValue,
                                      boolean mandatory)
                               throws SmartFrogResolutionException,
                                      java.rmi.RemoteException
Resolves a referencePart given a string and gets a SmartFrog Reference. Utility method to resolve an attribute with a java.net.InetAddress value.

Parameters:
referencePart - string field reference
defaultValue - java.net.InetAddress default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
Reference for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public java.net.URL sfResolve(java.lang.String referencePart,
                              java.net.URL defaultValue,
                              boolean mandatory)
                       throws SmartFrogResolutionException,
                              java.rmi.RemoteException
Resolves a referencePart given a string and gets a SmartFrog Reference. Utility method to resolve an attribute with a java.net.URL value.

Parameters:
referencePart - string field reference
defaultValue - java.net.URL default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
Reference for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

sfResolve

public java.lang.Object sfResolve(java.lang.String referencePart,
                                  java.lang.Object defaultValue,
                                  boolean mandatory)
                           throws SmartFrogResolutionException,
                                  java.rmi.RemoteException
Resolves a referencePart given a string and gets a java Object.

Parameters:
referencePart - string field reference
defaultValue - java Object default value that is returned when reference is not found and it is not mandatory
mandatory - boolean that indicates if this attribute must be present in the description. If it is mandatory and not found it triggers a SmartFrogResolutionException
Returns:
Reference for attribute value, null if SFNull is found or defaultValue if not found
Throws:
SmartFrogResolutionException - illegal reference or reference not resolvable
java.rmi.RemoteException - In case of network/rmi error

SmartFrog CORE 3.10.000

(C) Copyright 1998-2006 Hewlett-Packard Development Company, LP