Generic FunctionPackage: javatools.jlinkerToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.1
Unrevised from 8.0 to 8.1.
8.0 version

jlookup

Arguments: name &optional arg

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

(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-2009, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 8.1. This page was not revised from the 8.0 page.
Created 2009.7.29.

ToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.1
Unrevised from 8.0 to 8.1.
8.0 version