THE PACKAGE JAVA.LANG

java.lang.Runtime

20.16

Calling this method with argument

false

 suggests that the Java Virtual

Machine cease emitting per call debugging information.

20.16.13

public void load(String filename)

First, if there is a security manager, its

checkLink

 method ( 20.17.17) is called

with the

filename

 as its argument.

This is similar to the method

loadLibrary

 ( 20.16.14), but accepts a general

file name as an argument rather than just a library name, allowing any file of

native code to be loaded.

See also the method

load

 ( 20.18.14) of class

System

, which is the conven 

tional and convenient means of invoking this method.

20.16.14

public void loadLibrary(String libname)

First, if there is a security manager, its

checkLink

 method ( 20.17.17) is called

with the

libname

 as its argument.

A file containing native code is loaded from the local file system from a place

where library files are conventionally obtained. The details of this process are

implementation dependent.

See also the method

loadLibrary

 ( 20.18.15) of class

System

, which is the

conventional and convenient means of invoking this method. If

native

 methods

are to be used in the implementation of a class, a standard strategy is to put the

native code in a library file (call it

LibFile

) and then to put a static initializer:

static { System.loadLibrary("LibFile"); }

within the class declaration. When the class is loaded and initialized ( 12.4), the

necessary native code implementation for the

native

 methods will then be loaded

as well.

20.16.15

public InputStream

getLocalizedInputStream(InputStream in)

This method takes an

InputStream

 ( 22.3) and returns an

InputStream

 equiva 

lent to the argument in all respects except that it is localized: as data is read from

the stream, it is automatically converted from the local format to Unicode. If the

argument is already a localized stream, then it will be returned as the result.

567