org.smartfrog.sfcore.reference
Class RemoteReferenceResolverHelperImpl

java.lang.Object
  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