Apache Struts API Documentation: Class FormPropertyConfig

org.apache.struts.config Class FormPropertyConfig

java.lang.Object
  |
  +--org.apache.struts.config.FormPropertyConfig

All Implemented Interfaces:

java.io.Serializable

public class FormPropertyConfig

extends java.lang.Object

implements java.io.Serializable

A JavaBean representing the configuration information of a <form-property> element in a Struts configuration file.

Since:

Struts 1.1

Version:

$Rev: 54929 $ $Date: 2004-10-16 17:38:42 +0100 (Sat, 16 Oct 2004) $

See Also:

Serialized Form

log

private static final org.apache.commons.logging.Log log

The logging instance

configured

protected boolean configured

Has this component been completely configured?

initial

protected java.lang.String initial

String representation of the initial value for this property.

name

protected java.lang.String name

The JavaBean property name of the property described by this element.

size

protected int size

The size of the array to be created if this property is an array type and there is no specified initial value. This value must be non-negative.

Since:

Struts 1.1

type

protected java.lang.String type

The fully qualified Java class name of the implementation class of this bean property, optionally followed by [] to indicate that the property is indexed.

FormPropertyConfig

public FormPropertyConfig()

Standard no-arguments constructor for dynamic instantiation.

FormPropertyConfig

public FormPropertyConfig(java.lang.String name,
                          java.lang.String type,
                          java.lang.String initial)

Constructor that preconfigures the relevant properties.

Parameters:

name - Name of this property

type - Fully qualified class name of this property

initial - Initial value of this property (if any)

FormPropertyConfig

public FormPropertyConfig(java.lang.String name,
                          java.lang.String type,
                          java.lang.String initial,
                          int size)

Constructor that preconfigures the relevant properties.

Parameters:

name - Name of this property

type - Fully qualified class name of this property

initial - Initial value of this property (if any)

size - Size of the array to be created if this property is an array with no defined initial value

getInitial

public java.lang.String getInitial()

setInitial

public void setInitial(java.lang.String initial)

getName

public java.lang.String getName()

setName

public void setName(java.lang.String name)

getSize

public int getSize()

setSize

public void setSize(int size)

getType

public java.lang.String getType()

setType

public void setType(java.lang.String type)

getTypeClass

public java.lang.Class getTypeClass()

Return a Class corresponds to the value specified for the type property, taking into account the trailing "[]" for arrays (as well as the ability to specify primitive Java types).

initial

public java.lang.Object initial()

Return an object representing the initial value of this property. This is calculated according to the following algorithm:

• If the value you have specified for the type property represents an array (i.e. it ends with "[]"):
  • If you have specified a value for the initial property, ConvertUtils.convert will be called to convert it into an instance of the specified array type.
  • If you have not specified a value for the initial property, an array of the length specified by the size property will be created. Each element of the array will be instantiated via the zero-args constructor on the specified class (if any). Otherwise, null will be returned.
• If the value you have specified for the type property does not represent an array:
  • If you have specified a value for the initial property, ConvertUtils.convert will be called to convert it into an object instance.
  • If you have not specified a value for the initial attribute, Struts will instantiate an instance via the zero-args constructor on the specified class (if any). Otherwise, null will be returned.

freeze

public void freeze()

Freeze the configuration of this component.

toString

public java.lang.String toString()

Return a String representation of this object.

Overrides:

toString in class java.lang.Object