Home
IBM Domino Designer Basic User Guide and Reference
Basic product usage information and programming language reference information.
LotusScript® Language
Welcome to the LotusScript® Language section of Domino® Designer Help.
Beyond Core LotusScript®
This chapter discusses the role that LotusScript® plays with IBM® products, your operating environment, other programs, and interactive user applications.
LS2J: Connecting with Java™
Using LotusScript® and LS2J, you can access Java™ classes, giving you a powerful cross-platform extension to LotusScript. Developers can access Java in LotusScript programs as a set of predefined LotusScript objects. This set of objects allow LotusScript to use already created Java classes that are available in script libraries or found using the classpath.
LS2J classes
LS2J introduces the concept of a Java™ object reference. Similar to an OLE object reference, it is not a predefined class; rather, it represents a runtime instance of a Java object. Its properties and methods are determined at run time.
JavaSession class (LotusScript® Language)
JavaSession is the starting point for access to the Java™ objects. The session attaches to the existing JVM, if there is one. If a JVM has not been started, the LotusScript® client tries to create the JVM and apply all the specified arguments. You can create as many JavaSessions as you want. All the resources created are associated with a particular session. Delete the session object to reclaim the resources.
getClass method (LotusScript® Language)
This method returns a reference to a Java™ class.

getClass method (LotusScript® Language)

This method returns a reference to a Java™ class.

Defined in

Syntax

Set JavaClass = javasession .getClass( ClassName $ )

Parameters

ClassName$

String. The name of the class you would like to retrieve. For example, "java/lang/Integer."

Usage

This method will return a Java™ class reference with which a Java™ object can be created within LotusScript®.

Note: There are 2 ways you can represent a String class:


java.lang.String	example: set MyClass = Session.getClass("java.lang.String")
java/lang/String	example: set MyClass = Session.getClass("java/lang/String")

When you use the dot "." notation on the Macintosh, the Mac will return an error that the Class cannot be found. Instead, use the slash "/" notation. The slash "/" notation works on all platforms. Use the slash "/" notation in your applications for multi-platform support.

The nested class name has $ as a separator for nested classes.

Error thrown

"JavaClassNotFound" is thrown if the Java™ class cannot be located.