verify-java-caller

verify-java-caller Function

Summary

Verify the Java caller.

Package

lw-ji

Signature

verify-java-caller name => result

Arguments

name⇩

A symbol.

Values

result

A boolean.

Description

The function verify-java-caller verifies the Java caller, which means looking up the corresponding Java methods and setting up the caller for name.

name must be a caller name defined by define-java-caller (but not any of the other definers or setup-java-caller). If it is not, an error is signaled. Note that the importing interface defines the caller using define-java-caller and that define-java-callers also expands to define-java-caller, so verify-java-caller can be used on such caller (but not on constructors or field accessors).

verify-java-caller looks up the Java class and method of the caller (unless they are already cached), and caches the information (so future calls to name or verification can use it).

verify-java-caller returns t if successful, nil otherwise.

verify-java-caller requires running Java.

Notes

In most cases using verify-java-callers to verify all the callers is more convenient.
Verification is useful to guard against typing mistakes when you typed the define-java-caller explicitly because that does not do any lookup until run time, or when you are not sure that the class definition has not changed between the time you imported the definition and the time it is used.