org.kohsuke.args4j.spi

Class FieldSetter

java.lang.Object

org.kohsuke.args4j.spi.FieldSetter

All Implemented Interfaces:

Setter

public final class FieldSetter
extends java.lang.Object
implements Setter

Setter that sets to a Field.

Author:

Kohsuke Kawaguchi

Constructor Summary

Constructors

Constructor and Description
FieldSetter(java.lang.Object bean, java.lang.reflect.Field f)

Method Summary

Methods

Modifier and Type	Method and Description
void	addValue(java.lang.Object value) Adds/sets a value to the property of the option bean.
java.lang.reflect.AnnotatedElement	asAnnotatedElement() Returns the AnnotatedElement by which you can access annotations written on this setter.
FieldSetter	asFieldSetter() If this setter encapsulates a field, return the direct access to that field as FieldSetter.
java.lang.Class	getType() Gets the type of the underlying method/field.
java.lang.Object	getValue()
boolean	isMultiValued() Whether this setter is intrinsically multi-valued.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FieldSetter

public FieldSetter(java.lang.Object bean,
           java.lang.reflect.Field f)

Method Detail

getType

public java.lang.Class getType()

Description copied from interface: Setter

Gets the type of the underlying method/field.

Specified by:

getType in interface Setter

isMultiValued

public boolean isMultiValued()

Description copied from interface: Setter

Whether this setter is intrinsically multi-valued. When used for parsing arguments (and not options), intrinsically multi-valued setters consume all the remaining arguments. So if the setter can store multiple values, this method should return true.

This characteristics of a setter does not affect option parsing at all, as any options can be specified multiple times (which in many cases are no-op, but when your shell script expands multiple environment variables that each can contain options, tolerating such redundant options are often useful.)

Specified by:

isMultiValued in interface Setter

asFieldSetter

public FieldSetter asFieldSetter()

Description copied from interface: Setter

If this setter encapsulates a field, return the direct access to that field as FieldSetter. This method serves two purposes.

One is that this lets OptionHandlers to bypass the collection/array handling of fields. This is useful if you are defining an option handler that produces array or collection from a single argument.

The other is to retrieve the current value of the field, via getValue().

Specified by:

asFieldSetter in interface Setter

Returns:

null if this setter wraps a method.

asAnnotatedElement

public java.lang.reflect.AnnotatedElement asAnnotatedElement()

Description copied from interface: Setter

Returns the AnnotatedElement by which you can access annotations written on this setter. This is the same AnnotatedElement that had Option/Argument.

This enables OptionHandler to further tweak its behavior based on additional annotations.

Specified by:

asAnnotatedElement in interface Setter

addValue

public void addValue(java.lang.Object value)

Description copied from interface: Setter

Adds/sets a value to the property of the option bean.

A Setter object has an implicit knowledge about the property it's setting, and the instance of the option bean.

Specified by:

addValue in interface Setter

getValue

public java.lang.Object getValue()