jlookup

Arguments: name &optional arg

This generic function has methods dispatching on the value of the name argument.

• (name (eql :version))
• (name (eql :query-lookup))
• (name (eql :query))
• (name (eql :table))
• (name (eql :compile-time-lookup))
• (name (eql :preload))
• (name (eql :preloaded))
• (name (eql :gen-preload))
• (name (eql :new))
• (name (eql :none))

(name (eql :version))

Arguments: (name (eql :version)) &optional error-p

This method returns a number that represents the version of the jLinker Java code. The number is of the form mnnnsss where the digits m are the major version, nnn the minor version, and sss the sub-minor version. A second returned value is a string containing the Java JDK version. If the error-p argument is non-nil, signal an error if not connected to Java; otherwise return nil values.

(name (eql :query-lookup))

Arguments: (name (eql :query-lookup)) &optional action

This method returns t if caching is in effect.

(name (eql :query))

Arguments: (name (eql :query)) &optional pprint-p

Returns a list of object statistics if the second argument is nil or omitted. If the second argument is non-nil, the value is pretty-printed to *standard-output* and no value is returned.

       (:LOOKUP 
        (:NEW-ENTRIES 0 :OBJECTS 1 :NAMES 0) 
	 :DIST-OB-CACHE
         (:LIVE 9 :DEAD 0) 
	 :JAVA-SERVER 
	 (:LIVE 9 :FREE 0) 
	 :LISP-SERVER
	 (:COUNT 0)) 

:NEW-ENTRIES is the number of named objects added to the cache since the last call to (jlookup :preloaded).
:OBJECTS is the number of named objects in the object cache.
:NAMES is the number of names in the object cache.
:DIST-OB-CACHE :LIVE is the number of live Lisp references to Java objects.
:DIST-OB-CACHE :DEAD is the number of dead Lisp references to Java objects.
:JAVA-SERVER :LIVE is the number of live references in the Java server.
:JAVA-SERVER :FREE is the number of free entries in the Java server table.
:LISP-SERVER :COUNT is the number of references to Lisp objects in the Lisp server table.

When pprint-p is non-nil, the result is printed to *standard-output* and no values are returned; otherwise the value is an alist of the above items.

(name (eql :table))

Arguments: (name (eql :table)) &optional pprint-p

This method returns a list of the names of the objects in the cache. When pprint-p is non-nil, the table is pretty-printed to *standard-output* and no values are returned.

(name (eql :compile-time-lookup))

Arguments: (name (eql :compile-time-lookup))

Initiate compile-time lookup of Java methods.

When this facility is enabled, all j* macro expansions trigger a lookup of any class and method constants. If a class or method can only be determined at run time, a warning is printed. After compiling an application with compile-time lookup enabled, a (partial) pre-load table may be generated. For the application, a file should have the following contents:

(in-package ...)
(eval-when (compile) (jlookup :compile-time-lookup)
(eval-when (load)    (jlookup :preload))

... application code definitions ...

(eval-when (compile) (jlookup :gen-preload))

(name (eql :preload))

Arguments: (name (eql :preload)) &optional infile

Initialize the object cache with empty hashtables and load the file specified by infile, which defaults to jpreload.cl.

(name (eql :preloaded))

Arguments: (name (eql :preloaded))

Reset the new entry count in the object cache to zero.

(name (eql :gen-preload))

Arguments: (name (eql :gen-preload)) &optional outfile

Write out the object cache into the file specified by outfile, which defaults to jpreload.cl.

(name (eql :new))

Arguments: (name (eql :new)) &optional action

Clears the cache and starts a new one.

(name (eql :none))

Arguments: (name (eql :none))

Disables caching.

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

Copyright (c) 1998-2022, Franz Inc. Lafayette, CA., USA. All rights reserved.
This page was not revised from the 10.0 page.
Created 2019.8.20.