jconstructor

Arguments: class-ref &rest arg-class-refs

This function retrieves a remote reference to a Java constructor.

The first (class-ref) argument must be a class name or a class reference.

If the arg-class-refs rest argument is a positive integer, the integer specifies the number of arguments expected by the constructor. If the class has a unique constructor for the specified number of arguments, then that constructor is returned. Otherwise a continuable error is signalled to allow an appropriate constructor to be selected.

If the arg-class-refs arguments are not a single positive integer, then each argument must be a class name or a class reference that describes an argument type. The constructor with the matching signature is retrieved from Java.

The compiler macro associated with the function allows compile-time collection of java class names and method signatures. This information is used to generate a file of class and method definitions that may be loaded to initialize an application, and avoid the class and method lookup overhead in the body of the application (see jlookup).

The symbol jcons also names this function (for backward compatibility), but please use jconstructor instead of jcons.

See jlinker.htm for more information on the jLinker facility.

Copyright (c) 1998-2002, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.2. This page was not revised from the 6.1 page.
Created 2002.2.26.