rJava (version 0.9-11)

jnew: Create a Java object

Description

.jnew create a new Java object.

Usage

.jnew(class, ..., check=TRUE, silent=!check, class.loader=NULL)

Arguments

class

fully qualified class name in JNI notation (e.g. "java/lang/String").

...

Any parameters that will be passed to the corresponding constructor. The parameter types are determined automatically and/or taken from the jobjRef object. For details see .jcall. Note that all named parameters are discarded.

check

If set to TRUE then .jcheck is invoked before and after the call to the constructor to clear any pending Java exceptions.

silent

If set to FALSE then .jnew will fail with an error if the object cannot be created, otherwise a null-reference is returned instead. In addition, this flag is also passed to final .jcheck if check above is set to TRUE. Note that the error handling also clears exceptions, so check=FALSE, silent=FALSE is usually not a meaningful combination.

class.loader

optional class loader to force for loading the class. If not set, the rJava class loader is used first. The default Java class loader is always used as a last resort. This is for expert use only! If you set the class loader, the class loading behavior changes - use only in very special circumstances.

Value

Returns the reference (jobjRef) to the newly created object or null-reference (see .jnull) if something went wrong.

See Also

.jcall, .jnull

Examples

# NOT RUN {
f <- .jnew("java/awt/Frame","Hello")
.jcall(f,,"setVisible",TRUE)
# }