Skip navigation links

weblogic.common
Class ParamValue

java.lang.Object
  weblogic.common.ParamValue

All Implemented Interfaces:

Externalizable, Serializable, Cloneable

public final class ParamValue

extends Object

implements Cloneable, Externalizable

A ParamValue is the value part of a name/value pair used for events and remote procedures.

A ParamValue may be made up of a vector of ParamValues, in which case the elements in the vector are accessible by index position.

The variables in this class are used for setting attributes for IN, OUT and IN/OUT parameters used for database stored procedures.

Conversions among the various datatypes are handled automatically in a "Java" way, i.e., the conversion can be accomplished either of these ways:

• With a cast. For example, for float --> int, you might use:

    float f = 1.2;
     int i = (int) f;
  

• By using some java.* method for the conversion. For example, you might use:

    boolean b = Boolean.booleanValue("t");
  

Illegal conversions (for example, int to boolean) throw a ParamSetException.

See Also:

Serialized Form

paramName

protected String paramName

Variable used for IN, OUT, and IN/OUT parameters to set the name of the parameter. Default is null.

paramDesc

protected String paramDesc

Variable used for IN, OUT, and IN/OUT parameters to set the descriptor of the parameter. Default is null.

paramType

protected int paramType

Variable used for IN, OUT, and IN/OUT parameters to set the type of the parameter. Default is ParamTypes.NOTYPE.

paramMode

protected int paramMode

Variable used for IN, OUT, and IN/OUT parameters to set the mode of the parameter. Default is ParamTypes.IN.

initialize

public void initialize()

Initializes a ParamValue. Sets the variables paramName and paramDesc to null; sets the variable paramType to ParamTypes.NOTYPE; and sets the variable paramMode to ParamTypes.IN.

destroy

public void destroy()

Destroys a ParamValue object.

clone

public Object clone()

Clones a ParamValue. The clone is shallow, that is the "value" contained in the ParamValue is not cloned unless it is a Vector.

Overrides:

clone in class Object

readExternal

public void readExternal(ObjectInput oi)
                  throws IOException

Constructs a ParamValue from the specified serialization stream

Specified by:

readExternal in interface Externalizable

Parameters:

oi - WLObjectInput

Throws:

IOException - if there is an IO error

writeExternal

public void writeExternal(ObjectOutput oo)
                   throws IOException

Writes a ParamValue object to a serialization stream.

Specified by:

writeExternal in interface Externalizable

Throws:

IOException

name

public String name()

Returns the paramName of a ParamValue.

Returns:

String

paramDesc

public String paramDesc()

Returns the paramDesc of a ParamValue.

Returns:

Parameter description

paramType

public int paramType()

Returns the paramType of a ParamValue.

Returns:

int

paramTypeString

public String paramTypeString()

Returns the paramType of a ParamValue as a String.

Returns:

Data type as a String

paramModeString

public String paramModeString()

Returns the paramMode of a ParamValue as a String.

Returns:

Mode as a String

isNull

public boolean isNull(int index)
               throws ParamSetException

Determines whether a ParamValue that is a vector of ParamValues is null at the specified index position.

Parameters:

index - Index into the vector of a ParamValue

Returns:

true if null

Throws:

ParamSetException - if there is an error

isNull

public boolean isNull()

Determines whether a ParamValue is null.

Returns:

true if null

paramMode

public int paramMode()

Returns the paramMode of a ParamValue.

Returns:

int value of paramMode

isScalar

public boolean isScalar()

Determines whether a ParamValue is scalar. A ParamValue is a scalar or a Vector. A ParamValue may be made up of a Vector of other ParamValues.

Returns:

false if Vector

isVector

public boolean isVector()

Determines whether a ParamValue is a Vector. A ParamValue is a scalar or a Vector. A ParamValue may be made up of a Vector of other ParamValues.

Returns:

true if Vector

isInt

public boolean isInt()

Determines whether a ParamValue is of type int.

Returns:

true if int

isShort

public boolean isShort()

Determines whether a ParamValue is of type short.

Returns:

true if short

isFloat

public boolean isFloat()

Determines whether a ParamValue is of type float.

Returns:

true if float

isDouble

public boolean isDouble()

Determines whether a ParamValue is of type double.

Returns:

true if double

isDate

public boolean isDate()

Determines whether a ParamValue is of type Date.

Returns:

true if Date

isString

public boolean isString()

Determines whether a ParamValue is of type String.

Returns:

true if String

isChar

public boolean isChar()

Determines whether a ParamValue is of type char.

Returns:

true if char

isBoolean

public boolean isBoolean()

Determines whether a ParamValue is of type boolean.

Returns:

true if boolean

isByte

public boolean isByte()

Determines whether a ParamValue is of type byte.

Returns:

true if byte

isLong

public boolean isLong()

Determines whether a ParamValue is of type long.

Returns:

true if long

isObject

public boolean isObject()

Determines whether a ParamValue is of type Object.

Returns:

true if Object

elementAt

public ParamValue elementAt(int index)
                     throws ParamSetException

Used for accessing ParamValues in a Vector of ParamValues. Returns the nth ParamValue. If the nth ParamValue did not previously exist, then creates a ParamValue at the specified index of type UNKNOWN.

Parameters:

index - Index position

Throws:

ParamSetException - if there is an error

setElementAt

public void setElementAt(Object value,
                         int index)
                  throws ParamSetException

Sets the element at the specified index into Vector of ParamValues to the specified value.

Parameters:

value - Value

index - Index position

Throws:

ParamSetException - if the value cannot be set

size

public int size()
         throws ParamSetException

Returns the size of a Vector of ParamValues.

Returns:

Size of Vector

Throws:

ParamSetException - if there is an error

set

public ParamValue set(ParamValue val,
                      int index)
               throws ParamSetException

Sets the value at the specified index into a Vector of ParamValues to the specified ParamValue. If the ParamValue type is UNKNOWN, first sets the type to VECTOR.

Parameters:

val - Value of type ParamValue

index - Index into a Vector of ParamValues

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(boolean val,
                      int index)
               throws ParamSetException

Sets the value at the specified index into a Vector of ParamValues to the specified boolean. If the ParamValue type is UNKNOWN, first sets the type to VECTOR.

Parameters:

val - boolean value

index - Index into a Vector of ParamValues

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(short val,
                      int index)
               throws ParamSetException

Sets the value at the specified index into a Vector of ParamValues to the specified integer. If the ParamValue type is UNKNOWN, first sets the type to VECTOR.

Parameters:

val - short

index - Index into a Vector of ParamValues

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(int val,
                      int index)
               throws ParamSetException

Sets the value at the specified index into a Vector of ParamValues to the specified int. If the ParamValue type is UNKNOWN, first sets the type to VECTOR.

Parameters:

val - int

index - Index into a Vector of ParamValues

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(long val,
                      int index)
               throws ParamSetException

Sets the value at the specified index into a Vector of ParamValues to the specified long. If the ParamValue type is UNKNOWN, first sets the type to VECTOR.

Parameters:

val - long

index - Index into a Vector of ParamValues

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(double val,
                      int index)
               throws ParamSetException

Sets the value at the specified index into a Vector of ParamValues to the specified double. If the ParamValue type is UNKNOWN, first sets the type to VECTOR.

Parameters:

val - double

index - Index into a Vector of ParamValues

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(float val,
                      int index)
               throws ParamSetException

Sets the value at the specified index into a Vector of ParamValues to the specified float. If the ParamValue type is UNKNOWN, first sets the type to VECTOR.

Parameters:

val - float

index - Index into a Vector of ParamValues

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(char val,
                      int index)
               throws ParamSetException

Sets the value at the specified index into a Vector of ParamValues to the specified char. If the ParamValue type is UNKNOWN, first sets the type to VECTOR.

Parameters:

val - char

index - Index into a Vector of ParamValues

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(String val,
                      int index)
               throws ParamSetException

Sets the value at the specified index into a Vector of ParamValues to the specified string. If the ParamValue type is UNKNOWN, first sets the type to VECTOR.

Parameters:

val - String

index - Index into a Vector of ParamValues

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(Date val,
                      int index)
               throws ParamSetException

Sets the value at the specified index into a Vector of ParamValues to the specified date. If the ParamValue type is UNKNOWN, first sets the type to VECTOR.

Parameters:

val - Date

index - Index into a Vector of ParamValues

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(Object val,
                      int index)
               throws ParamSetException

Sets the value at the specified index into a Vector of ParamValues to the specified Object. If the ParamValue type is UNKNOWN, first sets the type to VECTOR.

Parameters:

val - Object

index - Index into a Vector of ParamValues

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(ParamValue val)
               throws ParamSetException

Sets the value of a ParamValue to a ParamValue. If the type is unknown, sets it to the type of the specified ParamValue. If the specified ParamValue is a Vector of other ParamValues, copies the vector to the ParamValue that is returned.

Parameters:

val - ParamValue

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(boolean val)
               throws ParamSetException

Sets the value of a ParamValue to a boolean.

Parameters:

val - boolean

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(int val)
               throws ParamSetException

Sets the value of a ParamValue to an int.

Parameters:

val - int

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(short val)
               throws ParamSetException

Sets the value of a ParamValue to a short.

Parameters:

val - short

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(byte val)
               throws ParamSetException

Sets the value of a ParamValue to a byte.

Parameters:

val - byte

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(long val)
               throws ParamSetException

Sets the value of a ParamValue to a long.

Parameters:

val - long

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(double val)
               throws ParamSetException

Sets the value of a ParamValue to a double.

Parameters:

val - double

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(float val)
               throws ParamSetException

Sets the value of a ParamValue to a float.

Parameters:

val - float

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(char val)
               throws ParamSetException

Sets the value of a ParamValue to a char.

Parameters:

val - char

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(String val)
               throws ParamSetException

Sets the value of a ParamValue to a String.

Parameters:

val - String

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(Date val)
               throws ParamSetException

Sets the value of a ParamValue to a Date.

Parameters:

val - Date

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

set

public ParamValue set(Object val)
               throws ParamSetException

Sets the value of a ParamValue to an Object.

Parameters:

val - Object

Returns:

ParamValue object

Throws:

ParamSetException - if the value cannot be set

asBoolean

public boolean asBoolean()
                  throws ParamSetException

Returns a ParamValue as a boolean. If the ParamValue is a Vector of ParamValues, returns the ParamValue at the zeroeth position as a boolean.

Returns:

boolean

Throws:

ParamSetException - if there is a conversion error

asByte

public byte asByte()
            throws ParamSetException

Returns a ParamValue as a byte. If the ParamValue is a Vector of ParamValues, returns the ParamValue at the zeroeth position as a byte.

Returns:

byte

Throws:

ParamSetException - if there is a conversion error

asInt

public int asInt()
          throws ParamSetException

Returns a ParamValue as a int. If the ParamValue is a Vector of ParamValues, returns the ParamValue at the zeroeth position as a int.

Returns:

int

Throws:

ParamSetException - if there is a conversion error

asShort

public short asShort()
              throws ParamSetException

Returns a ParamValue as a short. If the ParamValue is a Vector of ParamValues, returns the ParamValue at the zeroeth position as a short.

Returns:

short

Throws:

ParamSetException - if there is a conversion error

asLong

public long asLong()
            throws ParamSetException

Returns a ParamValue as a long. If the ParamValue is a Vector of ParamValues, returns the ParamValue at the zeroeth position as a long.

Returns:

long

Throws:

ParamSetException - if there is a conversion error

asDouble

public double asDouble()
                throws ParamSetException

Returns a ParamValue as a double. If the ParamValue is a Vector of ParamValues, returns the ParamValue at the zeroeth position as a double.

Returns:

double

Throws:

ParamSetException - if there is a conversion error

asFloat

public float asFloat()
              throws ParamSetException

Returns a ParamValue as a float. If the ParamValue is a Vector of ParamValues, returns the ParamValue at the zeroeth position as a float.

Returns:

float

Throws:

ParamSetException - if there is a conversion error

asChar

public char asChar()
            throws ParamSetException

Returns a ParamValue as a char. If the ParamValue is a Vector of ParamValues, returns the ParamValue at the zeroeth position as a char.

Returns:

char

Throws:

ParamSetException - if there is a conversion error

asString

public String asString()
                throws ParamSetException

Returns a ParamValue as a String. If the ParamValue is a Vector of ParamValues, returns the ParamValue at the zeroeth position as a String.

Returns:

String

Throws:

ParamSetException - if there is a conversion error

toString

public String toString()

Returns a string representation of a ParamValue.

Overrides:

toString in class Object

Returns:

String

dump

public String dump()

Returns a formatted string representation of a ParamValue.

Returns:

String

asDate

public Date asDate()
            throws ParamSetException

Returns a ParamValue as a Date. If the ParamValue is a Vector of ParamValues, returns the ParamValue at the zeroeth position as a Date.

Returns:

Date

Throws:

ParamSetException - if there is a conversion error

asObject

public Object asObject()
                throws ParamSetException

Returns a ParamValue as an Object. If the ParamValue is a Vector of ParamValues, returns the ParamValue at the zeroeth position as a Object.

Returns:

Object

Throws:

ParamSetException - if there is a conversion error

Skip navigation links