Package org.jruby.embed

Enum Class AttributeName

java.lang.Object

java.lang.Enum<AttributeName>

org.jruby.embed.AttributeName

All Implemented Interfaces:

Serializable, Comparable<AttributeName>, Constable

public enum AttributeName
extends Enum<AttributeName>

Predefined keys for an attribute map that ScriptingContainer has. Usage example:

     ScriptingContainer container = new ScriptingContainer();
     container.setAttribute(AttributeName.BASE_DIR, System.getProperty("user.dir");

Author:

Yoko Harada <[email protected]>

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Enum

Enum.EnumDesc<E extends Enum<E>>

Enum Constant Summary

Enum Constants

Enum Constant	Description
BASE_DIR	A key used in an attribute map to set a base directory.
CLEAR_VARAIBLES	A key used in an attribute map to turn on/off clearing variables.
ERROR_WRITER	A key used in an attribute map to set an error writer.
LINENUMBER	A key used in an attribute map to set a line number in error message.
READER	A key used in an attribute map to set a reader.
RECEIVER	A key used in an attribute map to set a receiver object for sharing variables.
SHARING_VARIABLES	A key used in an attribute map to turn on/off sharing variable feature.
TERMINATION	A key used in an attribute map to turn on/off termination.
UNICODE_ESCAPE	A key used in an attribute map to specify that the script to be parsed has unicode escape in it.
WRITER	A key used in an attribute map to set a writer.

Method Summary

Modifier and Type	Method	Description
static AttributeName	getType(String fqpn)	Returns a fully qualified attribute name that corresponds to a given enumerated type identifier.
String	toString()	Returns the fully qualified attribute name of this enum constant.
static AttributeName	valueOf(String name)	Returns the enum constant of this class with the specified name.
static AttributeName[]	values()	Returns an array containing the constants of this enum class, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Details

READER

public static final AttributeName READER

A key used in an attribute map to set a reader. This attribute can be set using a System property, org.jruby.embed.reader.

WRITER

public static final AttributeName WRITER

A key used in an attribute map to set a writer. This attribute can be set using a System property, org.jruby.embed.writer.

ERROR_WRITER

public static final AttributeName ERROR_WRITER

A key used in an attribute map to set an error writer. This attribute can be set using a System property, org.jruby.embed.errorwriter.

BASE_DIR

public static final AttributeName BASE_DIR

A key used in an attribute map to set a base directory. This attribute can be set using a System property, org.jruby.embed.basedir.

LINENUMBER

public static final AttributeName LINENUMBER

A key used in an attribute map to set a line number in error message. This attribute is for JSR223 only. This attribute can be set using a System property, org.jruby.embed.linenumber.

UNICODE_ESCAPE

public static final AttributeName UNICODE_ESCAPE

A key used in an attribute map to specify that the script to be parsed has unicode escape in it. Default is false. This attribute can be set using a System property, org.jruby.embed.unicode.escpe.

SHARING_VARIABLES

public static final AttributeName SHARING_VARIABLES

A key used in an attribute map to turn on/off sharing variable feature. Default is true. If false is set, sharing variables goes off, and better performance will be expected. This attribute can be set using a System property, org.jruby.embed.sharing.variables.

CLEAR_VARAIBLES

public static final AttributeName CLEAR_VARAIBLES

A key used in an attribute map to turn on/off clearing variables. This attribute is for JSR223 only. Default is false, which means JRubyEngine doesn't clear an internal variable table, which ends up in being reused. If true is set, JRubyEngine clears the internal variable table.

TERMINATION

public static final AttributeName TERMINATION

A key used in an attribute map to turn on/off termination. This attribute is for JSR223 only. Default is false, which means JRubyEngine doesn't terminate any state and doesn't execute at_exit blocks. If true is set, JRubyEngine terminates the state as well as executes at_exit blocks. This attribute can be set using a System property, org.jruby.embed.termination.

RECEIVER

public static final AttributeName RECEIVER

A key used in an attribute map to set a receiver object for sharing variables. This attribute is for JSR223 only. This attribute can be set using a System property, org.jruby.embed.receiver.

Method Details

values

public static AttributeName[] values()

Returns an array containing the constants of this enum class, in the order they are declared.

Returns:

an array containing the constants of this enum class, in the order they are declared

valueOf

public static AttributeName valueOf(String name)

Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum class has no constant with the specified name

NullPointerException - if the argument is null

toString

public String toString()

Returns the fully qualified attribute name of this enum constant.

Overrides:

toString in class Enum<AttributeName>

Returns:

a fully qualified attribute name

getType

public static AttributeName getType(String fqpn)

Returns a fully qualified attribute name that corresponds to a given enumerated type identifier.

Parameters:

fqpn - fully qualified attribute name

Returns:

a matched enumerated type identifier