"Fossies" - the Fresh Open Source Software archive

Member "jacl1.4.1/docs/TclJava/JavaImportCmd.html" of archive jacl1.4.1.tar.gz:


Caution: In this restricted "Fossies" environment the current HTML page may not be correctly presentated and may have some non-functional links. Alternatively you can here view or download the uninterpreted source code. That can be also achieved for any archive member file by clicking within an archive contents listing on the first character of the file(path) respectively on the according byte size field.


The java::import Command


Usage:

java::import ?-forget? ?-package pkg? ?class ...?

The java::import command provides a means to specify Java class names in a shortened format. This functionality is the equivalent of the import statement in Java except that importing all classes from a package is not supported. Once imported, the Java class java.util.Hashtable could be specified with the shortened name Hashtable. Each class argument is checked to ensure that it is the name of a accessible class and does not conflict with another class imported from another package. The optional -package pkg arguments are used to indicate the package that each class argument is imported from. If the -package pkg arguments are given, none of the class arguments can include a package specifier, meaning the '.' character must not appear in a class name.

If the java::import command is invoked with no arguments it will return a list of all the currently imported classes. If the java::import command is invoked with only the optional -package pkg arguments, then only those classes imported from the specified package will be returned.

The -forget argument will invalidate a previously imported class name. The optional -package pkg arguments can be combined with the -forget argument to forget about all the imported classes from a given package.

Examples:

This example demonstrates how to allocate a java.util.Hashtable object using the fully qualified name and the imported name.
# Use fully qualified name with the java::new command
set h1 [java::new java.util.Hashtable]

# Import the class name shortcut
java::import java.util.Hashtable

# Use imported name with the java::new command
set h2 [java::new Hashtable]

This example demonstrates how to use the optional -package pkg arguments to import more than one class from a given package.
# Import two classes from the java.util package
java::import -package java.util Hashtable Vector

# Call java methods using the shortened names
set h [java::new Hashtable]
set bool [java::instanceof $h Hashtable]
set v [java::new Vector]
set array [java::new {Hashtable[]} {10}]

This example demonstrates how to use the optional -forget argument to remove a class from the import list.
# Import two classes from the java.util package
java::import java.util.Hashtable java.util.Vector

# Woops, I did not want java.util.Vector
java::import -forget java.util.Vector

This example demonstrates how to combine the -forget argument and the -package pkg arguments to remove all imported classes from a given package.
# Import two classes from the java.util package
java::import java.util.Hashtable java.util.Vector

# Now forget about both of them
java::import -forget -package java.util

This example demonstrates how to query the import list.
# Import classes from two different packages
java::import java.net.Socket java.util.Hashtable

# Will print "java.net.Socket java.util.Hashtable"
puts [java::import]

# Will print "java.util.Hashtable"
puts [java::import -package java.util]

# Note that the command above does not import all
# the classes from a named package.

Copyright © 1997-1998 Sun Microsystems, Inc.